Pular para o conteúdo principal

Configurar login social com GitHub

O conector oficial do Logto para login social com GitHub.

dica

Neste guia, assumimos que você tem conhecimento básico sobre Conectores (Connectors) do Logto. Se não tiver, confira o guia Configurar conectores para começar.

Introdução​

O conector GitHub permite que os usuários finais façam login no seu aplicativo usando suas próprias contas GitHub via o protocolo de autenticação OAuth 2.0 do GitHub.

Fazer login com conta GitHub​

Vá para o site do GitHub e faça login com sua conta 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 Application name e preencha o Homepage URL do aplicativo. Você pode deixar o campo Application description em branco e personalizar o Authorization callback URL 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.

Nota: Se você encontrar a mensagem de erro "The redirect_uri MUST match the registered callback URL for this application." ao fazer login, tente alinhar o URL de Retorno 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 Enable Device Flow, ou os usuários que fizerem login com 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 os campos 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​

NomeTipo
clientIdstring
clientSecretstring
scopestring

Testar conector GitHub​

É isso. O conector GitHub deve estar disponível agora. Não se esqueça de Habilitar conector social na experiência de login.

Referência​