Multipass Jumpseller

“Multipass - Involving, employing, or related to repeated passages through or over something; operating repeatedly in successive passes.” in oxford dictionary - lexico

A estratégia de autenticação de Multipass disponível com a sua loja Jumpseller permite-lhe conectar os clientes de suas aplicações com a sua loja Jumpseller, através de um sistema fácil de usar.

Usando a chave secreta que a Jumpseller fornece na sua área de administração, você pode encriptar os dados de clientes em outras aplicações e permitir-lhes uma conexão simples sem passos adicionais de autenticação que interfiram com a boa qualidade de experiência de uso dos seus usuários.

O Multipass na Jumpseller permite-lhe também a mesma funcionalidade entre duas lojas Jumpseller de forma cômoda e nativa, desde que identifique qual a chave secreta a usar.

Para usar a funcionalidade de Multipass na sua loja Jumpseller você precisa ter ativa uma de duas opções na seção de Clientes: Opcional ou Obrigatório.

1. Usando Multipass entre 2 lojas Jumpseller

Se apenas desejar direcionar e autenticar usuários de uma loja para outra, ou seja unidirecional, então só precisa fazer esta configuração em uma das lojas. Caso queira permitir a ambas as lojas a comunicação encriptada, ou seja bidirecional, então terá de realizar estes passos em ambas as lojas.

Se tem clientes registados na sua loja “X” e quer que esses clientes sejam capazes de acessar conteúdos apenas acessíveis a clientes registados na sua loja “Y” sem passarem pelo passo de registro, então pode usar o acesso Multipass.

Você precisará fornecer à sua loja “X” a chave secreta (secret key) que lhe permitirá encriptar os dados a compartilhar entre as duas lojas e permitir assim à loja alvo (loja “Y” neste caso) desencriptar os dados, registar o cliente e permitir ao mesmo o acesso ao conteúdo restrito. Sem a chave secreta adequada a autenticação falhará.

Para permitir à sua loja “X” a encriptação adequada dos dados do cliente você tem de estar logado na sua loja “Y” e ir a Definições > Geral.

Na caixa “Multipass” você pode encontrar a chave secreta usada para o Multipass.

Copie a chave secreta.

Aplique essa chave secreta na loja “X”, na área Definições > Geral, no formulário Multipass.

A partir daí você pode usar o Multipass no editor de código do tema da sua loja, através da variável multipass_token.

{% if multipass_token != blank %}
  <a href="https://asualoja/customer/multipass/{{ multipass_token }}">Link</a>
{% endif %}

A variável multipass_token só está funcional para usuários com sessão iniciada.

2. Usando Multipass entre uma aplicação/website exterior à Jumpseller e a loja Jumpseller

Talvez você tenha outro website ou uma aplicação na qual já tem usuários registados e gostaria de conectá-los à sua loja Jumpseller, registando-os com apenas um clique.

Por exemplo: O seu usuário “A” está logado no seu website e vê um link/botão para comprar um merchandise na sua loja Jumpseller que tem acesso restrito a usuários registados. Você poderá gerar um link com os dados do usuário encriptados em um token para que quando o usuário clicar nesse link ele seja redirecionado e registado sem passos adicionais necessários.

Então como pode ser isso implementado?

Busque a chave secreta na sua área de administração de loja Jumpseller. Vá a Definições > Geral e copie o multipass token que está disponível.

O multipass token será usado como chave secreta para a encriptação dos dados para o login em Multipass.

Encripte os dados usando AES 256-cbc. Você pode ver abaixo um exemplo da implementação em Ruby. Pode ver aqui documentação para o módulo de encriptação em NodeJS.

require 'base64'

key = OpenSSL::Digest.new('sha256').digest(secret_key)

# adicione o email do seu cliente e opcionalmente adicione a página de produto para onde redirecionar o seu cliente após autenticação
payload = { email: <email do cliente>, redirect: http://<a sua loja>/<o seu produto> }

cipher = OpenSSL::Cipher.new('aes-256-cbc')
cipher.encrypt
cipher.key = key

cipher.iv = iv = cipher.random_iv

# encripte os dados
ciphertext = iv + cipher.update(payload) + cipher.final

# codifique o token para ser usado no URL
Base64.urlsafe_encode64(ciphertext)

Uma vez obtido o token final, adicione-o ao link http://nomedaloja/customer/multipass/token.

Redirecione o seu usuário para o link criado.

Se o e-mail do usuário já estiver registado como cliente da sua loja ele será autenticado sem passos adicionais. Caso não esteja já registado, então será criada uma nova conta.

Após a autenticação o usuário será redirecionado para a homepage da sua loja Jumpseller ou, caso tenha preenchido o campo redirect nos dados a encriptar, para a página de produto especificada.

Se precisar de mais ajuda, escreva para o nosso suporte