Configurar login social com GitHub
O conector oficial do Logto para login social do GitHub.
Este guia assume que você tem um entendimento básico dos Conectores (Connectors) do Logto. Para aqueles que não estão familiarizados, consulte o guia de Conectores para começar.
Introdução
O conector do GitHub permite que os usuários finais façam login em seu aplicativo usando suas próprias contas do GitHub via protocolo de autenticação OAuth 2.0 do GitHub.
Fazer login com conta do GitHub
Vá para o site do GitHub e faça login com sua conta do GitHub. Você pode registrar uma nova conta se não tiver uma.
Criar e configurar aplicativo OAuth
Siga o guia de criação de um aplicativo OAuth e registre um novo aplicativo.
Nomeie seu novo aplicativo OAuth em Nome do aplicativo e preencha o URL da página inicial do aplicativo. Você pode deixar o campo Descrição do aplicativo em branco e personalizar o URL de retorno de chamada de autorização como ${your_logto_origin}/callback/${connector_id}
. O connector_id
pode ser encontrado na barra superior da página de detalhes do conector no Logto Admin Console.
Se você encontrar a mensagem de erro "O redirect_uri DEVE corresponder ao URL de retorno de chamada registrado para este aplicativo." ao fazer login, tente alinhar o URL de retorno de chamada de autorização do seu aplicativo OAuth do GitHub e o URL de redirecionamento do seu aplicativo Logto (incluindo o protocolo) para resolver o problema.
Sugerimos não marcar a caixa antes de Habilitar Fluxo de Dispositivo, ou os usuários que fizerem login com o GitHub em dispositivos móveis deverão confirmar a ação inicial de login no aplicativo GitHub. Muitos usuários do GitHub não instalam o aplicativo móvel do GitHub em seus telefones, o que pode bloquear o fluxo de login. Por favor, ignore nossa sugestão se você espera que os usuários finais confirmem seu fluxo de login. Veja detalhes do fluxo de dispositivo.
Gerenciando aplicativos OAuth
Vá para a página de aplicativos OAuth e você pode adicionar, editar ou excluir aplicativos OAuth existentes. Você também pode encontrar o Client ID
e gerar Client secrets
nas páginas de detalhes do aplicativo OAuth.
Configurar seu conector
Preencha o campo clientId
e clientSecret
com o Client ID e Client Secret que você obteve nas páginas de detalhes do aplicativo OAuth mencionadas na seção anterior.
scope
é uma lista delimitada por espaços de escopos. Se não for fornecido, o escopo padrão será read:user
.
Tipos de configuração
Nome | Tipo |
---|---|
clientId | string |
clientSecret | string |
scope | string |
Testar conector do GitHub
É isso. O conector do GitHub deve estar disponível agora. Não se esqueça de Habilitar conector social na experiência de login.
Referência
GitHub - Developers - Apps
GitHub - Developers - Apps - Creating an OAuth App