Configurar autenticação de provedor de identidade externo no Drupal

O método de autenticação por provedor de identidade externo permite proteger e restringir o acesso às suas APIs REST do Drupal usando tokens de provedores terceirizados, como Google, Azure AD, Keycloak, Okta ou GitLab. Ao integrar-se ao seu provedor de identidade, este método garante que apenas usuários autenticados possam acessar suas APIs do Drupal. O token de acesso usado neste método é obtido exclusivamente de um provedor de identidade (IdP) externo. O módulo de autenticação de API do Drupal é compatível com as versões 8, 9, 10 e 11 do Drupal.

Etapas de configuração

1. Configure o método de autenticação do provedor de identidade externo:

• Nesta etapa, iremos configurar Provedor de identidade externo como uma autenticação de API. Para fazer isso, navegue até o Autenticação API guia do módulo (/admin/config/people/rest_api_authentication/auth_settings).
• Debaixo Configuração básica, habilite o Ativar autenticação alternancia.
• Introduzir o Nome da Aplicação e selecione Provedor de identidade externo do Método de autenticação seção.

• Desloque-se até o Configuração do Provedor de Identidade Externa seção na mesma aba.
• Introduzir o Ponto final de informações do usuário do seu Provedor de Identidade no campo fornecido, para que o módulo possa buscar detalhes do usuário usando o token fornecido.
• De acordo com o relatório Atributo de nome de usuário, insira a chave de atributo ou o nome do seu Provedor de Identidade que contém o nome de usuário enviado pelo provedor externo.
• Clique na Salvar configuração botão.

• Você configurou com sucesso o método Provedor de Identidade Externa.


Observação: utilize o cabeçalho exclusivo específico da aplicação ao autenticar a API.

Conceder permissões de função para criar usuários

• Se necessário, você pode permitir que funções não administrativas do Drupal criem usuários. Para isso, atribua a permissão "Administrar usuários" às funções desejadas na página Permissões (/admin/people/permissions) do seu site Drupal.

2. Exemplo:

• Para melhor compreensão, vamos dar um exemplo de adição de autenticação baseada em Provedor de Identidade Externo à API de criação de usuário no Drupal.


Observação: A API /entity/user do Drupal é usada para criar um novo usuário.



• Para criar um usuário no Drupal, envie uma solicitação POST junto com o token recebido do seu Provedor de Identidade.

Formato de solicitação HTML - Solicitação: POST /entidade/usuário?_format=json Cabeçalho: MÉTODO DE AUTENTICAÇÃO: application_id Token: Aceitar: application/json Tipo de conteúdo: application/json Corpo: { "nome": { "valor": " " }, "mail": { "valor": " " }, "pass": { "valor": " " }, "status": { "value": "1" } } Formato de solicitação CURL - curl --location --request POST ' /entidade/usuário?_format=json' \ --header 'MÉTODO DE AUTENTICAÇÃO: application_id' \ --header 'Token: ' \ --header 'Aceitar: application/json' \ --header 'Tipo de conteúdo: application/json' \ --data-raw ' { "nome": [ { "valor": "Nome de usuário" } ], "mail": [ { "valor": "email" } ], "senha": [ { "valor": "Senha" } ], "status": [ { "valor": "1" } ] }

• Você também pode consultar a imagem de solicitação do Postman mostrada abaixo.

• Uma resposta bem-sucedida retornará os detalhes do usuário que você criou (veja a imagem abaixo).

Parabéns! Você configurou com sucesso o método Provedor de Identidade Externo usando o módulo de Autenticação da API do Drupal.

Caso a configuração não tenha sido bem-sucedida, entre em contato conosco pelo endereço drupalsupport@xecurify.com . Inclua uma captura de tela da janela de erro e nós o ajudaremos a resolver o problema e o guiaremos durante a configuração.