> For the complete documentation index, see [llms.txt](https://agents.glueckkanja.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://agents.glueckkanja.com/es/agents/insider-risk-profiler/permissions.md).

# Permisos

### Descripción general

Esta página describe el modelo de permisos y acceso para el **Perfilador de riesgos internos**.\
El agente usa **acceso de solo lectura** los datos de Microsoft Purview Insider Risk Management, Microsoft Defender y Microsoft Entra ID mediante documentación **API de Microsoft Graph** y **Complementos de Security Copilot**.\
Está diseñado para analizar alertas de riesgo interno, niveles de riesgo de usuario, cumplimiento de dispositivos y eventos de DLP **sin realizar ninguna modificación** en su entorno.

***

### Cómo funciona

El agente se conecta de forma segura a Microsoft Purview y Defender para recopilar **alertas de Insider Risk Management (IRM)**, señales de riesgo de identidad y telemetría conductual en múltiples orígenes de actividad, como correo electrónico, aplicaciones en la nube y operaciones de archivos.\
Enriquece las alertas con datos contextuales de Defender y Entra ID, calcula una puntuación de riesgo compuesta y genera una cola priorizada con recomendaciones para la investigación y la corrección.

Todas las operaciones siguen estos principios básicos:

* **Acceso de solo lectura:** El agente no modifica ni elimina ningún dato.
* **Mínimo privilegio:** Solo se solicitan los permisos mínimos necesarios para la correlación y el enriquecimiento.
* **Transparencia:** Todo el acceso se realiza a través de puntos de conexión documentados de Microsoft Graph y puede auditarse completamente mediante los registros de actividad de Microsoft Entra.

***

### Roles de Entra ID y Purview requeridos

Asigne los siguientes roles y permisos a la cuenta de administrador o identidad administrada que ejecuta el agente:

| Rol                                     | Descripción                                                                                                                       |
| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Analista de Insider Risk Management** | Proporciona acceso directo de solo lectura a las alertas de Insider Risk Management (IRM) dentro de Microsoft Purview.            |
| **Lector de seguridad**                 | Concede visibilidad de alertas de seguridad, incidentes y señales conductuales en Defender y Sentinel.                            |
| **Lector de directorio**                | Permite el acceso de solo lectura a los metadatos de usuarios y grupos de Entra ID para la correlación y elaboración de informes. |
| **Lector de Intune** *(opcional)*       | Proporciona contexto de cumplimiento de dispositivos al analizar alertas vinculadas a extremos administrados.                     |

Estos roles se adhieren al **principio de privilegio mínimo** y pueden limitarse a conjuntos de datos o grupos específicos según sea necesario.

***

### Transparencia del acceso a los datos

La siguiente tabla describe las fuentes de datos a las que accede el agente y sus propósitos:

| Tipo de datos                             | Nivel de acceso           | Propósito                                                                                                  |
| ----------------------------------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------- |
| alertas de Insider Risk Management        | Solo lectura              | Para recuperar metadatos de alertas y generar colas de riesgo priorizadas.                                 |
| alertas e incidentes de seguridad         | Solo lectura              | Para cruzar datos de Defender para el enriquecimiento contextual.                                          |
| usuarios de riesgo y eventos de identidad | Solo lectura              | Para evaluar indicadores de riesgo de identidad a nivel de usuario y la probabilidad de compromiso.        |
| telemetría de Advanced Hunting            | Solo lectura              | Para analizar eventos de archivos, correo electrónico, nube y autenticación para la puntuación conductual. |
| violaciones de directivas de DLP          | Solo lectura              | Para detectar anomalías en el tratamiento de datos sensibles y patrones de exfiltración.                   |
| estado y cumplimiento de dispositivos     | Solo lectura *(opcional)* | Para enriquecer los perfiles de riesgo de usuario con información del estado del dispositivo.              |
| datos de usuarios y grupos del directorio | Solo lectura              | Para normalizar identidades de usuario, correlacionar asignaciones y mejorar la claridad de los informes.  |

**Tratamiento de datos:**

* El agente nunca modifica, crea ni elimina registros.
* Todo el procesamiento y el enriquecimiento ocurren dentro del límite de su tenant de Microsoft 365.
* El acceso a los datos se realiza mediante Microsoft Graph y los complementos de Security Copilot con permisos delegados o de aplicación aprobados.
* Cada evento de acceso se registra y es trazable a través de los registros de auditoría de Microsoft Entra para fines de cumplimiento.

***

### Configuración del agente

El agente admite parámetros de configuración que controlan la profundidad del análisis, el ámbito de procesamiento y la estructura de salida:

| Ajuste                | Opciones                                                                                                                       | Descripción                                                                          |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
| **Ámbito**            | `alertas`, `usuarios`, `dispositivos`, `dlp`                                                                                   | Define qué componentes de Insider Risk se incluyen en el análisis.                   |
| **Modo**              | `rápido`, `estándar`, `profundo`                                                                                               | Determina la profundidad del enriquecimiento y la correlación.                       |
|                       | • **rápido** – Triaje básico de alertas usando factores clave de identidad y riesgo.                                           |                                                                                      |
|                       | • **estándar** – Enriquecimiento y puntuación equilibrados en datos de identidad, actividad y DLP. *(recomendado)*             |                                                                                      |
|                       | • **profundo** – Enriquecimiento completo de múltiples fuentes, incluido el estado del dispositivo y el análisis de anomalías. |                                                                                      |
| **Ventana de tiempo** | 7, 14, 30 días                                                                                                                 | Define hasta qué punto en el pasado se analizan las alertas y los eventos de riesgo. |

Asegúrese de que la identidad asignada o la cuenta de administrador tenga todos los roles requeridos y los permisos de las fuentes de datos antes de iniciar un análisis.

***

### Consideraciones de seguridad y cumplimiento

* Toda la comunicación entre el agente, Microsoft Graph y las API de Defender se protege mediante **HTTPS** y se autentica con **servicios de identidad de Microsoft**.
* El agente se adhiere a los principios de **Zero Trust** y **mínimo privilegio** principios de diseño.
* Los permisos pueden revisarse, restringirse o revocarse en cualquier momento a través de **asignaciones de roles de Microsoft Entra** o **la administración del consentimiento de aplicaciones**.
* No se escribe ni modifica ningún dato durante el análisis, lo que garantiza una seguridad operativa completa y la integridad del cumplimiento.

***

### Próximos pasos

1. Confirme que los roles requeridos (Insider Risk Management Analyst, Security Reader y Directory Reader) estén asignados a la cuenta o identidad que ejecuta el agente.
2. Verifique el acceso a los datos de Microsoft Purview y Defender mediante permisos de Microsoft Graph.
3. Revise las políticas de gobernanza de datos y asignación de roles de su organización antes de habilitar el agente en producción.


---

# 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://agents.glueckkanja.com/es/agents/insider-risk-profiler/permissions.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.
