keycloak-scim/docs/documentation/server_admin/topics/identity-broker/social/github.adoc

[[_github]]

==== GitHub

To log in with GitHub, perform the following procedure.

.Procedure
. Click *Identity Providers* in the menu.
. From the `Add provider` list, select `Github`.
+
.Add identity provider
image:images/github-add-identity-provider.png[Add Identity Provider]
+
. Copy the value of *Redirect URI* to your clipboard.
. In a separate browser tab, https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app[create an OAUTH app].
.. Enter the value of *Redirect URI* into the `Authorization callback URL` field when creating the app.
.. Note the `Client ID` and `Client secret` on the management page of your OAUTH app.
. In {project_name}, paste the value of the `Client ID` into the *Client ID* field.
. In {project_name}, paste the value of the `Client secret` into the *Client Secret* field.
. Click *Add*.