Configurar a sincronização de usuários do Keycloak no Drupal

Visão geral

A integração do Keycloak User Provisioning com o Drupal simplifica o gerenciamento de usuários, mantendo as contas e informações de perfil sincronizadas entre seu site Drupal e o provedor de identidade Keycloak. Este guia de configuração completo ajudará você a configurar o provisionamento e a sincronização de usuários manual/automático do Drupal para o Keycloak. Provisionamento de usuários do Keycloak no Drupal Com este módulo, os administradores podem facilmente criar, atualizar ou excluir usuários usando métodos de provisionamento manual, sob demanda ou agendado. O módulo garante o gerenciamento seguro e eficiente dos dados do usuário em todas as plataformas e é totalmente compatível com Drupal 9, Drupal 10 e Drupal 11.

Passos da instalação

• Usando o Composer
• Usando Drush
• Instalação manual

• Baixe o módulo:

  composer require 'drupal/keycloak_user_provisioning'

• Acessar Estender menu no seu console de administração do Drupal e pesquise por Provisionamento de usuários do miniOrange Keycloak usando a caixa de pesquisa.
• Habilite o módulo marcando a caixa de seleção e clicando em Instale botão.
• Configure o módulo em

  {BaseURL}/admin/config/people/keycloak_user_provisioning/overview

• Instale o módulo:

  drush em keycloak_user_provisioning

• Limpe o cache:

   drush cr

• Configure o módulo em

  {BaseURL}/admin/config/people/keycloak_user_provisioning/overview

Observação: A instalação manual é suportada apenas até o Drupal 7. Para o Drupal 8 e versões superiores, você deve usar o Composer para instalação e gerenciamento de projetos.



• Acessar Estender menu no seu console de administração do Drupal e clique em Instalar novo módulo botão.
• Instale o Provisionamento de usuários do miniOrange Keycloak módulo, seja baixando o arquivo zip ou através do URL do pacote (tar/zip).
• Clique em Ativar módulos recém-adicionados.
• Habilite este módulo marcando a caixa de seleção e clicando em Instale botão.
• Configure o módulo em

  {BaseURL}/admin/config/people/keycloak_user_provisioning/overview

Etapas de configuração

1. Configurar o provisionamento baseado em API

• Após instalar o módulo no site Drupal, no menu Administração, navegue até Configuração → Pessoas → Provisionamento de usuários do miniOrange Keycloak.
• Dê uma olhada no que o módulo faz e clique em Vamos configurar o módulo botão.

2. Integrando o Drupal com o Keycloak

• Faça login com suas credenciais do Keycloak.
• No menu à esquerda, navegue até Clientes guia e clique no Criar cliente botão.

• Debaixo Criar cliente:
• Introduzir o ID do cliente e Descrição.
• Clique no Seguinte botão para prosseguir.

• Na próxima tela, habilite o Autenticação de cliente e Autorização botões de alternância.
• Marque as caixas de seleção para Fluxo Padrão e Subvenções de Acesso Direto.
• Clique no Seguinte botão e, em seguida, clique em Economize para concluir a instalação.

• Você será redirecionado para o Detalhes do cliente página. Sob o Configurações gerais seção, copie o ID do cliente e mantenha-o à mão.

• Agora, navegue até o Credenciais seção, copie o Segredo do clienteE mantenha-o à mão.

• Em seguida, vá para o Funções de contas de serviço guia e clique no Atribuir função -> Funções do cliente botão.

• Atribua as seguintes funções ao cliente criado.

• Em seguida, copie o Reino Nomeie a partir do menu à esquerda.

• Acesse o site do Drupal e insira o Domínio do Keycloak, ID do cliente, Segredo do cliente, Realm do Keycloak.
• Uma vez feito isso, clique em Salvar e testar configuração botão.

3. Configuração de teste

• Se a configuração de teste for bem-sucedida, você receberá uma lista de atributos do usuário do Keycloak.

• Alternativamente, se ocorrer um erro na integração do Keycloak com o Drupal, você pode verificar a causa do erro seguindo o link na mensagem de erro ou rolando para baixo até a seção Resultado da Configuração de Teste.

• Após o teste ser bem-sucedido, clique em Sincronização manual de teste botão.

• No campo de pesquisa, digite o nome de usuário do usuário do Drupal e clique em sincronização botão.

• Se o provisionamento for bem-sucedido, uma mensagem de status será exibida conforme mostrado abaixo.

• Para verificar se o usuário está provisionado ou não, navegue até o Utilizadores Acesse a guia e confirme o status do usuário.

• Provisionamento manual/sob demanda
• Provisionamento automático

No provisionamento manual/sob demanda, você pode sincronizar manualmente o usuário com o Keycloak. Ele também permite o provisionamento de um único usuário, bem como de todos os usuários existentes simultaneamente, para o Keycloak.

Configurar provisionamento manual/sob demanda

• Clique no configurar botão do Provisionamento manual/sob demanda seção.

• Na seção Configuração de provisionamento manual, marque a caixa de seleção de Criar usuário e clique no Economize botão.

• Após salvar, clique em Tudo feito botão. Em seguida, você pode sincronizar os usuários clicando no Sincronizar usuários manualmente botão.

Esse tipo de provisionamento permite sincronizar usuários com o Keycloak sempre que qualquer operação CRUD for realizada neles no Drupal.

Configurar Provisionamento Automático

• O Provisionamento Automático ajudará você a provisionar seus usuários usando qualquer um dos seguintes eventos:
• Interface administrativa: Quando administradores ou usuários privilegiados executam manualmente operações CRUD na conta de um usuário por meio da interface de administração do Drupal.
• Alteração de conta de usuário: Sempre que os próprios usuários realizam operações CRUD em seu próprio formulário de informações user/{user_id}/edit ou qualquer outro formulário personalizado.
• Módulos de terceiros: Sempre que uma entidade de usuário é atualizada/criada no site Drupal usando quaisquer módulos/aplicativos de terceiros ou código personalizado
• Cadastro de usuário: Sempre que um usuário cria uma nova conta no Drupal. (/user/register)

• Clique no configurar botão da seção Provisionamento Automático.

• Na seção Configuração de provisionamento automático, marque a caixa de seleção de Criar usuário e clique no Economize botão.

• Agora, você pode tentar criar um novo usuário no site do Drupal e verificar os logs navegando até Relatórios → Mensagens de log recentes e usando o provisionamento de usuário filtro.

Pronto!! Você provisionou os usuários com sucesso no Keycloak.

Se a Provisão não for bem-sucedida, entre em contato conosco em drupalsupport@xecurify.com. Por favor, envie uma captura de tela da janela de erro e nós o ajudaremos a resolver o problema e o guiaremos durante a configuração.

Recursos adicionais

• Provisionamento de usuários do Drupal
• Okta Sync