> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.
# Gerenciando mapeamentos de atores
> Ligue IDs opacos de ator a um nome de exibição e/ou e-mail legíveis na interface do Matcher, depois pseudonimize ou exclua mapeamentos.
A página **Mapeamentos de atores** na interface do Matcher permite associar IDs opacos de ator a um nome de exibição e/ou e-mail legíveis. Com as permissões adequadas, você pode pseudonimizar ou excluir mapeamentos diretamente pela interface.
## Acessando a página Mapeamentos de atores
***
Vá em **Matcher > Configurações > Mapeamentos de atores** na barra lateral esquerda.
Para abrir esta página, você precisa de `actor-mappings-read`. O Matcher também admite administradores. Sem esse acesso, o Matcher redireciona você para a página principal do Matcher. Essas verificações se aplicam apenas quando a autenticação está ativa. Com `AUTH_PROVIDER=disabled`, o Matcher não aplica autenticação nem autorização. As operações de detalhe e edição podem então expor PII de mapeamento de ator a qualquer um que alcançar o deployment.
## Navegando pelos mapeamentos de atores
***
A página usa paginação por cursor e solicita até 25 mapeamentos por página da interface:
| Coluna | Descrição |
| -------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **ID do ator** | O identificador opaco mantido pelo Matcher |
| **Criado** | Data e hora em que o mapeamento foi criado |
| **Atualizado** | Data e hora da última atualização |
| **Ações** | Aparece apenas quando você pode editar, pseudonimizar ou excluir; contém apenas os botões que você está autorizado a usar |
Digite no campo **Prefixo do ID do ator** para filtrar a tabela ao vivo. Não há um botão de busca separado. Use os botões **Anterior** / **Próxima** abaixo da tabela para se mover entre as páginas disponíveis.
Nome de exibição e e-mail não aparecem na tabela. PII criptografada apenas é carregada quando você abre as operações de detalhe de um mapeamento, como a edição.
## Permissões
***
`actor-mappings-read` é o pré-requisito para abrir a página. Depois que você tiver esse acesso, o controle do cabeçalho e as ações de linha são controlados por permissão de forma independente:
* **Novo mapeamento** exige `actor-mappings-write`.
* **Editar** exige `actor-mappings-write` e `actor-mappings-deanonymize` juntas, porque a folha de edição carrega PII descriptografada pela operação de detalhe.
* **Pseudonimizar** exige `actor-mappings-pseudonymize`.
* **Excluir** exige `actor-mappings-delete`.
Se você não tiver nenhuma das permissões de ação de linha, a coluna **Ações** não aparece. Os botões individuais para permissões que faltam a você ficam ocultos.
## Criando um mapeamento de ator
***
Clique no botão **Novo mapeamento** no cabeçalho da página. A folha **Novo mapeamento de ator** abre com os seguintes campos:
| Campo | Descrição |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **ID do ator** | O identificador opaco (por exemplo, `user:550e8400-e29b-41d4-a716-446655440000`). O tamanho máximo dele é 255; valores maiores são rejeitados. Espaços em branco no início e no fim são cortados automaticamente. Não pode ser alterado depois da criação. |
| **Nome de exibição** | O nome legível (por exemplo, "John Doe"). Opcional, mas você deve informar um Nome de exibição, um E-mail, ou os dois. |
| **E-mail** | O endereço de e-mail (por exemplo, "[john.doe@example.com](mailto:john.doe@example.com)"). Opcional, mas você deve informar um Nome de exibição, um E-mail, ou os dois. Se informado, deve ser um endereço de e-mail válido. |
Clique em **Salvar**.
## Editando um mapeamento de ator
***
Clique em **Editar** na linha de um mapeamento. A folha **Editar mapeamento de ator** abre com os valores atuais preenchidos. O campo ID do ator permanece bloqueado. Você não pode alterar o ID do ator depois da criação. Você pode modificar apenas o nome de exibição e o e-mail.
Deixar em branco um campo existente de **Nome de exibição** ou **E-mail** não o limpa: a interface omite valores em branco e a atualização preserva os valores armazenados omitidos. O formulário também não permite salvar quando os dois campos estão em branco.
Clique em **Salvar** para aplicar as mudanças.
## Pseudonimizando um mapeamento de ator
***
Clique em **Pseudonimizar** na linha de um mapeamento. A caixa de diálogo de confirmação **Pseudonimizar mapeamento de ator?** avisa que a ação muda o comportamento de desanonimização de auditoria.
Essa operação substitui o nome de exibição e o e-mail por `[REDACTED]`, preservando o vínculo com o ID do ator. A interface não tem uma ação dedicada de desfazer, e ela não restaura os valores originais automaticamente. Um usuário com permissão de escrita e de desanonimização pode depois editar o mapeamento e informar manualmente valores substitutos.
Clique em **Pseudonimizar** para prosseguir.
## Excluindo um mapeamento de ator
***
Clique em **Excluir** na linha de um mapeamento. A caixa de diálogo de confirmação **Excluir mapeamento de ator?** avisa que a ação muda o comportamento de desanonimização de auditoria.
Clique em **Excluir** para prosseguir.
Excluir remove em definitivo o vínculo entre o ID opaco do ator e o nome de exibição e e-mail armazenados dele. Avalie separadamente qualquer obrigação legal ou de retenção no seu deployment.