{"action":"created","comment":{"url":"https://api.github.com/repos/okta/okta.github.io/pulls/comments/143276090","pull_request_review_id":67770292,"id":143276090,"diff_hunk":"@@ -5,3 +5,19 @@ title: Okta Authentication Guide\n ---\n \n # The Okta Authentication Guide\n+\n+This guide answers some common questions about authentication with Okta. It is meant to be used alongside the [OAuth 2.0 API ](/docs/api/resources/oauth2.html) and the [OpenID Connect API](/docs/api/resources/oidc.html) reference documents. The reference documents will give you detailed information about endpoints and resources, while this guide will show you how to use them.\n+\n+This guide will also direct you to examples of how to implement authentication in your language of choice, using one of Okta's SDKs.\n+\n+(jakub.todo Links forthcoming) \n+\n+On the left-hand side you can navigate to different sections of the guide. Alternatively, find a question you would like answered below:\n+\n+- [What is the difference between OAuth 2.0, OpenID Connect, and the Okta Authentication API?](auth-overview/#oauth-20-vs-openid-connect-vs-authentication-api)","path":"_source/_authentication-guide/index.md","position":17,"original_position":13,"commit_id":"a775b40e067d8b716857ab0b836e6be799b8e452","original_commit_id":"a775b40e067d8b716857ab0b836e6be799b8e452","user":{"login":"mystiberry-okta","id":17009066,"avatar_url":"https://avatars2.githubusercontent.com/u/17009066?v=4","gravatar_id":"","url":"https://api.github.com/users/mystiberry-okta","html_url":"https://github.com/mystiberry-okta","followers_url":"https://api.github.com/users/mystiberry-okta/followers","following_url":"https://api.github.com/users/mystiberry-okta/following{/other_user}","gists_url":"https://api.github.com/users/mystiberry-okta/gists{/gist_id}","starred_url":"https://api.github.com/users/mystiberry-okta/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mystiberry-okta/subscriptions","organizations_url":"https://api.github.com/users/mystiberry-okta/orgs","repos_url":"https://api.github.com/users/mystiberry-okta/repos","events_url":"https://api.github.com/users/mystiberry-okta/events{/privacy}","received_events_url":"https://api.github.com/users/mystiberry-okta/received_events","type":"User","site_admin":false},"body":"Are we repeating the entire top-level toc here? why?","created_at":"2017-10-06T19:24:57Z","updated_at":"2017-10-06T19:24:57Z","html_url":"https://github.com/okta/okta.github.io/pull/1344#discussion_r143276090","pull_request_url":"https://api.github.com/repos/okta/okta.github.io/pulls/1344","author_association":"MEMBER","_links":{"self":{"href":"https://api.github.com/repos/okta/okta.github.io/pulls/comments/143276090"},"html":{"href":"https://github.com/okta/okta.github.io/pull/1344#discussion_r143276090"},"pull_request":{"href":"https://api.github.com/repos/okta/okta.github.io/pulls/1344"}}},"pull_request":{"url":"https://api.github.com/repos/okta/okta.github.io/pulls/1344","id":145221903,"html_url":"https://github.com/okta/okta.github.io/pull/1344","diff_url":"https://github.com/okta/okta.github.io/pull/1344.diff","patch_url":"https://github.com/okta/okta.github.io/pull/1344.patch","issue_url":"https://api.github.com/repos/okta/okta.github.io/issues/1344","number":1344,"state":"open","locked":false,"title":"Authentication Guide","user":{"login":"jmelberg-okta","id":20212241,"avatar_url":"https://avatars3.githubusercontent.com/u/20212241?v=4","gravatar_id":"","url":"https://api.github.com/users/jmelberg-okta","html_url":"https://github.com/jmelberg-okta","followers_url":"https://api.github.com/users/jmelberg-okta/followers","following_url":"https://api.github.com/users/jmelberg-okta/following{/other_user}","gists_url":"https://api.github.com/users/jmelberg-okta/gists{/gist_id}","starred_url":"https://api.github.com/users/jmelberg-okta/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jmelberg-okta/subscriptions","organizations_url":"https://api.github.com/users/jmelberg-okta/orgs","repos_url":"https://api.github.com/users/jmelberg-okta/repos","events_url":"https://api.github.com/users/jmelberg-okta/events{/privacy}","received_events_url":"https://api.github.com/users/jmelberg-okta/received_events","type":"User","site_admin":false},"body":"## Description:\r\nCopied from #1340 \r\n\r\n> NOTE: I recommend that you pull this branch down and build it locally, as some things (like images) don't show up in the Github renderings. The Authentication Guide has an entry on the left-side navigation bar, which should allow you move around. The front page of the AuthN Guide is here: http://localhost:4000/authentication-guide/\r\n\r\nThis guide does a few different things:\r\n\r\n- It gathers disparate information that already existed (ex. Setting up an AuthZ server; Social Login) and puts it into one area, so you're not left jumping around the site\r\n- It adds a bunch of new content to help you use the Okta OAuth implementation\r\n\r\nYou can think of it as the missing cookbook for the OAuth/OIDC API docs, although it covers more areas as well.\r\n\r\n**All feedback is good feedback.**\r\n\r\n> NOTE 2: There should be a lot more links out to various language-specific docs and example apps, but right now no one has a good picture of what all those are or where they are. @robertdamphousse-okta is hoping to have that ready ASAP, at which time we will go through and add links throughout this guide. \r\n\r\n","created_at":"2017-10-06T18:52:51Z","updated_at":"2017-10-06T19:24:57Z","closed_at":null,"merged_at":null,"merge_commit_sha":"2f870a840986fd8e8ca1e8e2e5ff2b742b49ecfb","assignee":null,"assignees":[],"requested_reviewers":[],"milestone":null,"commits_url":"https://api.github.com/repos/okta/okta.github.io/pulls/1344/commits","review_comments_url":"https://api.github.com/repos/okta/okta.github.io/pulls/1344/comments","review_comment_url":"https://api.github.com/repos/okta/okta.github.io/pulls/comments{/number}","comments_url":"https://api.github.com/repos/okta/okta.github.io/issues/1344/comments","statuses_url":"https://api.github.com/repos/okta/okta.github.io/statuses/a775b40e067d8b716857ab0b836e6be799b8e452","head":{"label":"okta:jv-auth-guide","ref":"jv-auth-guide","sha":"a775b40e067d8b716857ab0b836e6be799b8e452","user":{"login":"okta","id":362460,"avatar_url":"https://avatars1.githubusercontent.com/u/362460?v=4","gravatar_id":"","url":"https://api.github.com/users/okta","html_url":"https://github.com/okta","followers_url":"https://api.github.com/users/okta/followers","following_url":"https://api.github.com/users/okta/following{/other_user}","gists_url":"https://api.github.com/users/okta/gists{/gist_id}","starred_url":"https://api.github.com/users/okta/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/okta/subscriptions","organizations_url":"https://api.github.com/users/okta/orgs","repos_url":"https://api.github.com/users/okta/repos","events_url":"https://api.github.com/users/okta/events{/privacy}","received_events_url":"https://api.github.com/users/okta/received_events","type":"Organization","site_admin":false},"repo":{"id":10953058,"name":"okta.github.io","full_name":"okta/okta.github.io","owner":{"login":"okta","id":362460,"avatar_url":"https://avatars1.githubusercontent.com/u/362460?v=4","gravatar_id":"","url":"https://api.github.com/users/okta","html_url":"https://github.com/okta","followers_url":"https://api.github.com/users/okta/followers","following_url":"https://api.github.com/users/okta/following{/other_user}","gists_url":"https://api.github.com/users/okta/gists{/gist_id}","starred_url":"https://api.github.com/users/okta/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/okta/subscriptions","organizations_url":"https://api.github.com/users/okta/orgs","repos_url":"https://api.github.com/users/okta/repos","events_url":"https://api.github.com/users/okta/events{/privacy}","received_events_url":"https://api.github.com/users/okta/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/okta/okta.github.io","description":"Okta Identity Platform API Docs and Developer Home","fork":false,"url":"https://api.github.com/repos/okta/okta.github.io","forks_url":"https://api.github.com/repos/okta/okta.github.io/forks","keys_url":"https://api.github.com/repos/okta/okta.github.io/keys{/key_id}","collaborators_url":"https://api.github.com/repos/okta/okta.github.io/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/okta/okta.github.io/teams","hooks_url":"https://api.github.com/repos/okta/okta.github.io/hooks","issue_events_url":"https://api.github.com/repos/okta/okta.github.io/issues/events{/number}","events_url":"https://api.github.com/repos/okta/okta.github.io/events","assignees_url":"https://api.github.com/repos/okta/okta.github.io/assignees{/user}","branches_url":"https://api.github.com/repos/okta/okta.github.io/branches{/branch}","tags_url":"https://api.github.com/repos/okta/okta.github.io/tags","blobs_url":"https://api.github.com/repos/okta/okta.github.io/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/okta/okta.github.io/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/okta/okta.github.io/git/refs{/sha}","trees_url":"https://api.github.com/repos/okta/okta.github.io/git/trees{/sha}","statuses_url":"https://api.github.com/repos/okta/okta.github.io/statuses/{sha}","languages_url":"https://api.github.com/repos/okta/okta.github.io/languages","stargazers_url":"https://api.github.com/repos/okta/okta.github.io/stargazers","contributors_url":"https://api.github.com/repos/okta/okta.github.io/contributors","subscribers_url":"https://api.github.com/repos/okta/okta.github.io/subscribers","subscription_url":"https://api.github.com/repos/okta/okta.github.io/subscription","commits_url":"https://api.github.com/repos/okta/okta.github.io/commits{/sha}","git_commits_url":"https://api.github.com/repos/okta/okta.github.io/git/commits{/sha}","comments_url":"https://api.github.com/repos/okta/okta.github.io/comments{/number}","issue_comment_url":"https://api.github.com/repos/okta/okta.github.io/issues/comments{/number}","contents_url":"https://api.github.com/repos/okta/okta.github.io/contents/{+path}","compare_url":"https://api.github.com/repos/okta/okta.github.io/compare/{base}...{head}","merges_url":"https://api.github.com/repos/okta/okta.github.io/merges","archive_url":"https://api.github.com/repos/okta/okta.github.io/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/okta/okta.github.io/downloads","issues_url":"https://api.github.com/repos/okta/okta.github.io/issues{/number}","pulls_url":"https://api.github.com/repos/okta/okta.github.io/pulls{/number}","milestones_url":"https://api.github.com/repos/okta/okta.github.io/milestones{/number}","notifications_url":"https://api.github.com/repos/okta/okta.github.io/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/okta/okta.github.io/labels{/name}","releases_url":"https://api.github.com/repos/okta/okta.github.io/releases{/id}","deployments_url":"https://api.github.com/repos/okta/okta.github.io/deployments","created_at":"2013-06-25T23:22:38Z","updated_at":"2017-09-25T11:07:28Z","pushed_at":"2017-10-06T18:52:51Z","git_url":"git://github.com/okta/okta.github.io.git","ssh_url":"git@github.com:okta/okta.github.io.git","clone_url":"https://github.com/okta/okta.github.io.git","svn_url":"https://github.com/okta/okta.github.io","homepage":"http://developer.okta.com/","size":132721,"stargazers_count":26,"watchers_count":26,"language":"HTML","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":85,"mirror_url":null,"open_issues_count":22,"forks":85,"open_issues":22,"watchers":26,"default_branch":"source"}},"base":{"label":"okta:source","ref":"source","sha":"79c3bbfb50cc2e2022871eaf985b88b13df27c0b","user":{"login":"okta","id":362460,"avatar_url":"https://avatars1.githubusercontent.com/u/362460?v=4","gravatar_id":"","url":"https://api.github.com/users/okta","html_url":"https://github.com/okta","followers_url":"https://api.github.com/users/okta/followers","following_url":"https://api.github.com/users/okta/following{/other_user}","gists_url":"https://api.github.com/users/okta/gists{/gist_id}","starred_url":"https://api.github.com/users/okta/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/okta/subscriptions","organizations_url":"https://api.github.com/users/okta/orgs","repos_url":"https://api.github.com/users/okta/repos","events_url":"https://api.github.com/users/okta/events{/privacy}","received_events_url":"https://api.github.com/users/okta/received_events","type":"Organization","site_admin":false},"repo":{"id":10953058,"name":"okta.github.io","full_name":"okta/okta.github.io","owner":{"login":"okta","id":362460,"avatar_url":"https://avatars1.githubusercontent.com/u/362460?v=4","gravatar_id":"","url":"https://api.github.com/users/okta","html_url":"https://github.com/okta","followers_url":"https://api.github.com/users/okta/followers","following_url":"https://api.github.com/users/okta/following{/other_user}","gists_url":"https://api.github.com/users/okta/gists{/gist_id}","starred_url":"https://api.github.com/users/okta/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/okta/subscriptions","organizations_url":"https://api.github.com/users/okta/orgs","repos_url":"https://api.github.com/users/okta/repos","events_url":"https://api.github.com/users/okta/events{/privacy}","received_events_url":"https://api.github.com/users/okta/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/okta/okta.github.io","description":"Okta Identity Platform API Docs and Developer Home","fork":false,"url":"https://api.github.com/repos/okta/okta.github.io","forks_url":"https://api.github.com/repos/okta/okta.github.io/forks","keys_url":"https://api.github.com/repos/okta/okta.github.io/keys{/key_id}","collaborators_url":"https://api.github.com/repos/okta/okta.github.io/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/okta/okta.github.io/teams","hooks_url":"https://api.github.com/repos/okta/okta.github.io/hooks","issue_events_url":"https://api.github.com/repos/okta/okta.github.io/issues/events{/number}","events_url":"https://api.github.com/repos/okta/okta.github.io/events","assignees_url":"https://api.github.com/repos/okta/okta.github.io/assignees{/user}","branches_url":"https://api.github.com/repos/okta/okta.github.io/branches{/branch}","tags_url":"https://api.github.com/repos/okta/okta.github.io/tags","blobs_url":"https://api.github.com/repos/okta/okta.github.io/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/okta/okta.github.io/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/okta/okta.github.io/git/refs{/sha}","trees_url":"https://api.github.com/repos/okta/okta.github.io/git/trees{/sha}","statuses_url":"https://api.github.com/repos/okta/okta.github.io/statuses/{sha}","languages_url":"https://api.github.com/repos/okta/okta.github.io/languages","stargazers_url":"https://api.github.com/repos/okta/okta.github.io/stargazers","contributors_url":"https://api.github.com/repos/okta/okta.github.io/contributors","subscribers_url":"https://api.github.com/repos/okta/okta.github.io/subscribers","subscription_url":"https://api.github.com/repos/okta/okta.github.io/subscription","commits_url":"https://api.github.com/repos/okta/okta.github.io/commits{/sha}","git_commits_url":"https://api.github.com/repos/okta/okta.github.io/git/commits{/sha}","comments_url":"https://api.github.com/repos/okta/okta.github.io/comments{/number}","issue_comment_url":"https://api.github.com/repos/okta/okta.github.io/issues/comments{/number}","contents_url":"https://api.github.com/repos/okta/okta.github.io/contents/{+path}","compare_url":"https://api.github.com/repos/okta/okta.github.io/compare/{base}...{head}","merges_url":"https://api.github.com/repos/okta/okta.github.io/merges","archive_url":"https://api.github.com/repos/okta/okta.github.io/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/okta/okta.github.io/downloads","issues_url":"https://api.github.com/repos/okta/okta.github.io/issues{/number}","pulls_url":"https://api.github.com/repos/okta/okta.github.io/pulls{/number}","milestones_url":"https://api.github.com/repos/okta/okta.github.io/milestones{/number}","notifications_url":"https://api.github.com/repos/okta/okta.github.io/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/okta/okta.github.io/labels{/name}","releases_url":"https://api.github.com/repos/okta/okta.github.io/releases{/id}","deployments_url":"https://api.github.com/repos/okta/okta.github.io/deployments","created_at":"2013-06-25T23:22:38Z","updated_at":"2017-09-25T11:07:28Z","pushed_at":"2017-10-06T18:52:51Z","git_url":"git://github.com/okta/okta.github.io.git","ssh_url":"git@github.com:okta/okta.github.io.git","clone_url":"https://github.com/okta/okta.github.io.git","svn_url":"https://github.com/okta/okta.github.io","homepage":"http://developer.okta.com/","size":132721,"stargazers_count":26,"watchers_count":26,"language":"HTML","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":85,"mirror_url":null,"open_issues_count":22,"forks":85,"open_issues":22,"watchers":26,"default_branch":"source"}},"_links":{"self":{"href":"https://api.github.com/repos/okta/okta.github.io/pulls/1344"},"html":{"href":"https://github.com/okta/okta.github.io/pull/1344"},"issue":{"href":"https://api.github.com/repos/okta/okta.github.io/issues/1344"},"comments":{"href":"https://api.github.com/repos/okta/okta.github.io/issues/1344/comments"},"review_comments":{"href":"https://api.github.com/repos/okta/okta.github.io/pulls/1344/comments"},"review_comment":{"href":"https://api.github.com/repos/okta/okta.github.io/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/okta/okta.github.io/pulls/1344/commits"},"statuses":{"href":"https://api.github.com/repos/okta/okta.github.io/statuses/a775b40e067d8b716857ab0b836e6be799b8e452"}},"author_association":"MEMBER"}}
{"actor":{"display_login":"mystiberry-okta"}}