eyJleHRlcm5hbF9saW5rIjoiaHR0cHM6Ly9naXRodWIuY29tIiwiZXh0ZXJuYWxfbGlua190ZXh0IjoiR2l0SHViIiwic3VwcG9ydF9sZXZlbCI6InN1cHBvcnRlZCIsIm1ldGFfdGl0bGUiOiJHaXRIdWIgSW50ZWdyYXRpb24gd2l0aCBBdXRoMCIsIm1ldGFfZGVzY3JpcHRpb24iOiJHaXRIdWIgLSBFbmFibGUgdGhlIEdpdEh1YiBsb2dpbiBvcHRpb24gZm9yIHlvdXIgQXV0aDAgYXBwbGljYXRpb25zIiwidmFsdWVfcHJvcHMiOlt7ImltYWdlIjoiaHR0cHM6Ly9jZG4uYXV0aDAuY29tL21hcmtldHBsYWNlL2NhdGFsb2cvY29udGVudC9hc3NldHMvc29jaWFsLWNvbm5lY3Rpb25zL2dpdGh1Yi9tZWRpYS9naXRodWItc29jaWFsLTEuanBnIiwidGl0bGUiOiJJbmNyZWFzZSBDb252ZXJzaW9uIiwiZGVzY3JpcHRpb24iOiJXaXRoIGxvdHMgb2YgdXNlcnMgYWxyZWFkeSBoYXZpbmcgR2l0SHViIGFjY291bnRzLCB5b3UgY2FuIGltcHJvdmUgY29udmVyc2lvbiBieSBtaW5pbWl6aW5nIHRoZSBudW1iZXIgb2Ygc3RlcHMgZm9yIHVzZXJzIHRvIHNpZ24gdXAgYW5kIGxvZ2luIHRvIHlvdXIgYXBwLiJ9LHsiaW1hZ2UiOiJodHRwczovL2Nkbi5hdXRoMC5jb20vbWFya2V0cGxhY2UvY2F0YWxvZy9jb250ZW50L2Fzc2V0cy9zb2NpYWwtY29ubmVjdGlvbnMvZ2l0aHViL21lZGlhL2dpdGh1Yi1zb2NpYWwtMi5wbmciLCJ0aXRsZSI6IlZlcmlmaWVkIFVzZXJzIiwiZGVzY3JpcHRpb24iOiJHaXRIdWIgYWxyZWFkeSBhcHBsaWVzIHJpZ29yb3VzIHNhZmVndWFyZHMgdG8gdXNlciBwcm9maWxlcy4gUmVzdCBhc3N1cmVkIHRoYXQgeW91ciBhcHBsaWNhdGlvbiByZWNlaXZlcyBhY2N1cmF0ZSBhbmQgdmVyaWZpZWQgcHJvZmlsZSBpbmZvcm1hdGlvbi4ifSx7ImltYWdlIjoiaHR0cHM6Ly9jZG4uYXV0aDAuY29tL21hcmtldHBsYWNlL2NhdGFsb2cvY29udGVudC9hc3NldHMvc29jaWFsLWNvbm5lY3Rpb25zL2dpdGh1Yi9tZWRpYS9naXRodWItc29jaWFsLTMucG5nIiwidGl0bGUiOiJTZWN1cmUgQ3JlZGVudGlhbHMiLCJkZXNjcmlwdGlvbiI6IlRha2UgYWR2YW50YWdlIG9mIEdpdEh1YidzIGV4dHJlbWVseSBoaWdoIHNlY3VyaXR5IGFuZCB0cnVzdCBHaXRIdWIgYXMgYSBzb3VyY2UgdG8gc2FmZWd1YXJkIHVzZXIgY3JlZGVudGlhbHMgc28gdGhhdCB5b3UgZG9uJ3QgaGF2ZSB0by4ifV19

Provide Github as a login option for your users to authenticate to your app or your platform.

With hundreds of millions of private, public, and open source repositories hosted on GitHub, over 50M developers have verified GitHub account credentials already. GitHub is always free for both public and private projects, and is still growing fast. Developers all over the world use GitHub daily to collaborate and have advanced tools and security features at their fingertips when they sign up for GitHub Pro, GitHub Team, or GitHub Enterprise. Trusted by more than 2.9M businesses and organizations already, GitHub quickly gives you login access to many of the world's developers in a single integration.

<p>The GitHub social connection allows users to log in to your application using their GitHub profile.</p>
<p>By default, Auth0 automatically syncs user profile data with each user login, thereby ensuring that changes made in the connection source are automatically updated in Auth0. Optionally, you can <a href="https://auth0.com/docs/users/configure-connection-sync-with-auth0">disable user profile data synchronization</a> to allow for updating profile attributes from your application.</p>


<h2 id="prerequisites">Prerequisites</h2>
<p>Before you begin, <a href="https://github.com/settings/developers">sign up for a GitHub Developer account</a>.</p>


<h2 id="set-up-app-in-github">Set up app in GitHub</h2>
<p>Register a new app in <a href="https://github.com/settings/developers#oauth-apps">GitHub Developer Settings: OAuth Apps</a>. During this process, GitHub will generate a <strong>Client ID</strong> and <strong>Client Secret</strong> for your application; make note of these.</p>
<p>While setting up your app, use the following settings:</p>
<table class="table"><thead><tr><th>Field</th><th>Value to Provide</th></tr></thead><tbody><tr><td>Homepage URL</td><td><code>https://YOUR_DOMAIN</code></td></tr><tr><td>Authorization callback URL</td><td><code>https://YOUR_DOMAIN/login/callback</code></td></tr></tbody></table>

<h3 id="find-your-auth0-domain-name">Find your Auth0 domain name</h3>
<p>If your Auth0 domain name is not shown above and you are not using our custom domains feature, your domain name is your tenant name, your regional subdomain (unless your tenant is in the US region and was created before June 2020), plus<code>.auth0.com</code>. For example, if your tenant name were <code>exampleco-enterprises</code>, your Auth0 domain name would be <code>exampleco-enterprises.us.auth0.com</code> and your callback URL would be <code>https://exampleco-enterprises.us.auth0.com/login/callback</code>. (If your tenant is in the US and was created before June 2020, then your domain name would be <code>https://exampleco-enterprises.auth0.com</code>.)</p>
<p>If you are using <a href="https://auth0.com/docs/custom-domains">custom domains</a>, your redirect URI will have the following format: <code>https://&lt;YOUR CUSTOM DOMAIN&gt;/login/callback</code>.</p>


<h2 id="test-connection">Test connection</h2>
<p>You&#39;re ready to <a href="https://auth0.com/docs/dashboard/guides/connections/test-connections-social">test your connection</a>. After logging in, you&#39;ll be prompted to allow your app access. To do so, click <strong>Install unlisted app</strong>.</p>


<h2 id="troubleshooting">Troubleshooting</h2>
<p>If you are receiving <code>Access Denied</code> when calling the GitHub API, you probably have not requested the correct permissions for the user during login. To learn more, see <a href="https://auth0.com/docs/connections/adding-scopes-for-an-external-idp">Add scopes/permissions to call Identity Provider&#39;s APIs</a>.</p>


GitHub - Enable the GitHub login option for your Auth0 applications

GitHub Integration with Auth0

GitHub

Enable the GitHub login option for your Auth0 applications

With lots of users already having GitHub accounts, you can improve conversion by minimizing the number of steps for users to sign up and login to your app.

Increase Conversion

GitHub already applies rigorous safeguards to user profiles. Rest assured that your application receives accurate and verified profile information.

Verified Users

Take advantage of GitHub's extremely high security and trust GitHub as a source to safeguard user credentials so that you don't have to.