Pular para o conteúdo principal

Configurar login social com GitHub

O conector oficial do Logto para login social do GitHub.

dica:

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.

nota:

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

NomeTipo
clientIdstring
clientSecretstring
scopestring

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