Integração de sincronização de usuário Joomla com Keycloak
Visão geral
Sincronização de usuário do Keycloak é um plugin fácil de usar para Joomla que facilita a sincronização de dados do usuário entre o Keycloak, uma plataforma de gerenciamento de identidade, e o Joomla. Este plugin usa o API de descanso do Keycloak para buscar todos os perfis de usuários do Keycloak para o banco de dados Joomla. Suporte integrado para recursos avançados de sincronização, como sincronização bidirecional de usuários, criação e exclusão automática de usuários, mapeamento de grupos e muito mais. Ele oferece uma maneira simples e segura de manter as informações dos usuários sincronizadas, permitindo que os administradores provisionem usuários e gerenciem seus dados com provisionamento manual, sob demanda ou baseado em agendamento.
Etapas para configurar a sincronização do usuário do Keycloak para Joomla
Etapa 1: instalar o plugin de provisionamento de usuário
- Baixe o arquivo zip para o plugin miniOrange User Provisioning/User Sync do link aqui .
- Efetue login no console do administrador do seu site Joomla.
- No Menu, clique em Sistema, então sob Instale seção clique em Extensões.
- Faça upload do arquivo zip baixado para instalar o Provisionamento de usuário/sincronização de usuário plugin.
- A instalação do plugin foi bem-sucedida. Agora clique em Iniciar! botão.
- Selecionar 'Capa de Chave' da lista de provedores.
Etapa 2: Configurar o Keycloak
- Vá para o seu Console Keycloak e selecione seu reino e clique em Utilizadores. Certifique-se de que seu Realm não tenha um espaço presente no nome.
- Acesse Utilizadores e clique no Adicionar usuário botão para criar novo usuário.
- Ao criar um novo usuário, insira os detalhes necessários e clique em Criar.
- Depois que um usuário for criado, vá para Guia Credenciais e clique em Definir senha botão para definir uma senha para o usuário.
- Digite a senha do usuário e clique em Economize.
Observação: Desabilitar Temporário tornará a senha do usuário permanente.
- Depois de definir a senha do usuário, vá para Mapeamento de Funções guia e atribuir ao usuário uma função de 'gerenciar-usuários' sob a 'gerenciamento de reino' funções do cliente.
- Filtrar as funções por Filtrar por clientes e pesquise por usuário, Selecione o gerenciamento de reino, gerenciar usuários função e clique em Atribuir botão.
Etapa 3: Criar um cliente
- Para criar um cliente clique em Clientes seção no painel esquerdo e clique em Criar cliente botão.
- Para criar o cliente, insira os detalhes necessários e clique no botão Seguinte botão.
Observação: O ID do cliente não deve ter espaços entre eles.
- Na próxima etapa, selecione apenas o Concessão de acesso direto digite e clique em Economize botão.
- Todas as configurações do Keycloak foram concluídas. Vamos acessar o plugin de sincronização do Joomla Keycloak e concluir a configuração.
Etapa 4: Configurar o plugin de sincronização de usuário Keycloak
- Vá para a aba Configurar Keycloak e insira o Domínio Keycloak, o ID do Cliente e o nome do seu Realm do aplicativo Keycloak que você criou acima.
- Para copiar o domínio Keycloak, vá para o seu Console Keycloak e copie o domínio.
- Digite o copiado Domínio Keycloak nome no Campo de domínio Keycloak presente na aba Configurar Keycloak.
- Para copiar o ID do cliente, passe o mouse sobre as configurações do Keycloak e copie o ID do cliente de lá, conforme mostrado abaixo.
- Copie o ID do cliente e cole-o no campo ID do cliente na guia Configurar Keycloak.
- Para copiar o nome do reino, vá até o painel do Keycloak e copie o nome do reino.
- Em seguida, cole-o no campo Realm na aba Configurar Keycloak.
- Digite o nome de usuário e a senha do usuário que você criou com a permissão de 'gerenciar-usuários'.
- Introduzir o Nome de Utilizador de qualquer usuário (com a permissão "manage-users") do seu aplicativo Keycloak. Isso será usado para configuração de teste.
- Introduzir o Nome de usuário de teste aqui e depois clique em Salvar configuração botão.
- Parabéns, você verificou com sucesso o Endereço de e-mail do usuário durante o registro.
Etapa 5: Testar configuração
- Para testar se a conexão foi bem-sucedida ou não, clique no Testar Conexão botão presente no Configurar Keycloak aba.
Etapa 6: sincronizar o usuário com o banco de dados Joomla
- Navegue até a guia Keycloak -> Joomla. Debaixo de Mapeamento de atributos do usuário seção mapeie o nome do atributo Keycloak para o respectivo nome do atributo Joomla e clique em Salvar configuração.
Sincronizar um usuário individual ou todos os usuários
- Entrar Nome/ID do Princípio do Usuário de qualquer usuário do seu aplicativo Keycloak.
- Clique no Criar Usuário botão para criar seu usuário Keycloak para o banco de dados do seu site Joomla.
- Ou clique no Criar todos os usuários botão para sincronizar todos os usuários do Keycloak com o banco de dados do seu site Joomla.Observação: Este é um recurso Premium.)
Sincronizar grupos de usuários (Recurso Premium)
- Sob o Sincronizar grupos de usuários, você pode mapear grupos de usuários do Keycloak para grupos de usuários do Joomla. Além disso, selecione o grupo padrão para os usuários novos/de login.
Definir intervalo de sincronização do usuário (Recurso Premium)
- Debaixo Definir intervalo de sincronização do usuário seção, configure uma programação para sincronização automática do usuário por hora, dia ou semana.
Etapa 7: Criar e Excluir Usuário
Criar e Excluir Usuário
- Navegue até a guia Joomla -> Keycloak. Aqui, sob o Criar um usuário individual seção, qualquer usuário criado no Joomla será sincronizado automaticamente e será criado no Keycloak.
- Sob o Deletar usuário seção, você pode excluir um usuário individual do Keycloak.
Provisionamento Automático (Recurso Premium)
- Sob o Provisionamento automático Na seção "Provisionamento automático", você pode automatizar o provisionamento sempre que um usuário for criado, excluído e atualizado. Você também pode ativar a sincronização automática da senha do usuário do Joomla.
Sincronizar atributos do usuário e definir intervalo (Recurso Premium)
- Sob o Atributo de usuário de sincronização guia, você pode mapear atributos de usuário do Joomla para o Keycloak.
- Você também pode configurar uma programação para sincronização automática do usuário, em Definir intervalo de sincronização do usuário aba.
Você configurou com sucesso o Keycloak User Sync com o Joomla. Se estiver procurando por algo que não consegue encontrar, envie-nos um e-mail para joomlasupport@xecurify.com.
