A extensão de Autenticação e Autorização OAuth 3 do Typo2.0 Single Sign-On (SSO) permite que seus usuários de Frontend e Backend (Administradores e Clientes) façam login facilmente no site Typo3 usando as credenciais do Keycloak. A extensão de Autenticação e Autorização OAuth 3 do Typo2 Single Sign-On (SSO) facilita o uso do OAuth3 para configurar o login do Keycloak no TypoXNUMX (Keycloak Single Sign-On).
A extensão Typo3 OAuth & OpenID Connect Single Sign-On (SSO) permite o login seguro no Typo3 usando qualquer provedor OAuth e OpenID Connect, como Azure AD, Azure B2C, Okta, Keycloak, Salesforce, etc. Recursos avançados de Single Sign-On (SSO), como mapeamento de atributos de perfil de usuário, mapeamento de funções e outros, também são suportados nesta extensão. Clique aqui para saber mais sobre os recursos premium da extensão Typo3 OAuth Single Sign-On (Cliente OAuth & OpenID Connect).
Neste guia, mostraremos como configurar o SSO entre o Typo3 e o Keycloak. Os usuários deverão conseguir fazer login no Typo3 através do Keycloak ao final deste guia.
Pré-requisitos: Download e instalação
Instalando o OAuth Client / extensão OpenID Connect no TYPO3
- Use o comando abaixo para instalar a extensão usando o composer:
composer req miniorange/miniorange_oidc
- Agora procure o "miniOrange OpenIDConnect" na seção Extensões instaladas e ative a extensão clicando no botão ativar.
- Após a instalação, clique na extensão recém-instalada "miniOrange OpenIDConnect" para TYPO3 SSO e faça login com suas credenciais miniOrange registradas.
- Após inserir o nome de usuário e a senha, você precisará da chave de licença para prosseguir, caso seja um cliente premium. (Você receberá essa chave da equipe miniOrange. Após inserir a chave de licença, você poderá ativá-la e prosseguir.)
- Se você não for um cliente premium, poderá fazer login facilmente enviando as credenciais do miniOrange.
- Após o login bem-sucedido, você poderá ver os detalhes relacionados à sua conta.
- Agora você está pronto para configurar seu IdP. Mas é importante integrar o frontend primeiro.
- Baixe o arquivo zip da extensão OAuth / OIDC do marketplace TYPO3
- Vá para o backend do TYPO3 e clique na seção Extensões no lado esquerdo da tela.
- Faça upload do arquivo zip, conforme representado na imagem abaixo.
- Agora procure o "miniOrange OpenIDConnect" na seção Extensões instaladas e ative a extensão clicando no botão ativar.
- Após a instalação, clique na extensão recém-instalada "miniOrange OpenIDConnect" para TYPO3 SSO e faça login com suas credenciais miniOrange registradas.
- Após inserir o nome de usuário e a senha, você precisará da chave de licença para prosseguir, caso seja um cliente premium. (Você receberá essa chave da equipe miniOrange. Após inserir a chave de licença, você poderá ativá-la e prosseguir.)
- Se você não for um cliente premium, poderá fazer login diretamente enviando as credenciais do miniOrange.
- Após o login bem-sucedido, você poderá ver os detalhes relacionados à sua conta.
- Agora você está pronto para configurar seu IdP. Mas é importante integrar o frontend primeiro.
Integrar extensão com TYPO3
- Clique no PÁGINAS na navegação esquerda.
- Em seguida, você precisa criar uma pasta para armazenar os usuários do frontend clicando com o botão direito do mouse Início página e selecione Nova subpágina.
- Selecionar Pasta digite no menu suspenso.
- Nomeie a pasta como Usuários do site e clique no Salve.
- Vá para a aba de comportamento e adicione Usuários do site na mesma.
- Se você vir um hífen vermelho na pasta criada, significa que a pasta não está habilitada. Você pode habilitá-la clicando com o botão direito do mouse na pasta e clicando em Permitir.
- Você precisa adicionar dois STANDARD páginas dentro do INICIO página. Se estiver usando o plugin Premium, você pode criar três páginas.
- Aqui consideraremos nomes de páginas como: FEOIDC, RESPOSTA, LOGOUT (O logout é opcional para clientes premium).
- Para criar uma barreira temporária, você pode usar móveis que já estão em sua casa. FEOIDC página, clique com o botão direito em Início página e então selecione Nova subpágina e selecione STANDARD digite no menu suspenso.
- Adicionar título da página como FEOIDC e clique Economize.
- Então clique novamente em Página FEOIDC e clique em Adicionar conteúdo. Vá em plugins e adicione Plugin FEOIDC e clique no Economize.
- Navegue até a aba de plugins e selecione o plugin FEOIDC.
- Adicionar usuários do site em Página de armazenamento de registros e salve as configurações.
- Você pode habilitar o FEOIDC página clicando com o botão direito e selecionando Permitir opção.
- Se você precisar fazer alterações no segmento de URL, que também será seu URL SSO inicial, clique com o botão direito na página FEOIDC, selecione editar e clique no botão "alternar URL" para definir a URL de acordo com sua preferência.
- Siga os mesmos passos para criar e configurar páginas Padrão de Resposta.
- Certifique-se de selecionar o Plugin de Resposta para a página de Resposta.
- Mantenha o FEOIDC e RESPOSTA URLs de página úteis, pois você precisará delas ao configurar a extensão OAuth/OpenID Connect.
Etapas para configurar o Keycloak OAuth e o OpenID Single Sign-On (SSO) Login no Typo3
1. Configure o Keycloak como provedor OAuth
Siga os passos abaixo para configurar o Keycloak como Provedor OAuth
Configurar Keycloak como provedor OAuth
- Primeiro de tudo, Baixar Keycloak e instalá-lo.
- Iniciar servidor: Inicie o servidor keycloak executando o arquivo _standalone.sh_
Diretório raiz de keycloak/bin/standalone.sh
- Adicionar Realm: Agora faça login no console de administração do Keycloak e navegue até o domínio desejado. Você pode adicionar um novo domínio selecionando Adicionar Reino opção.
- Criar Reino: Digite o nome do reino e clique em CRIAR para adicionar reino.
- Criar função: A função será usada pelos seus aplicativos para definir quais usuários serão autorizados a acessar o aplicativo. Clique no botão Setores e escolha Adicionar Tipo.
- Adicionar usuário: Precisamos adicionar usuários ao reino que poderão acessar os recursos do reino. Clique em Utilizadores e escolha Adicionar um novo usuário.
- Configuração do usuário: Depois que o usuário for criado, a seguinte ação precisa ser executada nele.
- Usuário do mapa: Precisamos mapear o usuário para uma função. Clique em Mapeamentos de funções e atribuir ao usuário a função desejada dentre as funções disponíveis e clicar em adicionar selecionado.
- Criar grupos: Clique no Grupos e escolha New para criar um novo grupo.
- Atribuir usuário ao grupo: Selecione o usuário que deseja adicionar ao grupo. Escolha a opção "Grupos" na aba, selecione o nome do grupo e clique em juntar.
- Criar cliente OpenID: Clique no Clientes e escolha cria para criar um novo cliente. Insira qualquer string aleatória como ID do cliente e mantenha-o à mão, pois você precisará dele na próxima etapa. Selecione o protocolo do cliente openeid-connect e selecione Economize.
- Entrar Alterar tipo de acesso: Após a criação do cliente, altere seu tipo de acesso para confidencial
- Insira URLs de redirecionamento válidas: Copiar URL de retorno (Digite de miniOrange Typo3 OAuth Single Sign On (SSO) plugin que você copiou na última etapa) na última etapa e clique em SALVE .
Exemplo -- https://oauth/callback
- Mapeador de Grupo Keycloak: Agora, para obter os detalhes do grupo, precisamos realizar o mapeamento do cliente com a associação ao grupo, caso contrário, os detalhes do grupo não serão obtidos. Então, na seleção do cliente Mapeadores e depois clique em cria. Selecione o tipo de mapeador Membro do grupo e insira o nome e o token claim-name, ou seja, o nome do atributo correspondente aos grupos que serão buscados e clique em Economize
Observação: -- Se o caminho completo estiver no grupo, o caminho será buscado, caso contrário, o nome do grupo será buscado.
- Obter segredo do cliente: Agora precisamos obter o segredo do cliente. Então selecione Clientes e selecione credenciais e copie seu segredo daqui.
Você configurou com sucesso o Keycloak como provedor OAuth para implementar o Single Sign-On (SSO) do Keycloak com o Typo3 para autenticação de usuários.
2. Configurando o Typo3 como cliente OAuth
3: Mapeamento de Atributos (Opcional). *Este é um recurso Premium.
- Você pode mapear atributos na aba Mapeamento de Atributos. Somente nome de usuário e e-mail podem ser mapeados na versão gratuita da extensão. No entanto, na versão premium da extensão, você pode mapear vários atributos provenientes do seu Provedor OAuth para os atributos presentes no seu site Typo3.
4: Mapeamento de grupo (opcional). *Este é um recurso Premium.
- Você pode especificar uma função padrão na extensão gratuita que será alocada a todos os usuários não administradores quando eles realizarem o SSO.
- Vá para a aba Mapeamento de grupo e navegue até a seção Mapeamento de grupo.
- Selecione a função padrão e clique no botão Salvar.
Configurando Manto-chave como Provedor OAuth e Typo3 como Cliente OAuth Usando nossa extensão Typo3 OAuth Client, você instalou com sucesso o Typo3 Keycloak Single Sign-On (SSO). Em poucos minutos, você poderá fornecer acesso seguro ao seu site Typo3 utilizando as credenciais de login do Keycloak, graças a esta solução.
Recursos adicionais
Se você procura algo que não consegue encontrar, envie um e-mail para info@xecurify.com.