nopCommerce SAML Single Sign-On (SSO) com Keycloak como IDP

Visão geral

O plugin nopCommerce SAML Single Sign-On (SSO) permite habilitar o Single Sign-On (SSO) SAML para sua loja nopCommerce. Com o SSO, você pode usar apenas uma senha para acessar sua loja e seus serviços nopCommerce. Nosso plugin é compatível com todos os provedores de identidade compatíveis com SAML . Aqui, apresentaremos um guia passo a passo para configurar o SSO entre o nopCommerce e o Keycloak, considerando o Keycloak como provedor de identidade (IdP).

Pré-requisitos: Download e instalação

• Baixe o módulo de Single Sign-On (SSO) SAML do nopCommerce.
• Para instalar o plugin, faça login como administrador na sua loja nopCommerce. No painel de administração, navegue até Aba de configuração >> Plugins locais.

• Clique no Carregar plugin ou tema No botão no canto superior direito, na janela pop-up, clique em Escolher arquivo, selecione o arquivo ZIP do plugin baixado e clique em Carregar plugin ou tema para prosseguir.

• Após fazer o upload do plugin, clique em Reinicie o aplicativo para aplicar as alterações.Após a reinicialização do aplicativo, você verá o plugin listado abaixo. Clique nele. Instale botão para instalar e depois clique Reiniciar o aplicativo novamente para aplicar as alterações.

Etapas de configuração

Guia passo a passo para SSO SAML no nopCommerce usando o Keycloak como provedor de identidade.

• Após a instalação bem-sucedida, localize o plugin na lista e clique nele. configurar botão para prosseguir com a configuração.

1. Ative o plugin SAML usando a chave de licença.

• Ao clicar configurarVocê será redirecionado para a página de ativação da licença e receberá uma chave de licença de avaliação no seu e-mail cadastrado.
• Se você não recebeu a chave de licença no e-mail fornecido, use o seguinte: Baixar chave de licença botão no plugin para baixar o arquivo de licença.

• Para ativar o plugin, você pode:
  • Introduzir o chave de licença recebido por e-mail no campo de entrada fornecido.

  OR

  • Faça o upload do arquivo de licença que você baixou usando o botão mencionado acima.

• Em seguida, marque a caixa. "Li as condições acima e desejo ativar o middleware."E clique Ativar licença botão.

2. Fornecer metadados da loja nopCommerce ao provedor de identidade Keycloak.

• Após a ativação bem-sucedida da licença, o painel de controle do plugin será aberto conforme mostrado abaixo.
• No painel de controle do plugin, clique em Metadados do Provedor de Serviços Botão no menu superior. Isso abrirá a página de metadados do provedor de serviços.

Você pode obter os metadados do provedor de serviços SAML usando qualquer um dos dois métodos descritos abaixo para configurá-los em seu provedor de identidade.

A] Usando URL de metadados SAML ou arquivo de metadados

• Nesta página, você encontrará o URL dos metadados, bem como a opção para baixar o arquivo XML de metadados SAML.
• Copie o URL dos metadados ou faça o download do arquivo de metadados para configurá-los no seu provedor de identidade.
• Você pode consultar a captura de tela abaixo:

B] Carregar metadados manualmente

• Nesta página, você pode copiar manualmente os metadados do provedor de serviços, como: ID da entidade SP, URL do ACS, URL base e compartilhe-o com seu provedor de identidade para configuração.
• Você pode consultar a captura de tela abaixo:

• Em sua Keycloak Administrador console, selecione o reino que você deseja usar.
• Clique em Clientes no menu à esquerda e clique em Criar cliente botão para criar um novo cliente/aplicativo.

• Selecionar SAML as Tipo de cliente, Insira SP-EntityID / Emissor como o ID do cliente do Metadados do Provedor de Serviços guia, que você obterá de Etapa 2B, entrar Nome da sua aplicação e insira Descrição.

• Clique no Seguinte botão.
• Forneça os detalhes conforme mencionado abaixo:

URL raiz	Deixe em branco ou forneça URL base da guia Metadados do Provedor de Serviços
URIs de redirecionamento válidos	O URL do ACS (Serviço de Asserção ao Consumidor) na aba Metadados do Provedor de Serviços do plugin

• Clique em Economize botão.

• De acordo com o relatório Configurações guia sob Recursos SAML seção, configure o Keycloak fornecendo os detalhes necessários:

Forçar vinculação POST	OFF
Formato de ID do nome da força	OFF
Formato de ID do nome	E-mail

• De acordo com o relatório As chaves guia, desabilite o Assinatura do cliente necessária alternancia.

• Clique no Economize botão.
• In Avançado guia, sob Configuração de endpoint SAML de granulação fina, insira os seguintes detalhes:

URL de vinculação POST do serviço de consumidor de asserção	O URL do ACS (Serviço de Asserção ao Consumidor) na aba Metadados do Provedor de Serviços do plugin
URL de vinculação de redirecionamento do serviço de logout (Opcional)	O URL de logout único na aba Metadados do Provedor de Serviços do plugin

• Clique em Economize botão.