Como configurar o Single Sign-On (SSO) no Shopify com o Keycloak como IDP (SAML)?
O miniOrange permite que o Keycloak (SAML) atue como um Provedor de Identidade (IdP), possibilitando que os usuários façam login facilmente com autenticação única (SSO) robusta no Shopify usando as credenciais do Keycloak . Você pode conectar seu próprio provedor de identidade às contas de clientes, tornando a integração simples e confiável. Funciona tanto com contas de clientes do Shopify quanto com sistemas legados, é compatível com lojas Shopify Plus e não Plus e foi desenvolvido especialmente para lojas B2B com necessidades de login B2B no Shopify . Nosso aplicativo é compatível com todos os provedores de identidade (IdPs) SAML, OAuth e OpenID.
A seguir, apresentamos um guia passo a passo para configurar o Single Sign-On (SSO) no Shopify usando o Keycloak como Provedor de Identidade (IdP) e sua loja Shopify como Provedor de Serviços (SP), abrangendo configurações para contas de clientes e contas legadas, Shopify Plus ou não-Plus.
Configurar [OAuth] SSO no Shopify usando Keycloak como IdP
Para configurar o Single Sign-On (SSO) com o Shopify através do protocolo OAuth usando o Keycloak como provedor de identidade (IdP), siga os passos descritos aqui.
Pré-requisitos: Instalação do aplicativo
- Faça login no seu Administrador do Shopify.
- Acesse Apps → Loja de aplicativos do Shopify
- Procurar por miniOrange Single Sign-On - SSO
- Clique Instale para adicionar o aplicativo à sua loja
- Abra o aplicativo em Apps Para iniciar o SSO do Keycloak na configuração do Shopify
Guia passo a passo para configurar o Keycloak como IdP (OAuth) para SSO no Shopify.
Etapa 1: Configurar o Shopify como SP no Keycloak
- Efetue login no painel de administração do Keycloak.
- Clique em Clientes no menu à esquerda e clique em Criar botão para criar um novo cliente/aplicativo.
- Para o acima Configuração SAML, você precisa obter o ID da entidade e URL do ACS do Shopify.
- Agora vá para o seu Loja Shopify, navegue para o App seção e clique em Login único - login SSO aplicação.
- Clique no Adicionar Provedor de Identidade botão para adicionar seu IDP.
- Selecionar SAML protocolo.
- Agora escolha Manto-chave da lista de deslocados internos.
- Clique no Obter metadados botão, conforme mostrado na tela abaixo, para obter os metadados do provedor de serviços.
- Navegue até a Metadados iniciados por SP seção e copie o URL do ACS e ID da entidade ou emissor.
- Insira os valores fornecidos pela Shopify da seguinte forma:
| ID do cliente | EntityID / Emissor |
| Ponto de extremidade SAML do cliente | URL do ACS |
- Insira os valores fornecidos pela Shopify da seguinte forma:
- Forneça os valores de configuração do Shopify aqui:
| Nome | Forneça o nome de sua escolha |
| Protocolo do cliente | SAML |
| Asserção de Sinal | On |
| Criptografar Asserção | Off |
| Assinatura do cliente necessária | Off |
| Formato de ID do nome | Nome de Utilizador |
| URIs de redirecionamento válidos | URL do ACS |
- Agora em Configuração de endpoint SAML de granulação fina Insira os valores da seguinte forma.
| URL de vinculação POST do serviço de consumidor de asserção | URL do ACS |
| URL de vinculação de redirecionamento do serviço de logout | URL de logout único |
- Clique no Economize botão.
- Para metadados do IDP, acesse Realms no painel esquerdo e clique em Metadados do Provedor de Identidade SAML 2.0.
Você concluiu a configuração do Keycloak.
Etapa 2: Configurar o Keycloak como IDP no Shopify
- Navegue de volta para o miniOrange Single Sign On-SSO aplicativo e clique no Adicionar Provedor de Identidade botão.
- Selecionar SAML protocolo.
- Na lista de IDPs, selecione Manto de chaves.
- Clique no Importar metadados IDP botão.
- Selecione o método de upload como Link de metadadosCole o link do arquivo XML copiado de Etapa 1 e clique em Import.
- Adicione o nome IDP apropriado e clique em Salve.
Você concluiu a configuração lateral do Shopify.
Etapa 3: testar as conexões
-
Após salvar a configuração do IDP, você será redirecionado para o
Testar Conexão degrau.
Execute o teste de conexão antes de mapear ou buscar atributos. O teste de conexão garante que sua configuração de IDP esteja correta. - Clique no Testar Conexão botão.
- Ao inserir credenciais válidas do Keycloak, você verá uma janela pop-up, conforme mostrado na imagem abaixo.
- Clique no Buscar Atributos botão para buscar o atributo IDP.
Etapa 4: Mapeamento de Atributos
- Clique no + Mapeamento de Atributos Botão para mapear atributos entre Shopify e Keycloak.
- Mapeie os atributos consultando a tabela abaixo:
| Nome do atributo no Shopify | Escolha o atributo na lista de atributos predefinidos |
| Tipo de Atributo | Atributo IDP |
| Valor do atributo | Selecione o valor do atributo que você obteve do seu IDP |
- Clique em Salve.
Etapa 5: habilitar e testar configurações de SSO
Selecione o tipo de loja Shopify:
- Loja Non-Plus
- Loja Plus
Você configurou com sucesso o SSO do Keycloak para sua loja Shopify, onde o Keycloak é o provedor de identidade (IdP) e sua loja Shopify é o provedor de serviços (SP). Essa configuração permite que os usuários façam login em sua loja Shopify usando suas credenciais do Keycloak, simplificando o processo de login e melhorando a segurança ao reduzir a necessidade de digitar senhas repetidamente.
Integrações e recursos suportados
Mais recursos ➔guia de solução de problemas
Segui os passos para configurar o SSO do Shopify com o Keycloak como IdP, onde posso verificar as configurações de SSO?
Acesse sua loja virtual da Shopify e verifique se o botão "Conta / Login" está visível na barra de navegação. Se estiver, pule para "Acesse sua loja virtual da Shopify". Caso contrário, acesse o Painel de Administração da Shopify, navegue até Configurações e selecione "Contas de Clientes". Ative a opção "Exibir link de login no cabeçalho da loja virtual e na finalização da compra".
Para contas de clientes Shopify antigas
Agora você deve ver o link "Conta / Login" na parte superior da loja. Clique nele. Selecione o widget de login SSO do Keycloak acima dos campos de e-mail e senha. Insira suas credenciais do Keycloak para fazer login na loja Shopify.
Para contas de clientes da Shopify
Clique no ícone de usuário no canto superior direito da sua loja Shopify. Você será redirecionado para a página de login do Keycloak. Faça login usando sua conta Keycloak e complete a verificação com o código OTP de 6 dígitos. Depois disso, você estará conectado à loja Shopify.
Para obter instruções detalhadas, siga os passos indicados aqui.
Como redirecionar clientes para uma página específica, como as coleções do Shopify, após o login via Keycloak SSO?
Após configurar o Keycloak SSO para Shopify, você pode redirecionar facilmente os clientes para uma página específica da sua loja após o login. Para isso, acesse o aplicativo Shopify Single Sign-On (SSO) e clique em "Mais ações". Em seguida, selecione "Configurações adicionais" para a conexão Keycloak que você configurou. Na guia "Configurações pós-login", insira o endpoint de redirecionamento desejado (por exemplo, /cart ou /collections). Certifique-se de não incluir a URL completa, apenas o caminho. Se necessário, você pode habilitar a opção para restringir o cadastro de usuários e salvar as configurações. Para obter instruções detalhadas, consulte este guia.
Como posso habilitar o redirecionamento automático para o Keycloak no aplicativo SSO da Shopify?
Para habilitar o redirecionamento automático para o Keycloak na sua loja Shopify, você precisa atualizar o aplicativo miniOrange Single Sign-On (SSO) para o Plano Enterprise. Acesse Aplicativos e selecione miniOrange Single Sign-On, SSO. Na seção Preços, clique em "Atualizar" no Plano Scale. Para usuários B2B, verifique a aba Funcionário. Após a atualização, acesse a aba Configurações Globais e habilite o Redirecionamento Automático para o Keycloak em Configurações de Acesso à Loja. Se um aviso for exibido, clique no link fornecido para habilitar a extensão de redirecionamento automático para o Keycloak. Depois de habilitar a extensão, salve suas configurações. Por fim, decida se deseja que o recurso se aplique a toda a loja ou apenas à página de login e clique em Salvar.
Perguntas Frequentes (FAQs)
Mais perguntas frequentes ➔
Posso sincronizar os detalhes do usuário do Keycloak com os dados do meu cliente no Shopify quando ele fizer login pela primeira vez?
Sim, você pode sincronizar os detalhes do usuário do Keycloak com os perfis de clientes do Shopify durante o primeiro login usando o aplicativo miniOrange SSO.
Veja como sincronizar os detalhes do usuário do Keycloak com o Shopify por meio do aplicativo SSO:
- Configurar o Keycloak como provedor de identidade: No aplicativo SSO, selecione o protocolo SAML e configure o Keycloak como IdP com seus metadados.
- Configurar mapeamento de atributos: Mapear atributos do Keycloak, como e-mail, nome, telefone, etc., para os campos correspondentes do cliente no Shopify.
- Habilitar atualizações de perfil no SSO: Nas configurações pós-login, habilite a opção para atualizar o perfil do cliente após o usuário realizar o SSO (Single Sign-On).
Isso garante que os dados dos clientes do Keycloak sejam sincronizados com o Shopify sem problemas.
Como faço para redirecionar todas as tentativas de login na minha loja Shopify diretamente para o Keycloak para autenticação?
Você pode redirecionar todas as tentativas de login para o Keycloak usando o recurso de redirecionamento automático para o IdP no aplicativo miniOrange SSO.
Veja como configurá-lo:
- Configurar o Keycloak como provedor de identidade: No aplicativo miniOrange SSO, configure o Keycloak como provedor de identidade (IdP) usando seus metadados SAML ou endpoints OAuth.
- Habilitar redirecionamento automático para IdP: Acesse as configurações globais e ative o recurso Redirecionamento automático para o IdP em Configurações de acesso à loja. Escolha se deseja ativar esse recurso em toda a loja ou apenas na página de login.
Isso garante uma experiência de login perfeita, onde todas as tentativas de login em sua loja Shopify são redirecionadas para o Keycloak.
É possível redirecionar usuários para páginas ou seções específicas da minha loja Shopify após o login SSO do Keycloak?
Sim, é possível redirecionar usuários para páginas ou seções específicas da minha loja Shopify após o login SSO do Keycloak.
Veja como configurar o redirecionamento de usuários para páginas específicas por meio de um aplicativo SSO:
- Configurar o Keycloak como provedor de identidade: No aplicativo SSO, selecione o protocolo SSO desejado e configure o Keycloak como IdP com seus metadados.
- Configurar o Shopify como Provedor de Serviços: Configure o Shopify como um provedor de serviços (SP) e importe os metadados do Keycloak IdP. Habilite o login SSO para os clientes, permitindo que eles façam login usando suas credenciais do Keycloak.
- Redirecionamento personalizado: Nas configurações pós-login, insira o endpoint para onde deseja redirecionar os usuários após o login. Por exemplo, /carrinho, /conta
Posso usar o Keycloak para permitir que os funcionários façam login em várias lojas Shopify com as mesmas credenciais?
Sim, você pode usar o Keycloak como provedor de identidade (IdP) para habilitar o Single Sign-On (SSO) em várias lojas Shopify.
Veja como configurar o SSO para permitir que os funcionários façam login em várias lojas Shopify:
- Instale o aplicativo Shopify SSO: Em cada loja Shopify, instale o aplicativo Shopify SSO a partir da loja de aplicativos.
- Configurar Keycloak como IdP: No Keycloak, crie um cliente com o protocolo SAML ou OIDC para cada loja Shopify.
- Configurar o aplicativo SSO no Shopify: Insira os detalhes do IdP do Keycloak (metadados SAML ou endpoints OIDC) no aplicativo SSO de cada loja.
- Use o mesmo reino e armazenamento de usuário no Keycloak: Garante que todos os funcionários usem as mesmas credenciais em todas as lojas.
Essa configuração garante que os funcionários possam acessar várias lojas Shopify sem problemas usando um único conjunto de credenciais do Keycloak, melhorando tanto a segurança quanto a conveniência do usuário.
Obrigado pela sua resposta. Entraremos em contato em breve.
Algo deu errado. Envie sua consulta novamente.
