Autenticação única (SSO) do Magento com a Apple | Autenticação única (SSO) no Magento usando a Apple

Visão geral

O SSO para Magento da Apple permite um login seguro e ágil no seu Magento, utilizando a Apple como provedora de OAuth e OpenID Connect. Com o login da Apple no Magento, os usuários podem acessar a loja usando suas credenciais da Apple. Isso significa que, com nossa extensão, os usuários da sua organização/diretório Apple podem fazer login na sua loja Magento usando suas credenciais da Apple. Nossa extensão de login da Apple para Magento oferece integração segura de Single Sign-On (SSO) com recursos avançados, como mapeamento de atributos, mapeamento de funções e controle de acesso. Ela aprimora a segurança do site, garantindo que apenas usuários verificados possam fazer login ou se registrar no seu site Magento. Com um processo de configuração simples do SSO para Magento da Apple, o plugin simplifica a autenticação de usuários e melhora o gerenciamento geral de acesso. Siga o guia abaixo para instalar e configurar o SSO para Magento da Apple sem esforço. Clique aqui para saber mais sobre os recursos extras da extensão de Single Sign-On OAuth (cliente OAuth e OpenID Connect) para Magento.

Passos da instalação

• Usando o Composer
• Instalação manual

• comprar o miniOrange Magento OAuth Single Sign-On (SSO) extensão do Magento Marketplace (Adobe Commerce Marketplace).
• Vá para Meu perfil -> Minhas compras
• Certifique-se de que está usando as chaves de acesso corretas (Meu Perfil - Chaves de Acesso)
• Cole as chaves de acesso no seu arquivo auth.json dentro do seu projeto
• Use o comando abaixo para adicionar a extensão ao seu projeto.

"compositor requer {nome_do_módulo}:{versão}"

• Você pode ver o nome do módulo e a lista de versões no seletor abaixo do nome do módulo de extensão.
• Execute os seguintes comandos no prompt de comando para habilitar a extensão.

php bin / magento setup: atualização

• Faça o download do miniOrange Magento OAuth Single Sign-On (SSO) extensão.
• Descompacte todo o conteúdo do zip dentro do diretório MiniOrange/OAuth.

{Diretório raiz do Magento} app código MiniLaranja OAuth

• Execute os seguintes comandos no prompt de comando para habilitar a extensão

php bin / magento setup: atualização

Etapas de configuração

1. Configure a extensão miniOrange SSO.

• Na extensão miniOrange Magento SSO, navegue até o guia Aplicativo, selecione OAuth/Openide clique em Apple aplicação.

• Copie o URL de retorno de chamada da extensão. Você precisará disso para Apple configuração.

2. Configurar a Apple como provedor OAuth para login SSO da Apple no Magento

• Primeiro de tudo, vá para https://developer.apple.com.
• Clique em de Corretora Faça login com sua conta de desenvolvedor da Apple.

• Clique em Certificados, Identificadores & Perfis aba.

• No menu à esquerda clique em Identificadores e depois disso clique em Mais íconeClique em Continuar pelas próximas 2 páginas.

• Entrar Descrição e ID do pacote para o ID do aplicativo. (O ID do pacote deve estar no formato de string DNS reverso.)

• De acordo com o relatório Capacidades seção role para baixo e selecione sinal com maçã e clique em Editar link.

• Selecionar Habilitar como ID de aplicativo principal e clique em Salve. Clique em Continuar e depois clique em Registo.

• No canto direito clique em Continuar e depois disso Registrar-se botão.
• Clique na + (mais) ícone novamente, selecione IDs de serviçoE clique em Continuar.

• Entrar Descrição e Identificar (O identificador seria o seu ID de cliente). E clique no Continuar e depois disso Registrar-se botão.

• Clique em As chaves guia no menu à esquerda. Clique em Ícone de mais Para registrar uma nova chave.

• Dê o seu Chave um nome e selecione Entrar com a Apple e clique em configurar botão.

• Escolha o seu ID primário e clique no Economize botão e depois, no canto direito, clique em Continuar e Registrar-se botão.

• Clique no Baixar botão assim que a chave for baixada clique no Pronto botão.

• No menu esquerdo clique em Identificadores e clique com o botão direito em IDs de aplicativos.

• Clique em IDs de serviço no menu suspenso.

• Escolha o seu ID do serviço da lista.

• Selecionar Entrar com a Apple e clique em configurar botão.

• Selecione os ID do aplicativo primário no menu suspenso e digite o Domínio e URL de redirecionamento em Domínios e Subdomínios e URLs de Retorno respectivamente e clique em Seguinte botão (Você obterá o nome de domínio e o URL de redirecionamento do plugin miniOrange).

• Verifique os detalhes e clique em Pronto botão. Depois disso, no canto direito, clique no Continuar botão.

• Copie o Valor do identificador e clique no Economize botão.

• Insira o valor do Identificador no ID do Cliente e copie o chave baixada valor no segredo do cliente do plugin miniOrange OAuth Client.

Gerando Chave Secreta

• Baixe o instalador Ruby no seguinte link https://rubyinstaller.org/downloads/ e depois instalá-lo.
• Procure por "Iniciar prompt de comando com Ruby", abra o prompt de comando do Ruby e instale a gem JWT executando o seguinte comando na linha de comando: gem install JWT.
• Copie o código abaixo para um arquivo e salve-o com a extensão .rb. Mantenha este arquivo .rb e o arquivo .p8 baixado na mesma pasta.
• Digite o nome do arquivo baixado example= "key.P8", key_id, client_id, team_id no código
• Abra o prompt de comando do Ruby e execute o código acima usando o seguinte comando ruby nomedoarquivo.rb

• requer 'jwt'key_file = 'chave.P8'
  
      id_da_equipe = ''
  
      id_do_cliente = ''
  key_id = ''
  ecdsa_key = OpenSSL::PKey::EC.new IO.read key_file
  cabeçalhos = {
  'criança' => id_da_chave
  }
  reivindicações = {
  'iss' => id_da_equipe,
  'iat' => Tempo.agora.para_i,
  'exp' => Tempo.agora.para_i + 86400*180,
  'aud' => 'https://appleid.apple.com',
  'sub' => id_do_cliente,
  }
  token = declarações JWT.encode, ecdsa_key, 'ES256', cabeçalhos
  coloca token

• Você receberá sua chave secreta. Copie-a.

Você configurou com sucesso a Apple como provedora OAuth para habilitar o Single Sign-On (SSO) da Apple com o Magento para autenticação de usuários.

3. Configurar o Magento como cliente OAuth

• Agora, entre no Nome do provedor OAuth, ID do cliente, Segredo do cliente, Objetivo e pontos finais fornecidos.
• Por favor, consulte o Pontos finais tabela fornecida abaixo para autorizar Autenticação única (SSO) com a Apple para seu site Magento.

• Clique no Economize para salvar as configurações.
• Clique no Configuração de Teste botão.

• Você verá todos os valores retornados pelo seu provedor OAuth para o Magento em uma tabela. Se você não vir os valores de Nome, Sobrenome, E-mail ou Nome de Usuário, faça as configurações necessárias no seu provedor OAuth para que essas informações sejam retornadas.

4. Configurações Multissite (*Disponível nas versões Enterprise)

• Encontre o aplicativo da Apple e clique. Editar no Menu Acções.

• Clique em Configuração da Loja do menu à esquerda.
• De acordo com o relatório Configuração da LojaSelecione o site onde deseja ativar o SSO e marque a opção Ativar SSO para este site.

 Configurações de login

• Exibir botão SSO na página de login: Exibe o botão SSO na página de login do cliente do site selecionado.
• Criar usuários automaticamente: Você tem a opção de criar usuários de clientes automaticamente durante o processo de SSO, caso eles ainda não existam. Marcar a caixa de seleção correspondente ativa esse recurso.
• Funcionalidade de redirecionamento automático: Redireciona automaticamente os usuários para a página de login do provedor OAuth, seja a partir da página de login do Magento ou de qualquer página do site.

• Acesse a página de login do cliente e você verá o botão SSO no seu frontend. Clique no botão e teste o SSO.

• Você será conectado com sucesso no Magento.

5. SSO de administrador

• Ativar SSO para administradores: Exibe o botão SSO na página de login do administrador.
• Texto do botão SSO de administrador: Define o rótulo exibido no botão SSO na página de login do administrador (por exemplo, "Entrar via Apple").
• Criar usuários administradores automaticamente: Cria automaticamente um usuário administrador no Magento quando ele faz login via SSO pela primeira vez.
• Redirecionamento automático a partir do painel de administração: Redireciona automaticamente os usuários administradores para a página de login do provedor OAuth a partir da página de login do administrador.
• URL de acesso alternativo: Um URL de acesso alternativo permite que você faça login no seu painel de administração usando as credenciais padrão de administrador caso seu acesso seja bloqueado.

• Acesse a página de login do administrador e você verá o botão SSO. Clique no botão para iniciar o SSO como administrador.

• Após efetuar o login com sucesso no Magento como administrador, você será redirecionado para o painel de controle administrativo do Magento.

6. Configurações de SSO sem interface gráfica (*Disponível nas versões premium)

• Habilitar para clientes: Esta opção permite ativar o SSO sem interface gráfica para clientes.
• URL de SSO do cliente: Este URL é usado para iniciar o SSO (Single Sign-On) do cliente a partir de aplicações headless. Adicione este URL de SSO à sua aplicação headless.
  • Formato de exemplo:
    https://<your-magento-domain>/mosso/actions/SendSSORequest?relayState={Store_URL}/headless_store_url/{Headless_URL}&app_name=Apple
  • {Store_URL}: Insira o URL da sua loja Magento.
  • {Headless_URL}: Insira a URL da sua aplicação headless para onde o token do cliente deve ser enviado.
  • Após o SSO bem-sucedido, um token do cliente é enviado para o URL headless.
    Por exemplo: {Headless_URL}?customer_token=...
• Token OAuth:Ative esta opção para enviar o token JWT do provedor OAuth (Apple) juntamente com o token do cliente.
• Validade do Token do Cliente: Você pode definir o tempo de expiração (em minutos) para o token do cliente.
• Lista de URLs permitidas para o frontend: Aqui, você pode adicionar URLs que estão autorizadas a receber o token do cliente. O token do cliente será enviado apenas para as URLs que estiverem na lista de permissões.

• Habilitar para administradores: Assim como para os clientes, essa opção ativa o SSO sem interface gráfica para administradores.
• URL de SSO do administrador: Este URL inicia o SSO administrativo a partir de aplicações sem interface gráfica.
• Validade do token de administrador: Defina o tempo de expiração (em minutos) para o token de administrador.
• Lista de URLs permitidas para o frontend: Os tokens de administrador são enviados apenas para os URLs da lista de permissões aqui. Você deve garantir que qualquer URL que receba um token de administrador esteja listado.

7. Atributo / Mapeamento Personalizado (Opcional). *Este é um recurso Premium.

 Mapeamento de atributos do cliente

• Vou ao Mapeamento de Atributos seção para configurar o Mapeamento de Atributos do Cliente.
• Permitir Mapeamento de atributos do cliente e selecione checkbox a opção de Atualizar atributos do cliente.

• Você verá campos como E-mail, Nome e Sobrenome Em Mapeamento de Atributos do Cliente.
• Mapeie esses campos selecionando as opções apropriadas no menu suspenso.
• Se precisar adicionar mais atributos, clique em + Adicionar atributos do cliente botão e selecione o atributo apropriado em suspensa.

 Mapeamento de endereços de clientes

• De acordo com o relatório Atributo do cliente Na seção, habilite o Mapeamento de Atributos de Endereço e selecione o checkbox para atualizar Atributos de endereço do cliente.

• Você verá campos como Rua e número, Código Postal, Cidade, Estadoe outros sob Mapeamento de endereços de clientes.
• Mapeie esses campos selecionando as opções apropriadas no menu suspenso.
• Se precisar adicionar atributos de endereço adicionais, clique em + Adicionar atributos de endereço Clique no botão e selecione o atributo apropriado no menu suspenso.

 Mapeamento de atributos administrativos

• De acordo com o relatório Mapeamento de atributos administrativos seção, habilitar Mapeamento de atributos administrativos e selecione o checkbox atualizar Atributo de administrador.

• Você verá campos como E-mail, Nome de Utilizador Nome e Sobrenome Em Mapeamento de Atributos Administrativos.
• Mapeie esses campos selecionando as opções apropriadas no menu suspenso.
• Se precisar adicionar mais atributos, clique em + Adicionar atributos de administrador botão e selecione o atributo apropriado em suspensa.

8. Mapeamento de Grupos/Funções (Opcional). *Este é um recurso Premium.

• O Magento utiliza o conceito de Funções (Role), projetado para dar ao proprietário do site a capacidade de controlar o que os usuários podem ou não fazer dentro do site. O mapeamento de funções ajuda você a atribuir funções específicas a usuários de um determinado grupo em seu provedor OAuth.
• Selecione no menu suspenso o atributo do seu provedor de identidade que contém informações de grupo/função para usuários administradores e clientes.

 Mapeamento de grupos de clientes

• Nas configurações de Mapeamento de Grupos de Clientes, o administrador da loja pode definir qual grupo de clientes do Magento deve ser atribuído com base nas informações do grupo recebidas do Provedor de Identidade (IdP) durante o Single Sign-On (SSO).
• Ative a caixa de seleção “Atualizar grupo do frontend no SSO” se desejar que o Magento atualize o grupo de clientes sempre que um usuário fizer login via SSO.
• Use o menu suspenso Grupo Padrão para selecionar os Grupos do Magento que devem ser atribuídos a um usuário quando nenhuma informação de grupo for retornada pelo Provedor de Identidade ou quando o grupo recebido não corresponder a nenhum mapeamento configurado.

• Insira os valores do grupo do provedor de identidade nos grupos de clientes Magento correspondentes, conforme necessário.
• Os usuários pertencentes a um grupo específico no provedor de identidade serão automaticamente atribuídos ao grupo Magento mapeado durante o SSO.
• Exemplo: Se o valor do grupo do Provedor de Identidade estiver mapeado para o grupo Geral no Magento, qualquer usuário com esse grupo no IdP será atribuído ao grupo de clientes Geral após o SSO.

 Mapeamento de funções administrativas

• Ative a caixa de seleção “Atualizar funções do backend no SSO” se desejar que o Magento atualize as funções de administrador sempre que um usuário fizer login via SSO.
• Use a lista suspensa Grupo Padrão para selecionar a função do Magento que deve ser atribuída a um usuário quando nenhuma informação de grupo for retornada pelo Provedor de Identidade ou quando o grupo recebido não corresponder a nenhum mapeamento configurado.

• Insira os valores do grupo do provedor de identidade nas funções de administrador do Magento correspondentes, conforme necessário.
• Os usuários pertencentes a um grupo específico no provedor de identidade serão automaticamente atribuídos ao grupo Magento mapeado durante o SSO.
• Exemplo: Se o valor do grupo do Provedor de Identidade estiver mapeado para o grupo Geral no Magento, qualquer usuário com esse grupo no IdP receberá as funções de Administrador Geral após o SSO.

Recursos adicionais

• Soluções de Segurança Magento
• O que é o login único (SSO)?
• Plugin Magento OAuth Single Sign On (SSO).

Contato

Entre em contato conosco pelo endereço magentosupport@xecurify.com e nossa equipe o ajudará a configurar a extensão SSO (OAuth/OIDC) do Magento 2. Nossa equipe o ajudará a selecionar a solução/plano mais adequado às suas necessidades.