> 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/pim-insights/permissions.md).

# Permisos

### Descripción general

Esta página describe los permisos y el modelo de acceso de este agente.\
El agente usa **acceso de solo lectura** a los datos de Privileged Identity Management (PIM), los registros de auditoría y la información de actividad de identidades a través de **Complementos de Security Copilot**.\
Está diseñado para analizar activaciones de PIM, comportamiento de acceso privilegiado y métricas de cumplimiento sin realizar cambios de configuración.

***

### Cómo funciona

El agente se conecta de forma segura a su entorno de Microsoft Entra a través de Security Copilot Plugins para recuperar datos de activación de PIM, registros de auditoría e información de inicio de sesión.\
Evalúa patrones de uso de roles, el cumplimiento de las directivas de activación y la detección de anomalías en la actividad privilegiada.\
Opcionalmente, el agente puede generar Azure Workbooks para la supervisión y visualización continuas de PIM.

Todas las interacciones siguen estos principios:

* **Acceso de solo lectura:** El agente no modifica ni asigna roles, no cambia la configuración de PIM ni altera los datos de auditoría.
* **Mínimo privilegio:** Solo se usan los permisos necesarios para leer los datos de PIM y de auditoría.
* **Transparencia:** Todo acceso a los datos es auditable en Microsoft Entra y cumple con los estándares de cumplimiento de Microsoft.

***

### Roles de Entra ID requeridos

Asigne los siguientes roles a la cuenta de administrador que instala y ejecuta el agente:

| Rol                                        | Descripción                                                                                  |
| ------------------------------------------ | -------------------------------------------------------------------------------------------- |
| **Administrador de roles con privilegios** | Proporciona visibilidad sobre las asignaciones de roles de PIM y el historial de activación. |
| **Lector de seguridad**                    | Concede acceso a información de seguridad y datos de riesgo de identidad.                    |
| **Lector de informes**                     | Permite el acceso a informes de uso y auditoría.                                             |
| **Lector global**                          | Habilita el acceso de solo lectura en todo el tenant de Entra ID para un análisis completo.  |

{% hint style="info" %}
Estos roles representan la configuración de privilegios mínimos recomendada. Ajústelos según las políticas de seguridad y cumplimiento de su organización.
{% endhint %}

***

### Transparencia del acceso a los datos

La siguiente tabla describe a qué datos puede acceder el agente y con qué propósito.

| Tipo de datos                                              | Nivel de acceso | Propósito                                                                                                       |
| ---------------------------------------------------------- | --------------- | --------------------------------------------------------------------------------------------------------------- |
| **Activaciones y asignaciones de roles de PIM**            | Solo lectura    | Para evaluar la frecuencia de activación, el uso de roles y el cumplimiento del principio de privilegio mínimo. |
| **Registros de auditoría**                                 | Solo lectura    | Para rastrear eventos de activación, la verificación de MFA y los flujos de aprobación.                         |
| **Registros de inicio de sesión y de riesgo de identidad** | Solo lectura    | Para identificar comportamiento anómalo de acceso privilegiado.                                                 |
| **Definiciones y directivas de roles**                     | Solo lectura    | Para evaluar la alineación de la configuración con los estándares internos de gobernanza.                       |

**Tratamiento de datos:**

* El agente **no** modificar, eliminar ni exportar datos fuera de los límites del inquilino.
* Todo acceso ocurre a través de **Complementos de Security Copilot** el uso de permisos delegados o a nivel de aplicación.
* Los eventos de acceso se registran en **los registros de auditoría de Microsoft Entra** para lograr visibilidad y trazabilidad.

***

### Configuración del agente

Al ejecutar el agente, puede configurar ajustes opcionales para refinar el análisis y la salida de informes.

| Ajuste                  | Ejemplo                        | Descripción                                                              |
| ----------------------- | ------------------------------ | ------------------------------------------------------------------------ |
| **Intervalo de tiempo** | `30` o `2025-01-01/2025-01-31` | Define el período para analizar los eventos de activación de PIM.        |
| **GenerateWorkbook**    | `verdadero`                    | Genera un archivo de Azure Workbook para la supervisión continua de PIM. |
| **Formato de salida**   | `resumen` o `detallado`        | Especifica el nivel de detalle del informe y las métricas incluidas.     |

#### Consultas de ejemplo

* `"Analizar las activaciones de PIM de los últimos 30 días"`
* `"Muéstrame el acceso de Administrador global de esta semana"`
* `"Genera un informe de cumplimiento de PIM para el último trimestre"`
* `"Detecta anomalías en el acceso privilegiado con Azure Workbook"`

***

### Generación de Azure Workbook

Cuando `GenerateWorkbook: true` se especifica, el agente produce un **archivo de configuración de Azure Workbook** que puede implementarse para la supervisión continua de PIM.

El libro de trabajo incluye paneles para:

* Tendencias de activación de PIM en tiempo real
* Intentos de activación fallidos
* Métricas de uso y frecuencia de roles
* Seguimiento del cumplimiento del motivo de activación
* Alertas de anomalías y visualización de riesgos

Implemente el libro de trabajo en Azure Portal en:\
**Monitor → Libros de trabajo → Importar → Cargar archivo de configuración**

***

### Requisitos de datos

Para garantizar resultados precisos y significativos, verifique que:

* **PIM se utiliza activamente** con activaciones de roles que se producen con regularidad.
* **Motivos de activación** se requieren en la directiva de PIM para el análisis de cumplimiento.
* Al menos **7–30 días de datos de activación** están disponibles.
* **MFA es obligatoria** para las activaciones de PIM.
* **Registro de auditoría** está habilitado en Microsoft Entra.
* **Registros de auditoría de Entra ID** se guardan en una instancia de Microsoft Sentinel
* Dicho **Microsoft Sentinel** debe estar integrada con **Microsoft Defender XDR** (anteriormente **Microsoft Security Center**) para operaciones de seguridad unificadas y análisis avanzados.

***

### Consideraciones de seguridad y cumplimiento

* Toda la comunicación a través de Security Copilot Plugins está cifrada mediante HTTPS y autenticada a través de los servicios de identidad de Microsoft.
* El agente se adhiere a los principios de **confianza cero** y **mínimo privilegio** principios.
* El acceso se puede revisar o revocar en cualquier momento mediante **las asignaciones de roles de Entra ID** o **la administración del consentimiento de aplicaciones**.

***

### Próximos pasos

* Confirme que la cuenta de administrador tenga asignados todos los roles requeridos.
* Ejecute el agente para analizar la actividad de activación de PIM y el estado de cumplimiento.
* Implemente el Azure Workbook opcional para la supervisión continua del acceso privilegiado.


---

# 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/pim-insights/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.
