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