Antes de empezar
Antes de configurar GitHub como una conexión social, necesitas:
- Una cuenta de Auth0. Si no tienes una, puedes registrarte gratis.
- Una cuenta de GitHub.
- Una aplicación registrada en el Auth0 Dashboard.
Configurar GitHub
Abra la configuración de desarrollador de GitHub
Inicie sesión en su cuenta de GitHub. Seleccione su foto de perfil en la esquina superior derecha y, a continuación, seleccione Settings. En la barra lateral izquierda, seleccione Developer settings y, luego, OAuth Apps.
Registre una nueva aplicación OAuth
Seleccione New OAuth App. Si aún no ha creado ninguna aplicación, seleccione Register a new application.Complete los siguientes campos:
Reemplace
| Campo | Valor |
|---|---|
| Application name | Un nombre que sus usuarios reconozcan y en el que confíen, por ejemplo My App (Auth0) |
| Homepage URL | La URL completa de la página principal de su aplicación, por ejemplo https://myapp.example.com |
| Application description | (Opcional) Una descripción que se muestra a todos los usuarios de su aplicación |
| Authorization callback URL | https://YOUR_AUTH0_DOMAIN/login/callback |
YOUR_AUTH0_DOMAIN por el dominio de su inquilino de Auth0. Puede encontrar este valor en Auth0 Dashboard > Applications > Applications, en la pestaña Settings.Puede dejar Enable Device Flow sin seleccionar, a menos que su aplicación requiera autorización basada en dispositivos.Seleccione Register application.Copie el ID de cliente y el Secreto del cliente
Después del registro, GitHub muestra la página de detalles de la aplicación. Copie el valor de ID de cliente.Seleccione Generate a new client secret para crear un secreto. Copie el valor generado de inmediato.
GitHub muestra el Secreto del cliente solo una vez. Guárdelo en un lugar seguro antes de salir de la página. Si lo pierde, deberá generar uno nuevo.
Configurar Auth0
Crear una conexión de GitHub
Ve a Auth0 Dashboard > Authentication > Social y selecciona Create Connection. Selecciona GitHub de la lista de proveedores.
Seleccionar el propósito de la conexión
En Purpose, especifica cómo se usará esta conexión: para el inicio de sesión, las cuentas vinculadas o ambos.
Introducir tus credenciales de GitHub
En General, introduce el ID de cliente y el Secreto del cliente que copiaste de GitHub.
Seleccionar permisos
En Permissions, selecciona los permisos que requiere tu aplicación. La mayoría de las aplicaciones necesitan Email address para el correo electrónico del usuario y Read user para la información del perfil.
Probar la conexión
- Ve a Auth0 Dashboard > Authentication > Social.
- Selecciona la conexión de GitHub de la lista.
- Selecciona Try Connection.
- Autentícate con tu cuenta de GitHub cuando se te solicite.
- Confirma que Auth0 devuelve los datos del perfil del usuario, incluidos el username de GitHub y la dirección de correo electrónico.