Configurar autenticação básica no Drupal
A Autenticação Básica é um método de autenticação simples e direto. Nessa abordagem, o cliente envia solicitações HTTP com um cabeçalho de Autorização que contém o nome de usuário e a senha do site Drupal, codificados no formato Base64. Com a Autenticação Básica, o Autenticação de API do Drupal O módulo verifica as credenciais do usuário em relação ao nome de usuário e senha do Drupal. Somente se a autenticação for bem-sucedida, o usuário poderá realizar a operação solicitada. Este módulo é totalmente compatível com Drupal 8, Drupal 9, Drupal 10 e Drupal 11.
- Usando o Composer
- Usando Drush
- Instalação manual
Pré-requisitos:
- Interface de usuário REST: Este módulo fornece uma interface amigável para configurar o módulo REST.
- Habilite os seguintes módulos de serviços da Web a partir do Estender seção (/admin/modules) do seu site Drupal:
- JSON: API
- Interface de usuário REST
- Serviços da Web RESTful
- Serialização
Habilitar API e atribuir métodos:
- O primeiro passo é habilitar a API e atribuir os métodos e operações permitidos para ela. Isso pode ser feito usando o Interface de usuário REST módulo ou modificando diretamente a configuração do Drupal.
- Clique no Ativar API botão.
- Para habilitar a API usando o módulo REST UI, clique em configurar botão (como mostrado abaixo).
- No nosso exemplo, precisamos habilitar o /entidade/usuário API. Para fazer isso, clique na opção Habilitar ao lado dela.
- Como nosso objetivo é criar um usuário no Drupal, selecione as seguintes configurações:
- Método: POST
- Formato: JSON
- Provedor de autenticação: rest_api_autenticação
- Isso permite que o módulo de autenticação da API miniOrange autentique a API. Clique no botão Salvar configuração botão para continuar.
Etapas de configuração
1. Configure o método de autenticação básica:
- Nesta etapa, configuraremos a Autenticação Básica como método de autenticação da API. Para isso, navegue até a 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 clique no Salvar configuração botão.
- Desloque-se até o Método de autenticação seção na mesma aba e selecione Autenticação básica método.
- Você configurou com sucesso o método de Autenticação Básica.
Nota: Use o cabeçalho exclusivo específico do aplicativo 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 ver um exemplo de uso da Autenticação Básica para criar um usuário no Drupal com a API REST.
- Para criar um usuário no Drupal, você precisa fazer uma solicitação POST usando o nome de usuário e a senha do Drupal. O nome de usuário e a senha devem ser codificados no formato Base64. Consulte o exemplo abaixo para fazer a chamada.
Nota: A API /entity/user no Drupal é usada para criar um novo usuário.
Formato de solicitação HTML - Solicitação: POST /entity/user?_format=json Cabeçalho: AUTH-METHOD: application_id Aceitar: application/json Tipo de conteúdo: application/json Autorização: básica codificada em base64 Corpo: { "nome": { "valor": " " }, "mail": { "valor": " " }, "pass": { "valor": " " }, "status": { "value": "1" } } Formato de solicitação CURL - curl --location --request POST ' /entity/user?_format=json' \ --header 'AUTH-METHOD: application_id' \ --header 'Aceitar: application/json' \ --header 'Tipo de conteúdo: application/json' \ --header 'Autorização: codificado em base64 básico ' \ --data-raw ' { "nome": [ { "valor": "Nome de usuário" } ], "e-mail": [ { "valor": "e-mail" } ], "senha": [ { "valor": "Senha" } ], "status": [ { "valor": "1" } ] }
- 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 de Autenticação Básica 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 em [email protected]. Inclua uma captura de tela da janela de erro e nós o ajudaremos a resolver o problema e o guiaremos pela configuração.
