> ## 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.
# Gestión de mapeos de actores
> Vincula IDs de actor opacos con un nombre visible legible y/o un correo electrónico en la interfaz de Matcher, y luego seudonimiza o elimina los mapeos.
La página **Actor mappings** en la interfaz de Matcher permite asociar IDs de actor opacos con un nombre visible legible y/o un correo electrónico. Con los permisos adecuados, puedes seudonimizar o eliminar mapeos directamente desde la interfaz.
## Cómo acceder a la página Actor mappings
***
Navega a **Matcher > Settings > Actor Mappings** en la barra lateral izquierda.
Para abrir esta página, necesitas `actor-mappings-read`. Matcher también admite a los administradores. Sin este acceso, Matcher te redirige a la página principal de Matcher. Estas verificaciones se aplican solo cuando la autenticación está activa. Con `AUTH_PROVIDER=disabled`, Matcher no aplica autenticación ni autorización. Las operaciones de detalle y edición pueden entonces exponer PII de mapeo de actor a cualquiera que pueda alcanzar el despliegue.
## Cómo explorar los mapeos de actores
***
La página usa paginación por cursor y solicita hasta 25 mapeos por página de la interfaz:
| Columna | Descripción |
| ------------ | ----------------------------------------------------------------------------------------------------------------- |
| **Actor ID** | El identificador opaco que mantiene Matcher |
| **Created** | Fecha y hora en que se creó el mapeo |
| **Updated** | Fecha y hora de la última actualización |
| **Actions** | Aparece solo cuando puedes editar, seudonimizar o eliminar; contiene solo los botones que estás autorizado a usar |
Escribe en el campo **Actor ID prefix** para filtrar la tabla en vivo. No hay un botón de búsqueda separado. Usa los botones **Previous** / **Next** debajo de la tabla para moverte entre las páginas disponibles.
El nombre visible y el correo electrónico no aparecen en la tabla. La PII cifrada se carga solo cuando abres las operaciones de detalle de un mapeo, como la edición.
## Permisos
***
`actor-mappings-read` es el prerrequisito para abrir la página. Una vez que tienes ese acceso, el control del encabezado y las acciones de fila están sujetos a permisos de forma independiente:
* **New mapping** requiere `actor-mappings-write`.
* **Edit** requiere tanto `actor-mappings-write` como `actor-mappings-deanonymize`, porque el panel de edición carga PII descifrada a través de la operación de detalle.
* **Pseudonymize** requiere `actor-mappings-pseudonymize`.
* **Delete** requiere `actor-mappings-delete`.
Si no tienes ninguno de los permisos de acción de fila, la columna **Actions** no aparece. Los botones individuales para los permisos que te faltan están ocultos.
## Cómo crear un mapeo de actor
***
Haz clic en el botón **New mapping** en el encabezado de la página. El panel **New actor mapping** se abre con los siguientes campos:
| Campo | Descripción |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Actor ID** | El identificador opaco (por ejemplo, `user:550e8400-e29b-41d4-a716-446655440000`). Su longitud máxima es 255; los valores más largos se rechazan. Los espacios en blanco al inicio y al final se recortan automáticamente. No se puede cambiar después de la creación. |
| **Display name** | El nombre legible (por ejemplo, "John Doe"). Opcional, pero debes proporcionar un Display name, un Email, o ambos. |
| **Email** | La dirección de correo electrónico (por ejemplo, "[john.doe@example.com](mailto:john.doe@example.com)"). Opcional, pero debes proporcionar un Display name, un Email, o ambos. Si se proporciona, debe ser una dirección de correo electrónico válida. |
Haz clic en **Save**.
## Cómo editar un mapeo de actor
***
Haz clic en **Edit** en una fila de mapeo. El panel **Edit actor mapping** se abre con los valores actuales prellenados. El campo Actor ID permanece bloqueado. No puedes cambiar el ID de actor después de la creación. Solo puedes modificar el nombre visible y el correo electrónico.
Dejar en blanco un campo **Display name** o **Email** existente no lo borra: la interfaz omite los valores en blanco y la actualización conserva los valores almacenados omitidos. El formulario tampoco permite guardar cuando ambos campos están en blanco.
Haz clic en **Save** para aplicar los cambios.
## Cómo seudonimizar un mapeo de actor
***
Haz clic en **Pseudonymize** en una fila de mapeo. El diálogo de confirmación **Pseudonymize actor mapping?** advierte que la acción cambia el comportamiento de desanonimización de auditoría.
Esta operación reemplaza el nombre visible y el correo electrónico con `[REDACTED]`, y conserva el vínculo del ID de actor. La interfaz no tiene una acción de deshacer dedicada, y no restaura los valores originales automáticamente. Un usuario con permiso de escritura y de desanonimización puede editar el mapeo más tarde e ingresar manualmente los valores de reemplazo.
Haz clic en **Pseudonymize** para continuar.
## Cómo eliminar un mapeo de actor
***
Haz clic en **Delete** en una fila de mapeo. El diálogo de confirmación **Delete actor mapping?** advierte que la acción cambia el comportamiento de desanonimización de auditoría.
Haz clic en **Delete** para continuar.
La eliminación quita de forma permanente el mapeo entre el ID de actor opaco y su nombre visible y correo electrónico almacenados. Evalúa por separado cualquier obligación legal o de retención en tu despliegue.