{"action":"created","comment":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/35248459","id":35248459,"diff_hunk":"@@ -0,0 +1,192 @@\n+.. _OAuth2 Case Study:\n+\n+####################################################\n+OAuth2 Case Study: Setting Up Microsoft Office 365 \n+####################################################\n+\n+This section describes how to add and configure Microsoft Office 365\n+as an OAuth2 provider to an Open edX installation.\n+\n+******************************\n+Obtain a Client ID and Secret\n+******************************\n+\n+Microsoft Office 365 uses Microsoft Azure Active Directory as the directory and\n+OAuth2 provider for itself. So, in order to add Microsoft Office 365 as an\n+OAuth2 provider to your Open edX installation, you start with Microsoft Azure\n+Active Directory.\n+\n+#. Obtain an Azure subscription. If you do not have one, you can create a free,\n+   short term trial subscription on the `Microsoft Azure`_ website. \n+\n+   .. note:: During setup,a credit card and phone number are required. If \n+    you do not set up virtual machines or use paid services on the\n+    subscription, and only use it to access the Azure Active Directory, you\n+    will not be charged for the subscription.\n+\n+#. To use Office 365 for third party authentication, you configure Microsoft\n+   Azure to manage your Office 365 Microsoft Azure Active Directory.\n+\n+  #. Sign in to the `Azure portal`_.\n+\n+  #. Either create a new Active Directory or select an existing one.\n+   \n+#. Register an application in Azure.\n+\n+  #. Sign in to the Microsoft Azure Management Portal.\n+\n+.. is this the same as the \"Azure portal\" in the previous step? \n+.. Alison 22 Jul 2015\n+\n+  #. Select the Active Directory icon from the left menu, and then select the\n+     Office 365 connected Azure active directory that you created or identified\n+     in the previous step.\n+\n+  #. From the top menu select **Applications**, and then select **Add an App**.\n+\n+  #. On the page that opens, select **Add an application my organization is\n+     developing**.\n+\n+  #. On the Tell us about your application page, you specify a name for your\n+     application and indicate the type of application to register with Azure\n+     Active Directory. Select **web application**, **web API** (the default),\n+     or both, and then select the arrow icon at the bottom of the page.\n+\n+  #. On the App properties page, enter the **Sign-on URL** for your Moodle\n+     instance. The Sign-on URL is the redirect URI for your Open edX\n+     installation. It must be entered with a trailing slash, for example, \n+     ``https://example.com/auth/``.\n+\n+.. is a Moodle instance a prerequisite? where is this info obtained?\n+.. Alison 22 Jul 2015\n+\n+  #. Enter the **App ID URI** for your Moodle instance. This is the\n+     main URI of your Open edX installation.\n+\n+  #. Select the checkbox at the bottom right of the page, and then select\n+     **Ok** to add your application to Azure Active Directory.\n+\n+  #. There are a couple more values and changes you need to make and write down\n+     some values which you will need in the next section.\n+\n+.. It isn't clear to me yet how this ^^ step and the \"Configure the application\" section below relate to each other. \n+.. Alison 22 Jul 2015\n+\n+#. Configure the application.\n+\n+  #. Select the Active Directory icon from the left menu, and then select the\n+     Azure active directory you want to configure.\n+\n+.. is this being done in the Azure portal? should they open a separate window so that info can be copied from one place in the portal to another?\n+.. Alison 22 Jul 2015\n+\n+  #. Select the **Applications** tab.\n+\n+  #. Select your application.\n+\n+  #. Select **Configure**.\n+\n+  #. Locate the client ID and copy it to the **Client ID** field in your OpenID\n+     connect configuration screen.\n+\n+.. where do you locate this client ID? is it the client ID for the application you just created or located, and automatically assigned to the application? At what URL or application do you find the OpenID connect configuration screen? \n+.. Alison 22 Jul 2015\n+\n+  #. To create a client secret, locate the **keys** section and select a\n+     duration for the validity of the key. Save the new key, and then copy it\n+     to the **Client Secret** field in your OpenID connect configuration\n+     screen.\n+\n+.. same question on the OpenID connect configuration screen\n+.. Alison 22 Jul 2015\n+\n+#. OpenID Connect Settings.\n+\n+.. is this also a configuration step? on the Azure portal still, or some other site?\n+.. Alison 22 Jul 2015 \n+\n+  #. Locate the Permissions to other applications section.\n+\n+  #. Select **Add application**. To do so, move the cursor over **Office 365\n+     Exchange Online and Office 365 SharePoint Online**, and then select the\n+     \"plus sign\" icon.\n+\n+  #. Select the check mark icon at the bottom right of the dialog.\n+\n+  #. In the Delegated Permissions dropdown for Windows Azure Active Directory,\n+     select the following permissions.\n+\n+    * **Read directory data**\n+\n+    * **Enable sign-on and read users' profiles**\n+\n+  #. Select *Save*.","path":"en_us/install_operations/source/configuration/tpa/OAUTH2_case_study.rst","position":123,"original_position":123,"commit_id":"c6e9eb0db8733e5c03f9d47f29769bd7f732af93","original_commit_id":"c6e9eb0db8733e5c03f9d47f29769bd7f732af93","user":{"login":"mhoeber","id":5607222,"avatar_url":"https://avatars.githubusercontent.com/u/5607222?v=3","gravatar_id":"","url":"https://api.github.com/users/mhoeber","html_url":"https://github.com/mhoeber","followers_url":"https://api.github.com/users/mhoeber/followers","following_url":"https://api.github.com/users/mhoeber/following{/other_user}","gists_url":"https://api.github.com/users/mhoeber/gists{/gist_id}","starred_url":"https://api.github.com/users/mhoeber/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mhoeber/subscriptions","organizations_url":"https://api.github.com/users/mhoeber/orgs","repos_url":"https://api.github.com/users/mhoeber/repos","events_url":"https://api.github.com/users/mhoeber/events{/privacy}","received_events_url":"https://api.github.com/users/mhoeber/received_events","type":"User","site_admin":false},"body":"bold not ital","created_at":"2015-07-22T18:43:57Z","updated_at":"2015-07-22T18:43:57Z","html_url":"https://github.com/edx/edx-documentation/pull/452#discussion_r35248459","pull_request_url":"https://api.github.com/repos/edx/edx-documentation/pulls/452","_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/35248459"},"html":{"href":"https://github.com/edx/edx-documentation/pull/452#discussion_r35248459"},"pull_request":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/452"}}},"pull_request":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/452","id":40569458,"html_url":"https://github.com/edx/edx-documentation/pull/452","diff_url":"https://github.com/edx/edx-documentation/pull/452.diff","patch_url":"https://github.com/edx/edx-documentation/pull/452.patch","issue_url":"https://api.github.com/repos/edx/edx-documentation/issues/452","number":452,"state":"open","locked":false,"title":"Ahodges/sso open","user":{"login":"lamagnifica","id":6392274,"avatar_url":"https://avatars.githubusercontent.com/u/6392274?v=3","gravatar_id":"","url":"https://api.github.com/users/lamagnifica","html_url":"https://github.com/lamagnifica","followers_url":"https://api.github.com/users/lamagnifica/followers","following_url":"https://api.github.com/users/lamagnifica/following{/other_user}","gists_url":"https://api.github.com/users/lamagnifica/gists{/gist_id}","starred_url":"https://api.github.com/users/lamagnifica/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lamagnifica/subscriptions","organizations_url":"https://api.github.com/users/lamagnifica/orgs","repos_url":"https://api.github.com/users/lamagnifica/repos","events_url":"https://api.github.com/users/lamagnifica/events{/privacy}","received_events_url":"https://api.github.com/users/lamagnifica/received_events","type":"User","site_admin":false},"body":"@bradenmacdonald @ebporter, @mhoeber , @feanil @sarina please review these draft instructions for enabling TPA and configuring SAML IdPs for our open source community, with comments in the rst files where I have questions: providers.rst, enable_tpa_open.rst, and tpa_SAML.rst. Please let me know what I've missed, where I've gone wrong, and any other suggestions you have. I will add to the tpa_OAUTH2.rst document and include the case study from Microsoft in my next commit.\r\nAn HTML version can be found here. http://draft-sso-login-os-20150723.readthedocs.org/en/latest/configuration/tpa/index.html\r\nDOC-2103","created_at":"2015-07-22T14:16:27Z","updated_at":"2015-07-22T18:43:57Z","closed_at":null,"merged_at":null,"merge_commit_sha":"255628fba35c183cb42180656736da8b4c03ccb0","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/edx/edx-documentation/pulls/452/commits","review_comments_url":"https://api.github.com/repos/edx/edx-documentation/pulls/452/comments","review_comment_url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments{/number}","comments_url":"https://api.github.com/repos/edx/edx-documentation/issues/452/comments","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/c6e9eb0db8733e5c03f9d47f29769bd7f732af93","head":{"label":"edx:ahodges/sso_open","ref":"ahodges/sso_open","sha":"c6e9eb0db8733e5c03f9d47f29769bd7f732af93","user":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"repo":{"id":23839256,"name":"edx-documentation","full_name":"edx/edx-documentation","owner":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/edx/edx-documentation","description":"","fork":false,"url":"https://api.github.com/repos/edx/edx-documentation","forks_url":"https://api.github.com/repos/edx/edx-documentation/forks","keys_url":"https://api.github.com/repos/edx/edx-documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/edx/edx-documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/edx/edx-documentation/teams","hooks_url":"https://api.github.com/repos/edx/edx-documentation/hooks","issue_events_url":"https://api.github.com/repos/edx/edx-documentation/issues/events{/number}","events_url":"https://api.github.com/repos/edx/edx-documentation/events","assignees_url":"https://api.github.com/repos/edx/edx-documentation/assignees{/user}","branches_url":"https://api.github.com/repos/edx/edx-documentation/branches{/branch}","tags_url":"https://api.github.com/repos/edx/edx-documentation/tags","blobs_url":"https://api.github.com/repos/edx/edx-documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/edx/edx-documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/edx/edx-documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/edx/edx-documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/edx/edx-documentation/languages","stargazers_url":"https://api.github.com/repos/edx/edx-documentation/stargazers","contributors_url":"https://api.github.com/repos/edx/edx-documentation/contributors","subscribers_url":"https://api.github.com/repos/edx/edx-documentation/subscribers","subscription_url":"https://api.github.com/repos/edx/edx-documentation/subscription","commits_url":"https://api.github.com/repos/edx/edx-documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/edx/edx-documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/edx/edx-documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/edx/edx-documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/edx/edx-documentation/contents/{+path}","compare_url":"https://api.github.com/repos/edx/edx-documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/edx/edx-documentation/merges","archive_url":"https://api.github.com/repos/edx/edx-documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/edx/edx-documentation/downloads","issues_url":"https://api.github.com/repos/edx/edx-documentation/issues{/number}","pulls_url":"https://api.github.com/repos/edx/edx-documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/edx/edx-documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/edx/edx-documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/edx/edx-documentation/labels{/name}","releases_url":"https://api.github.com/repos/edx/edx-documentation/releases{/id}","created_at":"2014-09-09T15:29:04Z","updated_at":"2015-07-21T18:18:11Z","pushed_at":"2015-07-22T17:58:51Z","git_url":"git://github.com/edx/edx-documentation.git","ssh_url":"git@github.com:edx/edx-documentation.git","clone_url":"https://github.com/edx/edx-documentation.git","svn_url":"https://github.com/edx/edx-documentation","homepage":null,"size":81618,"stargazers_count":19,"watchers_count":19,"language":"Makefile","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":69,"mirror_url":null,"open_issues_count":25,"forks":69,"open_issues":25,"watchers":19,"default_branch":"master"}},"base":{"label":"edx:master","ref":"master","sha":"e8cc2a885dde913868e29e352ac5491bbe7e1892","user":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"repo":{"id":23839256,"name":"edx-documentation","full_name":"edx/edx-documentation","owner":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/edx/edx-documentation","description":"","fork":false,"url":"https://api.github.com/repos/edx/edx-documentation","forks_url":"https://api.github.com/repos/edx/edx-documentation/forks","keys_url":"https://api.github.com/repos/edx/edx-documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/edx/edx-documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/edx/edx-documentation/teams","hooks_url":"https://api.github.com/repos/edx/edx-documentation/hooks","issue_events_url":"https://api.github.com/repos/edx/edx-documentation/issues/events{/number}","events_url":"https://api.github.com/repos/edx/edx-documentation/events","assignees_url":"https://api.github.com/repos/edx/edx-documentation/assignees{/user}","branches_url":"https://api.github.com/repos/edx/edx-documentation/branches{/branch}","tags_url":"https://api.github.com/repos/edx/edx-documentation/tags","blobs_url":"https://api.github.com/repos/edx/edx-documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/edx/edx-documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/edx/edx-documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/edx/edx-documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/edx/edx-documentation/languages","stargazers_url":"https://api.github.com/repos/edx/edx-documentation/stargazers","contributors_url":"https://api.github.com/repos/edx/edx-documentation/contributors","subscribers_url":"https://api.github.com/repos/edx/edx-documentation/subscribers","subscription_url":"https://api.github.com/repos/edx/edx-documentation/subscription","commits_url":"https://api.github.com/repos/edx/edx-documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/edx/edx-documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/edx/edx-documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/edx/edx-documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/edx/edx-documentation/contents/{+path}","compare_url":"https://api.github.com/repos/edx/edx-documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/edx/edx-documentation/merges","archive_url":"https://api.github.com/repos/edx/edx-documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/edx/edx-documentation/downloads","issues_url":"https://api.github.com/repos/edx/edx-documentation/issues{/number}","pulls_url":"https://api.github.com/repos/edx/edx-documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/edx/edx-documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/edx/edx-documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/edx/edx-documentation/labels{/name}","releases_url":"https://api.github.com/repos/edx/edx-documentation/releases{/id}","created_at":"2014-09-09T15:29:04Z","updated_at":"2015-07-21T18:18:11Z","pushed_at":"2015-07-22T17:58:51Z","git_url":"git://github.com/edx/edx-documentation.git","ssh_url":"git@github.com:edx/edx-documentation.git","clone_url":"https://github.com/edx/edx-documentation.git","svn_url":"https://github.com/edx/edx-documentation","homepage":null,"size":81618,"stargazers_count":19,"watchers_count":19,"language":"Makefile","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":69,"mirror_url":null,"open_issues_count":25,"forks":69,"open_issues":25,"watchers":19,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/452"},"html":{"href":"https://github.com/edx/edx-documentation/pull/452"},"issue":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/452"},"comments":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/452/comments"},"review_comments":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/452/comments"},"review_comment":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/452/commits"},"statuses":{"href":"https://api.github.com/repos/edx/edx-documentation/statuses/c6e9eb0db8733e5c03f9d47f29769bd7f732af93"}}}}