Pular para o conteúdo principal
Centro de Apoio

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.

Ative o uso de clients na sua loja

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 Geral.

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

Copie a chave secreta.

Copie a sua secret key

Aplique essa chave secreta na loja “X”, na área Geral, no formulário Multipass.

Aplique a chave secreta

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 Geral e copie o multipass token que está disponível.

Copie a sua secret key

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-GCM, com o hash SHA-256 da chave secreta como chave de encriptação. Os dados devem ser um objeto JSON com o email do cliente e um campo created_at com o horário atual no formato ISO 8601 (por exemplo, 2026-11-10T12:00:00Z). Opcionalmente, adicione um campo redirect com a página para onde redirecionar o seu cliente após autenticação.

O token final é a codificação Base64 segura para URLs (URL-safe) do IV de 12 bytes, seguido dos dados encriptados e da tag de autenticação de 16 bytes.

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 'openssl'
require 'base64'
require 'json'
require 'time'

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
# created_at é obrigatório: o token expira 1 hora após este horário
payload = {
  email: '<email do cliente>',
  redirect: 'https://<a sua loja>/<o seu produto>',
  created_at: Time.now.utc.iso8601
}

cipher = OpenSSL::Cipher.new('aes-256-gcm')
cipher.encrypt
cipher.key = key
iv = cipher.random_iv # 12 bytes

# encripte os dados
ciphertext = cipher.update(payload.to_json) + cipher.final
tag = cipher.auth_tag # 16 bytes

# codifique o token para ser usado no URL
token = Base64.urlsafe_encode64(iv + ciphertext + tag)

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

Redirecione o seu usuário para o link criado.

Os tokens só são válidos por 1 hora a partir do horário indicado em created_at, então gere um novo token sempre que redirecionar um usuário em vez de reutilizar um token antigo. Certifique-se de que o relógio do servidor que gera os tokens está correto, caso contrário os tokens serão rejeitados.

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

Comece a sua jornada com a gente!

Comece seu teste grátis de 7 dias. Sem necessidade de cartão de crédito.