Login único (SSO) no Drupal usando o provedor de conexão OAuth 2.0 / OpenID personalizado
Visão geral
A integração SSO Drupal OAuth 2.0 / OpenID Connect (OIDC) permite o SSO entre o site Drupal e qualquer Provedor de Identidade. Essa integração é realizada por Cliente OAuth miniOrange módulo compatível com Drupal 7, Drupal 8, Drupal 9, Drupal 10 e também Drupal 11.
O módulo permite que um provedor de login OpenID Connect externo autentique e faça login de usuários no site Drupal. Confira os passos de integração com alguns provedores OAuth/OpenID populares, como Azure AD, Azure AD B2C, Keycloak, Okta, Salesforce, Active Directory Federation Services (AD FS), AWS Cognito, Auth0, Microsoft Office 365, GitHub, GitLab, OneLogin, Ping Identity, FusionAuth, WSO2 Identity Server, Bitbucket, Fitbit, Gluu, OneLogin, WildApricot, WHMCS, ForgeRock Identity Platform e muitos outros.
O módulo também é compatível com provedores de login social como Google, Discord, Slack, LinkedIn, Facebook, Instagram, Apple, Amazon, Yahoo, Pinterest, Snapchat e Twitter (X).
Neste documento, veremos as etapas para configurar o módulo:
Acesse Configuração → Personalidades → Configuração do cliente miniOrange OAuth
no menu Administração. (/admin/config/people/miniorange_oauth_client)
Na aba Configurar OAuth, selecione o Provedor OAuth desejado no menu suspenso.
Observação: Se o Provedor OAuth desejado não estiver listado no menu suspenso, selecione
Provedor OAuth personalizado / Provedor OpenID personalizado E continue.
Copie o URL de retorno/redirecionamento e mantenha-o à mão. Isso será necessário ao configurar o Provedor OAuth.
Observação: Se o seu provedor oferece suporte apenas a URLs de retorno/redirecionamento HTTPS e você tem um site HTTP, certifique-se de marcar a caixa de seleção "Aplicar URL de retorno HTTPS" na parte inferior da guia.
Insira o nome do provedor OAuth no Nome visível campo de texto.
Configurar o Drupal como um cliente OAuth
Acesse Configuração → Personalidades → Cliente OAuth miniOrange no menu Administração. (admin/config/people/mo-oauth-client/mo-client-config)
De acordo com o relatório Gerenciar seção, sob o Configuração do Cliente guia, clique no + Adicionar novo
botão para configurar o cliente OAuth desejado.
Sob o Adicione selecione o aplicativo OAuth desejado no menu suspenso.
Observação: Se o Provedor OAuth desejado não estiver listado no menu suspenso, selecione
Provedor OAuth personalizado / Provedor OpenID personalizado E continue.
Insira o nome do provedor OAuth no Nome do aplicativo personalizado campo de texto. Copie o URL de retorno/redirecionamento e mantenha-o à mão. Isso será necessário ao configurar o Provedor OAuth.
Se o seu provedor suporta apenas URLs de retorno/redirecionamento HTTPS e você tem um site HTTP, certifique-se de verificar o Aplicar URL de retorno de chamada HTTPS caixa de seleção no Configurações
aba.
Integrando Drupal com Provedor de Identidade
Configure a URL de retorno/redirecionamento no seu IdP e conclua as etapas seguintes.
Adicione os detalhes abaixo no site do Drupal (você receberá todos eles do provedor OAuth).
ID do cliente
Identificador exclusivo para o aplicativo cliente OAuth 2.
Segredo do cliente
Informações confidenciais usadas para autenticar o cliente.
Objetivo
A extensão do acesso que o cliente está solicitando do usuário e do servidor de autorização.
Autorizar ponto final:
URL onde o usuário é autenticado e concede permissões ao cliente.
Ponto final do token de acesso:
URL onde o cliente troca o código de autorização por um token de acesso.
Obter informações do usuário Endpoint:
URL opcional para recuperar informações do usuário
A caixa de seleção "Enviar ID do Cliente e Segredo no Cabeçalho ou Corpo" permite especificar se o ID do Cliente e o Segredo devem ser incluídos no cabeçalho ou no corpo da Solicitação de Endpoint de Token. Se não tiver certeza de qual opção selecionar, você pode usar as configurações padrão.
Clique na caixa de seleção para Habilitar login com OAuth, role para baixo e clique em Salvar configuração
botão.
Integrando o Drupal com o Identity Provider:
Configure a URL de retorno/redirecionamento no seu IdP e conclua as etapas seguintes.
Adicione os detalhes abaixo no site do Drupal (você receberá todos eles do provedor OAuth).
ID do cliente
Identificador exclusivo para o aplicativo cliente OAuth 2.
Segredo do cliente
Informações confidenciais usadas para autenticar o cliente.
Objetivo
A extensão do acesso que o cliente está solicitando do usuário e do servidor de autorização.
Autorizar ponto final:
URL onde o usuário é autenticado e concede permissões ao cliente.
Ponto final do token de acesso:
URL onde o cliente troca o código de autorização por um token de acesso.
Obter informações do usuário Endpoint:
URL opcional para recuperar informações do usuário
O processo de Enviar ID do cliente e segredo em A caixa de seleção "Client ID" permite especificar se o ID do Cliente e o Segredo devem ser incluídos no cabeçalho ou no corpo da Solicitação de Endpoint de Token. Se não tiver certeza de qual opção selecionar, você pode usar as configurações padrão.
Clique na caixa de seleção para Habilitar login com OAuth, role para baixo e clique em Salvar configuração botão.
Teste de conexão entre Drupal e provedor OAuth
Após salvar as configurações com sucesso, clique em Executar configuração de teste botão para testar a conexão entre o Drupal e o provedor OAuth.
Em um pop-up de Configuração de Teste, se você não tiver nenhuma sessão ativa no mesmo navegador, será solicitado que você faça login no Provedor OAuth. Após o login, você receberá uma lista de atributos recebidos do Provedor OAuth.
Selecione os Atributo de e-mail no menu suspenso no qual o ID de e-mail do usuário é obtido e clique em Pronto
botão.
Observação: O mapeamento do atributo de e-mail é obrigatório para executar o SSO, ou seja, fazer login no site Drupal com credenciais do provedor OAuth.
No Mapeamento de Atributos e Funções guia, selecione a Atributo de nome de usuário na lista suspensa e clique em Salvar configuração botão.
Agora, saia e acesse a página de login do seu site Drupal. Você encontrará automaticamente um link para Login com Provedor OAuth. Se quiser adicionar o link SSO a outras páginas, siga os passos mostrados na imagem abaixo:
Teste de conexão entre Drupal e provedor OAuth
Após salvar as configurações com sucesso, clique no botão Executar configuração de teste botão para testar a conexão entre o Drupal e o provedor OAuth.
Em um pop-up de Configuração de Teste, se você não tiver nenhuma sessão ativa no mesmo navegador, será solicitado que você faça login no Provedor OAuth. Após o login, você receberá uma lista de atributos recebidos do Provedor OAuth.
Clique no Configurar mapeamentos botão.
No Mapeamento de Atributos guia, selecione a Atributo de e-mail e Atributo de nome de usuário
na lista suspensa e clique em Salvar configuração botão.
Observação: O mapeamento do atributo de e-mail é obrigatório para executar o SSO, ou seja, fazer login no site Drupal com credenciais do provedor OAuth.
Agora, saia e acesse a página de login do seu site Drupal. Você encontrará automaticamente um link para Login com Provedor OAuth. Se quiser adicionar o link SSO a outras páginas, siga os passos mostrados na imagem abaixo:
Precisa de assistência?
Se você enfrentar algum problema durante a configuração ou se desejar alguns recursos adicionais, entre em contato conosco em drupalsupport@xecurify.com.
Recebendo o erro: 'Nome de usuário não recebido. Verifique sua configuração de Mapeamento de Atributos.' OU Recebendo o erro: 'E-mail não recebido. Verifique sua configuração de Mapeamento de Atributos.'
Depois de clicar em "Sair" no Drupal, ele me leva de volta à página inicial do Drupal. No entanto, quando tento fazer login com outro usuário, ele não me pede para fazer login, mas me conecta automaticamente com o mesmo usuário.
A funcionalidade de logout que você mencionou aqui é o comportamento padrão de um módulo. Ela desconecta você do Drupal, mas não do seu aplicativo/provedor. Para permitir que o módulo efetue logout da sua conta de provedor/aplicativo (o que você está procurando), você precisa fazer as configurações abaixo: [saiba mais]
Comprei o módulo pago do Drupal e o substituí pelo módulo gratuito, mas ainda não consigo usar os recursos pagos.
Como você atualizou para uma de nossas versões pagas do módulo Drupal e substituiu o módulo gratuito pelo pago, você precisa primeiro ativar o módulo pago. Consulte os passos abaixo.Saiba mais]
Obrigado pela sua resposta. Entraremos em contato em breve.
Algo deu errado. Envie sua consulta novamente.
Entraremos em contato com você o mais breve possível!
Obrigado pela sua resposta. Entraremos em contato em breve.
Algo deu errado. Envie sua consulta novamente.
Entraremos em contato com você o mais breve possível!
×
Olá!
Preciso de ajuda? Estamos bem aqui!
Entre em contato com o suporte miniOrange
Obrigado pela sua consulta.
Se você não receber uma resposta nossa dentro de 24 horas, sinta-se à vontade para enviar um e-mail de acompanhamento para info@xecurify.com