> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/configuracao-superadmin/configuracoes/como-acessar-uma-tenant-usando-a-masterkey.md).

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

{% hint style="info" %}
**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**).
  {% endhint %}

{% hint style="warning" %}
**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.
{% endhint %}

{% embed url="<https://youtu.be/amIQEDcrnNY>" %}

***

## 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](https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2Fr2OJnZeOXNdn1WMGdUCo%2Fmasterkey-aba.png?alt=media)

{% hint style="danger" %}
**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.
{% endhint %}

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.

{% hint style="info" %}
**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.
{% endhint %}

***

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ajuda.zdg.com.br/configuracao-superadmin/configuracoes/como-acessar-uma-tenant-usando-a-masterkey.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.