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.
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.
- 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
| Nome | Tipo |
|---|---|
| clientId | string |
| clientSecret | string |
| scope | string |
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 APIGitLab - Aplicações OAuth