> ## 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.
# Gerenciamento de mapeamentos de atores
> Associe IDs de atores opacos de JWT com nomes e e-mails legíveis para apoiar a pseudonimização e o direito ao esquecimento do GDPR.
A página **Actor Mappings** na Matcher UI permite associar IDs de atores opacos (da autenticação JWT) com informações legíveis como nome de exibição e e-mail. Isso suporta a conformidade com o GDPR ao permitir operações de pseudonimização e direito de exclusão diretamente pela interface.
## Acesso à página de Actor Mappings
***
Navegue até **Matcher > Settings > Actor Mappings** na barra lateral esquerda.
Um informativo expansível "What is an Actor Mapping?" está disponível no topo da página, explicando que um mapeamento de ator associa um ID de ator opaco com PII legível para suportar a conformidade com o GDPR.
## Busca de um mapeamento de ator
***
A página utiliza um padrão de busca primeiro. Insira um **Actor ID** no campo de busca e clique em **Search** para procurar um mapeamento.
* Se um mapeamento existir, um cartão de resultado aparece com os detalhes do ator.
* Se nenhum mapeamento for encontrado, a página oferece um botão **New Mapping** para que você possa registrar um novo imediatamente.
O campo de busca pode ser preenchido a partir de um parâmetro de URL (ex. ao navegar a partir dos registros de auditoria), permitindo links diretos para um mapeamento de ator específico.
## Cartão de resultado
***
Quando um mapeamento é encontrado, o cartão de resultado exibe:
| Campo | Descrição |
| ---------------- | ----------------------------------------------------- |
| **Actor ID** | O identificador opaco da autenticação JWT |
| **Display Name** | O nome legível, ou um travessão se não definido |
| **Email** | O endereço de e-mail, ou um travessão se não definido |
| **Created at** | Data e hora de criação do mapeamento |
| **Updated at** | Data e hora da última atualização |
Se o mapeamento foi pseudonimizado, um badge amarelo **Pseudonymized** aparece no cartão.
O cartão fornece três botões de ação: **Edit**, **Pseudonymize** e **Delete**.
## Criação de um mapeamento de ator
***
Clique no botão **New Mapping** no topo da página. Um painel deslizante abre com os seguintes campos:
| Campo | Descrição |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Actor ID** | O identificador opaco da autenticação JWT (ex. `user:550e8400-e29b-41d4-a716-446655440000`). Máximo de 255 caracteres — valores que excedem este limite são rejeitados com um erro `400 Bad Request`. Espaços em branco no início e no final são removidos automaticamente. Não pode ser alterado após a criação |
| **Display Name** | O nome legível (ex. "John Doe"). Opcional, mas pelo menos um entre Display Name ou Email é obrigatório |
| **Email** | O endereço de e-mail (ex. "[john.doe@example.com](mailto:john.doe@example.com)"). Opcional, mas pelo menos um entre Display Name ou Email é obrigatório |
Clique em **New Mapping** para salvar.
## Edição de um mapeamento de ator
***
Clique no botão **Edit** no cartão de resultado. O painel deslizante abre com os valores atuais preenchidos. O campo Actor ID está bloqueado — apenas o nome de exibição e o e-mail podem ser modificados.
Clique em **Update Mapping** para aplicar as alterações.
## Pseudonimização de um mapeamento de ator
***
Clique no botão **Pseudonymize** no cartão de resultado. Um diálogo de confirmação explica que esta ação substitui o nome de exibição e o e-mail por `[REDACTED]` enquanto preserva o vínculo do ID do ator. Esta operação não pode ser desfeita.
Confirme para prosseguir. Após a pseudonimização, o cartão de resultado mostra valores `[REDACTED]` e um badge amarelo **Pseudonymized**.
A pseudonimização suporta o Artigo 4(5) do GDPR ao tornar os dados pessoais não mais atribuíveis a um indivíduo específico sem informação adicional, mantendo o vínculo estrutural intacto para fins de reconciliação.
## Exclusão de um mapeamento de ator
***
Clique no botão **Delete** no cartão de resultado. Um diálogo de confirmação avisa que esta ação remove o mapeamento de ator em apoio a solicitações de direito de exclusão, sujeito às obrigações de retenção; a remoção física não é garantida quando a retenção é legalmente exigida.
Confirme para prosseguir. O estado de busca é limpo após a exclusão.
A exclusão suporta o Artigo 17 do GDPR (direito de exclusão) ao remover o mapeamento entre o ID de ator opaco e os dados pessoais quando não houver obrigações legais de retenção. Conforme o Artigo 17(3), identificadores ou registros de auditoria e retenção podem ser retidos quando exigidos por obrigações legais, para fins de arquivo ou para a formulação ou defesa de reclamações legais.