Configurar login do GitHub para Discourse

[Discourse]

Este guia explica como configurar o GitHub como uma opção de login para seu fórum Discourse, configurando as credenciais OAuth.

Nível de usuário necessário: Administrador

Visão Geral

A integração de login do GitHub permite que os usuários façam login em seu site Discourse usando suas contas do GitHub. Isso fornece uma opção de autenticação conveniente, especialmente útil para comunidades focadas em desenvolvedores.

Configurando o OAuth do GitHub

1. Visite as configurações de desenvolvedor do GitHub em https://github.com/settings/developers

2. No menu esquerdo, localize e clique em OAuth Apps

3. Clique em New OAuth App

4. Preencha os campos obrigatórios:

   • Application name: Insira o nome do seu site
   • Homepage URL: A URL principal do seu site (ex: https://discourse.example.com)
   • Application description (opcional): Descreva brevemente seu site
   • Authorization callback URL: Use o domínio do seu site com o caminho /auth/github/callback
     (ex: https://discourse.example.com/auth/github/callback)

5. Clique em Register application

Configurando as definições do Discourse

1. Após o registro, o GitHub exibirá seu Client ID na página de configurações do aplicativo.

2. Para obter um Client Secret, clique em Generate a new client secret. Copie-o imediatamente — ele será exibido apenas uma vez.

3. Nas configurações de administrador do seu Discourse, configure o seguinte:

   • Defina github_client_id para o seu Client ID
   • Defina github_client_secret para o seu Client Secret
   • Habilite a configuração enable github logins

Testando a integração

1. Saia do seu site Discourse
2. Na página de login, você deverá ver agora uma opção de login “com GitHub”
3. Teste o fluxo de login para garantir que funcione como esperado

Melhores práticas

• Mantenha seu Client Secret seguro e nunca o compartilhe publicamente
• Revise regularmente as configurações do seu aplicativo OAuth do GitHub
• Considere habilitar recursos de segurança adicionais nas configurações do aplicativo OAuth do GitHub

Problemas comuns e soluções

• Se o login falhar, verifique se sua URL de callback corresponde exatamente ao que está configurado no GitHub
• Certifique-se de que o certificado SSL do seu site seja válido, pois o GitHub exige HTTPS
• Verifique se o ID do cliente e o segredo estão inseridos corretamente nas configurações do Discourse

Recursos adicionais

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