Como acessar uma tenant usando a Masterkey

Acesse o painel de qualquer usuário de uma tenant usando o e-mail dele e a Masterkey

A Masterkey permite que o Superadmin entre no Z-PRO como qualquer usuário já cadastrado, informando o e-mail desse usuário e a Masterkey no lugar da senha dele. É útil para dar suporte a um cliente, conferir uma configuração ou reproduzir um problema exatamente como o usuário vê, sem precisar pedir ou redefinir a senha dele.

Pré-requisitos:

• Acesso ao painel Superadmin da sua instalação do Z-PRO.

• O e-mail de um usuário já cadastrado na tenant que você quer acessar (consulte em Usuários por Tenant).

Atenção: a Masterkey é uma credencial de alto privilégio. Quem tiver a chave consegue entrar como qualquer usuário de qualquer tenant da instalação. Mantenha a Masterkey desativada quando não estiver em uso e nunca a compartilhe.

---

Etapa 1: Ative e configure a Masterkey

1. No painel Superadmin, acesse Configurações > Customizar.

2. Abra a aba Masterkey.

3. Ative a opção Habilitar Masterkey.

4. No campo Chave, digite uma senha forte ou clique em Gerar para criar uma automaticamente.

5. Clique em Salvar.

Aba Masterkey em Configurações > Customizar

Importante: a chave só passa a valer depois que você clica em Salvar. Se clicar em Gerar de novo e salvar, a chave anterior deixa de funcionar.

Guarde a chave em um gerenciador de senhas. Não a anote em locais públicos nem a envie por chat ou e-mail.

---

Etapa 2: Entre pela página da Masterkey

1. No navegador, abra o endereço do seu Z-PRO seguido de /masterkey. Exemplo: https://seudominio.com.br/masterkey

2. Preencha os campos:

   • E-mail: o e-mail do usuário que você quer acessar.

   • Senha: a Masterkey salva na etapa anterior.

3. Confirme o acesso.

Você entra no sistema logado como esse usuário, dentro da tenant dele, com as mesmas permissões e a mesma visão de tela que ele tem.

Dica: use o mesmo domínio que você usa para acessar o login do Z-PRO (o endereço do frontend), não o endereço do backend.

---

Etapa 3: Desative a Masterkey ao terminar

Quando concluir o atendimento, volte em Configurações > Customizar > Masterkey, desative Habilitar Masterkey e clique em Salvar. Se precisar manter a Masterkey ativa, gere uma nova chave periodicamente.

---

Boas práticas

• Acesse somente tenants e usuários para os quais você tem autorização (por exemplo, quando o próprio cliente pediu suporte).

• Não use a Masterkey como senha de nenhuma conta comum.

• Nunca envie a Masterkey por chat, e-mail ou outro canal sem proteção.

• Mantenha um registro interno de quando e por que a Masterkey foi usada.

---

Resumo das Funcionalidades

Funcionalidade	Onde acessar
Ativar, gerar ou trocar a Masterkey	Configurações > Customizar > Masterkey
Entrar como um usuário	https://seudominio.com.br/masterkey
Consultar o e-mail dos usuários de uma tenant	Usuários por Tenant

---

Encerramento

Com a Masterkey, o Superadmin consegue ver o sistema exatamente como o cliente vê e resolver o problema direto na conta dele. Use com responsabilidade e mantenha a chave desativada fora dos momentos de suporte.

---

Possíveis Erros e Soluções

Login recusado na página da Masterkey

Causa: a Masterkey está desativada, a chave não foi salva ou foi gerada uma chave nova depois da que você está usando.

Solução: confira em Configurações > Customizar > Masterkey se Habilitar Masterkey está ativo e se a chave do campo Chave é a mesma que você está digitando. Clique em Salvar e tente de novo.

E-mail não encontrado

Causa: não existe usuário com esse e-mail na instalação, ou há erro de digitação.

Solução: confirme o e-mail exato em Usuários por Tenant e copie de lá.

A página /masterkey não abre

Causa: o endereço foi digitado no domínio errado (por exemplo, no domínio do backend).

Solução: use o mesmo domínio da tela de login do Z-PRO e acrescente /masterkey ao final.