> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirespeed.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Workspace

> Integre Google Workspace

> [!NOTE]
>
> Usamos la compatibilidad con [OAuth](https://developers.google.com/identity/protocols/oauth2) de Google Workspace para integrarnos en su cuenta de Workspace. La integración de Workspace requiere permisos de lectura del directorio para poder buscar todos los usuarios de su organización.

Para empezar, [añada una integración nueva](https://app.wirespeed.co/settings/integrations?tab=browse) y seleccione Google Workspace. Se le redirigirá a la página de consentimiento de OAuth.

### Incluir los correos de Wirespeed en la lista de permitidos de la Google Admin Console

Puede añadir determinados dominios y direcciones de correo a una lista de permitidos en todo su Google Workspace. Para asegurarse de que los correos de Wirespeed lleguen a su equipo:

1. Inicie sesión en la Google Admin Console en [https://admin.google.com](https://admin.google.com) con una cuenta de administrador.
2. En el menú de la izquierda, haga clic en **Aplicaciones** > **Google Workspace** > **Gmail**.
3. Asegúrese de que su dominio esté seleccionado en la sección **Unidades organizativas**.
4. En la pestaña **Spam, phishing y software malicioso**, localice la sección **Spam**.
5. Haga clic en **Configurar** (si no existen reglas) o en **Añadir otra regla**.
6. Asigne un nombre a la regla y asegúrese de que esté marcada la casilla **Omitir los filtros de spam y ocultar las advertencias de los mensajes de remitentes o dominios de las listas seleccionadas**.

> [!WARNING]
>
> La casilla **Omitir los filtros de spam de los remitentes internos** puede estar marcada de forma predeterminada. NO es necesario tenerla marcada para nuestros fines y puede añadir un riesgo no deseado. Téngalo en cuenta antes de dejarla activada.

7. Haga clic en **Crear o editar lista** para abrir la página Gestionar lista de direcciones.
   * ***Si crea una lista nueva***, haga clic en **AÑADIR LISTA DE DIRECCIONES**, asígnele un nombre y seleccione **Añadir dirección**.
   * ***Si edita una lista existente***, seleccione la lista y haga clic en **Añadir dirección**.

8. En el campo indicado, introduzca el dominio: [wirespeed.co](https://wirespeed.co).

9. Haga clic en **GUARDAR**.

10. Vuelva a la página de configuración de la regla de spam, haga clic en **Usar lista existente** y seleccione la lista que editó.

11. Haga clic en **Guardar** para aplicar los cambios.

## ¿Qué eventos se recopilan?

Wirespeed lee la actividad de Google Workspace desde la Admin SDK Reports API con el permiso de auditoría de solo lectura concedido al conectar, y sincroniza su directorio de usuarios. No se requiere ninguna configuración adicional en Wirespeed. Los eventos de Gemini y NotebookLM solo aparecen cuando esos servicios están activados en su Workspace.

| Origen | Eventos |
| - | - |
| Inicio de sesión | Inicios de sesión correctos y fallidos, y retos de inicio de sesión |
| Consola de administración | Cambios que los administradores realizan en usuarios, roles, seguridad y configuración del dominio |
| Tokens OAuth | Autorizaciones de aplicaciones de terceros y actividad de tokens |
| SAML | Inicios de sesión en aplicaciones SAML que usan Google como proveedor de identidad |
| Drive, Calendar y Meet | Actividad de archivos, calendario y reuniones |
| Cuentas y dispositivos | Cambios de cuenta como actualizaciones de contraseña y de la verificación en 2 pasos, registro de dispositivos móviles y actividad de la consola de Google Cloud |
| Gmail | Actividad de entrega de mensajes, cuando el administrador que autoriza puede leer registros de auditoría |
| Gemini | Uso de funciones de Gemini en aplicaciones de Workspace, cuando Google proporciona registros de auditoría de Gemini para su organización |
| NotebookLM | Actividad de notebooks, fuentes y artefactos generados, además de cambios de uso compartido, visibilidad y exportación, cuando Google proporciona registros de auditoría de NotebookLM para su organización |

La recopilación de Gemini y NotebookLM se activa automáticamente cuando Google proporciona esos registros de auditoría, y Wirespeed vuelve a comprobar la disponibilidad cada pocas horas. No necesita volver a conectar la integración. Si alguna fuente no está disponible, la integración muestra una advertencia y las demás fuentes siguen funcionando. La recopilación empieza cuando una fuente pasa a estar disponible; el historial anterior no se importa.

## Detecciones gestionadas

Wirespeed evalúa los eventos recopilados para:

| Detección | Condición |
| - | - |
| Delegación de todo el dominio de Google concedida | Un administrador autoriza a un cliente de API a actuar como cualquier usuario del dominio |
| Configuración SSO de Google modificada | Un administrador cambia o activa o desactiva el inicio de sesión único |
| Usuario de Google eliminado | Un administrador elimina un usuario |
| Rol de administrador de Google asignado | Un usuario recibe derechos de superadministrador o un rol de administrador |
| Acceso contextual de Google modificado | Un administrador activa o desactiva el acceso contextual, o cambia qué niveles de acceso se aplican a una aplicación |
| Concesión OAuth sospechosa de Apps Script a Gmail | Se autoriza un Apps Script con acceso completo a Gmail y permiso para enviar correo |
| Inicio de sesión de Google con desafío seguido de inicio de sesión solo con contraseña desde un centro de datos | Un inicio de sesión que superó un desafío va seguido de un inicio de sesión sin verificación en 2 pasos desde una red de centro de datos nueva para el usuario |

Los inicios de sesión correctos y fallidos también se normalizan como eventos de autenticación para búsquedas SIEM y detecciones de inicio de sesión entre plataformas. Wirespeed no crea una detección individual por cada inicio de sesión.

## Errores

### access\_not\_configured

> [!WARNING]
>
> Access blocked: Your institution's admin needs to review Wirespeed. Error 400: access\_not\_configured

Este error se produce cuando su organización de Google Workspace restringe de forma predeterminada las aplicaciones OAuth de terceros. Es una función de seguridad de la Google Admin Console que exige que un administrador apruebe explícitamente las aplicaciones antes de que los usuarios puedan concederles acceso.

Para resolverlo, un Super Admin de Google Workspace debe preaprobar la aplicación Wirespeed:

1. Inicie sesión en la [Google Admin Console](https://admin.google.com) como Super Admin.
2. Vaya a **Seguridad** > **Control de acceso y de datos** > **Controles de la API**.
3. Haga clic en **Gestionar el acceso de aplicaciones de terceros** (o vaya directamente a [App Access Control](https://admin.google.com/ac/owl/list?tab=apps)).
4. Haga clic en **Añadir aplicación** > **Nombre de la aplicación OAuth o ID de cliente**.
5. Busque **Wirespeed** o pegue el OAuth Client ID facilitado por su administrador de Wirespeed.
6. Seleccione la aplicación Wirespeed y haga clic en **Seleccionar**.
7. Establezca el nivel de acceso en **De confianza** (recomendado) o **Limitado**.
8. Haga clic en **Configurar** para guardar.

Una vez aprobada la aplicación, vuelva a Wirespeed e intente de nuevo la [integración de Google Workspace](https://app.wirespeed.co/settings/integrations?tab=browse).

> [!TIP]
>
> Si no está seguro del OAuth Client ID, contacte con su representante de cuenta de Wirespeed o escriba a [support@wirespeed.co](mailto:support@wirespeed.co).

### La integración falla con acceso Limitado, pero funciona cuando está De confianza

Cuando el acceso de Wirespeed está establecido en **Limitado** (o **Datos específicos de Google**) en App Access Control, Google indica que su administrador debe conceder permisos adicionales y la conexión falla, aunque todos los ámbitos solicitados estén permitidos. Establecer Wirespeed en **De confianza** hace que la conexión se complete correctamente.

Una causa conocida es que la cuenta usada para conectar Wirespeed esté inscrita en el [Programa de protección avanzada](https://support.google.com/a/answer/9378686) de Google. La protección avanzada restringe qué aplicaciones de terceros pueden autorizar los usuarios inscritos, por lo que una aplicación con acceso **Limitado** o **Datos específicos de Google** puede seguir bloqueada. Marcar la aplicación como **De confianza** elimina esa restricción.

Para resolverlo sin marcar Wirespeed como de confianza:

1. Cree o elija una cuenta dedicada de Super Admin que **no** esté inscrita en la protección avanzada y úsela solo para conceder el consentimiento. Sin protección avanzada, no se exige el inicio de sesión con clave de seguridad para esta cuenta, así que colóquela en una unidad organizativa cuya directiva de verificación en 2 pasos se aplique con **Solo clave de seguridad** como método permitido.
2. En App Access Control, establezca Wirespeed en el nivel de acceso que permita su directiva, como **Limitado** o **Datos específicos de Google**.
3. Vuelva a intentar la [integración de Google Workspace](https://app.wirespeed.co/settings/integrations?tab=browse). En la página de consentimiento de Google, inicie sesión con la cuenta dedicada de Super Admin.

Si todas las cuentas que pueden conceder consentimiento deben permanecer inscritas en la protección avanzada, Wirespeed debe permanecer como **De confianza** en App Access Control.

> [!NOTE]
>
> El uso de datos de usuario en bruto o derivados recibidos de las API de Workspace se ajustará a la Google User Data Policy, incluidos los requisitos de Limited Use.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.