Pular para o conteúdo principal

Configurar login social com GitLab (Set up social login with GitLab)

O conector oficial do Logto para login social com GitLab. Use o GitLab como um provedor de identidade de autenticação OAuth 2.0.

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.

Primeiros passos

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

Entrar com conta GitLab

Acesse o site do GitLab e faça login com sua conta GitLab. Você pode registrar uma nova conta se ainda não tiver uma.

Criar e configurar aplicativo OAuth

Siga o guia criando um aplicativo OAuth do GitLab e registre um novo aplicativo.

Dê um nome ao seu novo aplicativo OAuth em Name e preencha o Redirect URI do aplicativo. Personalize o Redirect URIs 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.

Nos escopos, selecione openid. Você também pode querer habilitar profile e email. O escopo profile é necessário para obter as informações do perfil do usuário, e o escopo email é necessário para obter o endereço de email do usuário. Certifique-se de permitir esses escopos em seu aplicativo OAuth do GitLab se desejar usá-los. Esses escopos também serão usados ao configurar seu conector posteriormente.

nota:
  • Se você usar domínios personalizados, adicione tanto o domínio personalizado quanto o domínio padrão do Logto aos Redirect URIs para garantir que o fluxo OAuth funcione corretamente em ambos os domínios.
  • 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 Redirect URI do seu aplicativo OAuth do GitLab e a URL de redirecionamento do seu aplicativo Logto (incluindo o protocolo) para resolver o problema.

Gerenciando aplicativos OAuth

Acesse a página de Aplicativos no GitLab, onde você pode adicionar, editar ou excluir aplicativos OAuth existentes. Você também pode encontrar o Application ID e gerar o Secret nas páginas de detalhes do aplicativo OAuth.

Configure seu conector

Preencha os campos clientId e clientSecret com o Application ID e o Secret que você obteve nas páginas de detalhes do aplicativo OAuth mencionadas na seção anterior.

scope é uma lista separada por espaços de escopos. Se não for fornecido, o escopo padrão será openid. Para o conector GitLab, os escopos que você pode querer usar são openid, profile e email. O escopo profile é necessário para obter as informações do perfil do usuário, e o escopo email é necessário para obter o endereço de email do usuário. Certifique-se de permitir esses escopos em seu aplicativo OAuth do GitLab (configurado na seção Criar e configurar aplicativo OAuth).

Tipos de configuração

NomeTipo
clientIdstring
clientSecretstring
scopestring

Testar o conector GitLab

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

Referências

GitLab - Documentação da API

GitLab - Aplicações OAuth