Configurar inicio de sesión de GitHub para Discourse

[Discourse]

Esta guía explica cómo configurar GitHub como una opción de inicio de sesión para su foro de Discourse configurando las credenciales de OAuth.

Nivel de usuario requerido: Administrador

Resumen

La integración de inicio de sesión con GitHub permite a los usuarios iniciar sesión en su sitio de Discourse usando sus cuentas de GitHub. Esto proporciona una opción de autenticación conveniente, especialmente útil para comunidades centradas en desarrolladores.

Configuración de GitHub OAuth

1. Visite la configuración de desarrollador de GitHub en https://github.com/settings/developers

2. En el menú de la izquierda, localice y haga clic en Aplicaciones de OAuth (OAuth Apps)

3. Haga clic en Nueva aplicación de OAuth (New OAuth App)

4. Rellene los campos requeridos:

   • Nombre de la aplicación (Application name): Ingrese el nombre de su sitio
   • URL de la página de inicio (Homepage URL): La URL principal de su sitio (ej: https://discourse.example.com)
   • Descripción de la aplicación (Application description) (opcional): Describa brevemente su sitio
   • URL de devolución de llamada de autorización (Authorization callback URL): Use el dominio de su sitio con la ruta /auth/github/callback
     (ej: https://discourse.example.com/auth/github/callback)

5. Haga clic en Registrar aplicación (Register application)

Configuración de los ajustes de Discourse

1. Después del registro, GitHub mostrará su ID de cliente (Client ID) en la página de configuración de la aplicación.

2. Para obtener un Secreto de cliente (Client Secret), haga clic en Generar un nuevo secreto de cliente (Generate a new client secret). Cópielo inmediatamente; solo se mostrará una vez.

3. En la configuración de administrador de su Discourse, configure lo siguiente:

   • Establezca github_client_id en su ID de cliente
   • Establezca github_client_secret en su Secreto de cliente
   • Habilite la configuración enable github logins

Prueba de la integración

1. Cierre la sesión en su sitio de Discourse
2. En la página de inicio de sesión, ahora debería ver una opción de inicio de sesión “con GitHub”
3. Pruebe el flujo de inicio de sesión para asegurarse de que funciona como se espera

Mejores prácticas

• Mantenga su Secreto de cliente seguro y nunca lo comparta públicamente
• Revise regularmente la configuración de su aplicación OAuth de GitHub
• Considere habilitar funciones de seguridad adicionales en la configuración de la aplicación OAuth de GitHub

Problemas comunes y soluciones

• Si el inicio de sesión falla, verifique que su URL de devolución de llamada coincida exactamente con lo configurado en GitHub
• Asegúrese de que el certificado SSL de su sitio sea válido, ya que GitHub requiere HTTPS
• Verifique que tanto el ID de cliente como el secreto se hayan ingresado correctamente en la configuración de Discourse

Recursos adicionales

• Setup DiscourseConnect - Official Single-Sign-On for Discourse (sso)
• Creating an OAuth app - GitHub Docs