> For the complete documentation index, see [llms.txt](https://docs.stoik.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stoik.io/help/help-center-en-es/seguridad-humana/permissions.md).

# Permisos

Human Security protege a tu gente del phishing, el fraude y el compromiso de cuentas. Para detener amenazas reales y no solo marcarlas, Stoïk necesita un conjunto definido de permisos en tu Microsoft 365 o Google Workspace. Esta página explica cada permiso que solicitamos y lo que hace.

{% hint style="info" %}
**Nuestros principios**

* **Principio de mínimo privilegio:** solicitamos solo lo que necesita una función.
* **Con un propósito definido:** cada permiso corresponde a una acción específica, enumerada a continuación.
* **Leer primero, actuar de forma limitada:** la mayor parte del acceso es de solo lectura; la escritura se limita a acciones de protección.
* **Tus datos siguen siendo tuyos:** nunca se venden, nunca se usan más allá del servicio que habilitaste.
* **Revocable en cualquier momento:** retira el acceso desde tu consola de administración cuando quieras.
  {% endhint %}

## Cómo se estructura el acceso

Human Security está construido a partir de tres bloques de acceso. Cada función usa solo los bloques que necesita, así que solo concede lo que habilites.

* [Acceso al directorio del equipo](#team-directory-access): acceso de solo lectura a tu lista de empleados y grupos. Sin acceso al buzón.
* [Protección del buzón](#mailbox-protection): acceso al buzón para entregar simulaciones, revisar los correos denunciados y actuar sobre amenazas confirmadas.
* [botón de Reportar](#report-button): un complemento ligero para marcar correos sospechosos. Sin acceso al buzón.

| Función     | Acceso al directorio del equipo | Protección del buzón | botón de Reportar |
| ----------- | :-----------------------------: | :------------------: | :---------------: |
| Simulación  |                ✓                |           ✓          |         ✗         |
| Aprendizaje |                ✓                |           ✗          |         ✗         |
| Informe     |                ✓                |           ✓          |         ✓         |

{% hint style="success" %}
**Solo concede lo que uses.** El aprendizaje necesita acceso de solo lectura al directorio y nada más. Solo Report también requiere el complemento que instalan los empleados.
{% endhint %}

## Acceso al directorio del equipo

Acceso de solo lectura a tu lista de empleados y grupos, para que Stoïk sepa a quién proteger, simular y formar. Sin acceso al buzón.

{% tabs %}
{% tab title="Microsoft 365" %}

| Permiso                               | Para qué sirve                                                                                          |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| **User.Read.All**                     | Leer usuarios para crear y actualizar tu lista de empleados (nombres, correos electrónicos, teléfonos). |
| **Group.Read.All**                    | Leer grupos para poder segmentar y organizar a los empleados por equipo.                                |
| **UserAuthenticationMethod.Read.All** | Leer los métodos de autenticación (MFA) de los empleados.                                               |
| {% endtab %}                          |                                                                                                         |

{% tab title="Google Workspace" %}

| Permiso                            | Para qué sirve                                                              |
| ---------------------------------- | --------------------------------------------------------------------------- |
| **admin.directory.user.readonly**  | Leer usuarios del directorio para crear y actualizar tu lista de empleados. |
| **admin.directory.group.readonly** | Leer grupos para poder segmentar y organizar a los empleados por equipo.    |
| **userinfo.email**                 | Identificar al administrador que concede el acceso.                         |
| {% endtab %}                       |                                                                             |
| {% endtabs %}                      |                                                                             |

## Protección del buzón

Acceso al buzón para entregar simulaciones de phishing, leer y analizar los correos denunciados y actuar sobre amenazas confirmadas. Lo concedes cuando conectas tu espacio de trabajo para Simulación o Report.

{% tabs %}
{% tab title="Microsoft 365" %}

| Permiso                                                                     | Para qué sirve                                                                                                                                                                                                                                   |
| --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **User.Read.All**                                                           | Encontrar usuarios y asociar direcciones de correo con buzones.                                                                                                                                                                                  |
| **Mail.ReadWrite**                                                          | Entregar simulaciones de phishing (insertar, leer, limpiar), leer correos denunciados y, próximamente, actuar sobre una amenaza confirmada: añadir o quitar un banner de advertencia, o mover el correo hacia y desde una carpeta de cuarentena. |
| **SecurityAnalyzedMessage.Read.All**                                        | Recuperar detalles de detección de un correo denunciado para que podamos decirle a tu responsable de TI si es una amenaza real (phishing o fraude).                                                                                              |
| **AuditLog.Read.All** · **AuditLogsQuery.Read.All** · **ActivityFeed.Read** | Detectar actividad maliciosa y confirmar si un correo denunciado es una amenaza real o provocó un compromiso.                                                                                                                                    |
| **MailboxSettings.Read**                                                    | Detectar reglas maliciosas del buzón, una señal común de que un correo llevó a la toma de control de la cuenta.                                                                                                                                  |
| **UserAuthenticationMethod.Read.All**                                       | Detectar manipulaciones de los métodos MFA de un usuario y mostrar el estado de MFA.                                                                                                                                                             |
| **Policy.Read.ConditionalAccess**                                           | Incorporar la postura de protección de la cuenta en la evaluación de la amenaza.                                                                                                                                                                 |
| **Application.Read.All**                                                    | Detectar aplicaciones de terceros maliciosas conectadas a una cuenta.                                                                                                                                                                            |
| **Reports.Read.All**                                                        | Entender el volumen y los patrones de correo, usado para sugerir los mejores objetivos para simulaciones de fraude de pagos (los empleados que reciben más facturas son los objetivos más realistas).                                            |
| {% endtab %}                                                                |                                                                                                                                                                                                                                                  |

{% tab title="Google Workspace" %}

| Permiso                                    | Para qué sirve                                                                                                                                                                                                                 |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **gmail.insert**                           | Insertar correos de simulación de phishing en los buzones.                                                                                                                                                                     |
| **gmail.metadata**                         | Leer los encabezados y los IDs de los mensajes para verificar y hacer seguimiento de las simulaciones.                                                                                                                         |
| **gmail.modify**                           | Mover a la Papelera los correos de verificación de configuración de la simulación y, próximamente, actuar sobre una amenaza confirmada (banner de advertencia, cuarentena).                                                    |
| **gmail.readonly**                         | Leer el contenido de los correos denunciados para revisarlos, y analizar los correos reales de facturas o pagos que reciben los empleados para crear simulaciones de fraude de pagos realistas y elegir los mejores objetivos. |
| **gmail.settings.basic**                   | Configurar la lista de permitidos para que las simulaciones lleguen de forma fiable a la bandeja de entrada.                                                                                                                   |
| **admin.directory.user.readonly**          | Asociar destinatarios con usuarios del directorio.                                                                                                                                                                             |
| **admin.reports.audit.readonly**           | Detectar actividad sospechosa para confirmar si un correo denunciado es una amenaza real e identificar quién recibe más facturas para la segmentación de fraude de pagos.                                                      |
| **apps.alerts**                            | Mostrar alertas de seguridad relacionadas de Google Workspace al analizar una amenaza.                                                                                                                                         |
| **admin.directory.customer.readonly**      | Leer los detalles de la organización necesarios para configurar la protección.                                                                                                                                                 |
| **gmail.settings.sharing**                 | Leer los delegados del buzón, para detectar accesos concedidos por una cuenta comprometida.                                                                                                                                    |
| **admin.directory.device.mobile.readonly** | Leer los dispositivos móviles inscritos en una cuenta, para detectar el dispositivo de un atacante.                                                                                                                            |
| {% endtab %}                               |                                                                                                                                                                                                                                |
| {% endtabs %}                              |                                                                                                                                                                                                                                |

{% hint style="info" %}
**Cómo los correos denunciados se convierten en un veredicto claro.** Cuando un empleado denuncia un correo, Stoïk analiza el mensaje y las señales de la cuenta y del tenant que lo rodean para decidir si se trata de phishing o fraude reales, de modo que tu responsable de TI obtenga un **verdadero / falso positivo** veredicto y pueda actuar directamente sobre él.
{% endhint %}

## botón de Reportar

El complemento que usan tus empleados para marcar correos sospechosos. Es intencionadamente ligero: no concede a Stoïk acceso API alguno a tus buzones.

{% tabs %}
{% tab title="Complemento de Outlook" %}

| Permiso              | Para qué sirve                                                                                                                 |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **ReadWriteMailbox** | Accede al correo que se está denunciando y, solo si el usuario lo elige, muévelo a Correo no deseado o a Elementos eliminados. |
| **Report.Phishing**  | Inicia sesión en la API de denuncias de Stoïk para enviar el informe.                                                          |
| {% endtab %}         |                                                                                                                                |

{% tab title="Extensión de Gmail (Chrome / Edge)" %}

| Permiso                                                         | Para qué sirve                                                                                                                                                                                                                                  |
| --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **identidad**                                                   | Abre el inicio de sesión de Google para confirmar qué usuario está denunciando.                                                                                                                                                                 |
| **almacenamiento**                                              | Almacena temporalmente en caché el token de inicio de sesión y recuerda el correo de la cuenta, para evitar repetidos avisos de inicio de sesión.                                                                                               |
| **`mail.google.com` (acceso al sitio)**                         | Añade el *Reportar a Stoïk* botón en Gmail, identifica el mensaje y la cuenta abiertos, y usa los propios controles de Gmail para la acción resultante. Se trata de acceso a la página del navegador, no de un ámbito OAuth de la API de Gmail. |
| **`accounts.google.com` (acceso al sitio)**                     | Permite el inicio de sesión de Google.                                                                                                                                                                                                          |
| **`*.phishing.cyber.stoik.io` (acceso al sitio)**               | Envía el informe a la API de Stoïk.                                                                                                                                                                                                             |
| **Ámbitos de inicio de sesión: `openid`, `correo electrónico`** | Inicia sesión al usuario y lo identifica por correo electrónico.                                                                                                                                                                                |
| {% endtab %}                                                    |                                                                                                                                                                                                                                                 |
| {% endtabs %}                                                   |                                                                                                                                                                                                                                                 |

{% hint style="success" %}
**La extensión de Gmail no solicita ningún ámbito OAuth del buzón.** El inicio de sesión se limita a tu identidad (`openid` + `correo electrónico`). El acceso al sitio permite que la extensión actúe sobre la página de Gmail que tienes abierta; no se trata de un acceso persistente al servidor a tu bandeja de entrada.
{% endhint %}

## Preguntas frecuentes

<details>

<summary>¿Leen todos nuestros correos?</summary>

No. Entregamos correos de simulación y leemos los mensajes específicos que denuncian tus empleados. Cualquier análisis continuo solo se ejecuta para detectar amenazas, y solo para las capacidades que habilites.

</details>

<details>

<summary>¿Podemos conceder solo algunas capacidades?</summary>

Sí. Los permisos están agrupados por capacidad. Si no habilitas una capacidad, no concedes sus permisos.

</details>

<details>

<summary>¿Podemos revocar el acceso más adelante?</summary>

Sí, en cualquier momento, desde la consola de administración de Microsoft 365 o Google Workspace. Revocar el acceso detiene la capacidad correspondiente.

</details>

<details>

<summary>¿Por qué algunos permisos permiten escribir y no solo leer?</summary>

Proteger a tu equipo requiere actuar sobre las amenazas, no solo verlas: entregar una simulación, mover un correo denunciado o poner en cuarentena un ataque confirmado. El acceso de escritura se limita a estas acciones.

</details>


---

# 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://docs.stoik.io/help/help-center-en-es/seguridad-humana/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.
