> 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/device-troubleshooter/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 Microsoft Intune y Microsoft Entra ID a través de la **API de Microsoft Graph**.\
Está diseñado para ayudar a solucionar problemas relacionados con dispositivos, como fallos de inscripción, errores de implementación de aplicaciones o inconsistencias de cumplimiento, sin modificar ninguna configuración.

***

### Cómo funciona

El agente se conecta de forma segura a su Tenant usando los puntos de conexión de la API de Microsoft Graph para recopilar datos de dispositivos de Intune, perfiles de configuración, asignaciones de directivas y registros de diagnóstico.\
Analiza esta información para identificar posibles causas de problemas de administración de dispositivos o de inscripción y proporciona recomendaciones para su corrección.

Todas las interacciones siguen estos principios:

* **Acceso de solo lectura:** El agente no modifica, crea ni elimina configuraciones o directivas de dispositivos.
* **Mínimo privilegio:** Solo se conceden los permisos necesarios para leer los datos de dispositivos de Intune.
* **Transparencia:** Todos los accesos a los datos se realizan a través de puntos de conexión documentados de la API de Microsoft Graph y pueden auditarse dentro de Microsoft Entra.

***

### Roles de Entra ID requeridos

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

| Rol                      | Descripción                                                                                                             |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------- |
| **Lector de Intune**     | Proporciona acceso de solo lectura a la información, configuraciones y datos de cumplimiento de dispositivos de Intune. |
| **Lector de directorio** | Concede acceso de solo lectura a las relaciones entre usuarios y dispositivos de Entra ID.                              |
| **Lector de seguridad**  | Permite el acceso a los datos de cumplimiento de dispositivos y alertas de seguridad con fines de diagnóstico.          |

{% hint style="info" %}
Estos roles están alineados con el principio de mínimo privilegio. Ajuste las asignaciones de roles según sea necesario para los requisitos de gobernanza de su organización.
{% endhint %}

***

### Transparencia del acceso a los datos

La siguiente tabla describe los datos a los que accede el agente y su propósito.

| Tipo de datos                                             | Nivel de acceso | Propósito                                                                                              |
| --------------------------------------------------------- | --------------- | ------------------------------------------------------------------------------------------------------ |
| **Inventario y estado del dispositivo**                   | Solo lectura    | Para recuperar información de hardware, sistema operativo e inscripción para la solución de problemas. |
| **Directivas de configuración y cumplimiento**            | Solo lectura    | Para analizar las directivas aplicadas e identificar configuraciones incorrectas.                      |
| **Datos de implementación e instalación de aplicaciones** | Solo lectura    | Para revisar la asignación de aplicaciones, el estado de entrega y los detalles del fallo.             |
| **Registros de diagnóstico y códigos de error**           | Solo lectura    | Para correlacionar eventos de error e identificar las causas raíz.                                     |
| **Asignaciones de usuarios y grupos**                     | Solo lectura    | Para mapear las relaciones de los dispositivos y evaluar la segmentación de directivas.                |

**Tratamiento de datos:**

* El agente **no** modificar, eliminar o exportar datos de clientes fuera del límite del Tenant.
* Todo el acceso se limita a la **API de Microsoft Graph** utilizando permisos delegados o de aplicación.
* Toda la actividad se registra en **los registros de auditoría de Microsoft Entra** para garantizar la transparencia y la trazabilidad.

***

### Uso del agente

Al ejecutar el agente, proporcione la entrada requerida para realizar la solución de problemas de forma eficaz.

| Tipo de entrada | Descripción                                 | Ejemplo                                         |
| --------------- | ------------------------------------------- | ----------------------------------------------- |
| **Obligatorio** | ID del dispositivo o nombre del dispositivo | `"Solucionar problemas del dispositivo ABC123"` |
| **Opcional**    | Descripción del problema                    | `"La aplicación no se instalará"`               |
| **Opcional**    | Código o mensaje de error                   | `"0x87D1041C"`                                  |
| **Opcional**    | Hora en que ocurrió el problema             | `"2025-01-15T09:00Z"`                           |

#### Consultas de ejemplo

* `"Solucionar problemas del dispositivo ABC123"`
* `"¿Por qué no se inscribe el dispositivo DESKTOP-XYZ?"`
* `"Analiza los problemas de cumplimiento del portátil del usuario john.doe"`
* `"¿Por qué falla la implementación de la aplicación en el dispositivo DEV456?"`

{% hint style="info" %}
Asegúrese de que la cuenta de administrador que ejecuta el agente tenga asignados todos los roles necesarios antes de usarlo.
{% endhint %}

***

### Consideraciones de seguridad y cumplimiento

* Toda la comunicación con Microsoft Graph se cifra mediante HTTPS y está protegida por 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

* Verifique que la cuenta de administrador tenga asignados todos los roles necesarios.
* Revise los datos de cumplimiento e inscripción de dispositivos de Intune para garantizar una visibilidad adecuada antes de solucionar problemas.


---

# 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/device-troubleshooter/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.