](https://saml.prod-ap-syd.verkada.com/saml/sso/%3Cclient-ID%3E)
{% hint style="warning" %}
Consulte **Admin > Privacidad de datos > Residencia de datos > Ubicación del procesamiento de datos** para confirmar dónde se encuentra su región.
{% endhint %}
{% endstep %}
{% step %}
**Se le redirigirá a la página de configuración de la aplicación de Google Workspace para completar el inicio de sesión.**
{% endstep %}
{% endstepper %}
***
### Iniciar sesión mediante la aplicación móvil
{% hint style="info" %}
Command en Android e iOS admite el inicio de sesión mediante SAML.
{% endhint %}
{% stepper %}
{% step %}
**En el campo de dirección de correo electrónico, escriba el correo electrónico del usuario y haga clic en Siguiente.**
{% endstep %}
{% step %}
**Debería ser redirigido a su IdP (Google Workspace) para completar el proceso de inicio de sesión.**
{% endstep %}
{% endstepper %}
{% endtab %}
{% tab title="Aprovisionamiento de usuarios" %}
## Aprovisionamiento de usuarios de Google Workspace
La integración nativa de Google Workspace permite a las organizaciones sincronizar automáticamente usuarios y grupos desde Google Workspace en Verkada Command. Esto simplifica la gestión de identidades y la incorporación general de usuarios.
A diferencia de las integraciones SCIM de Verkada con Okta o Azure, esta integración utiliza el SDK de administración de Google Workspace y la API de Reports, autenticados a través de una cuenta de servicio de Google con delegación a nivel de dominio.
Con la integración habilitada, Command puede:
* Importar usuarios y grupos desde grupos o unidades organizativas (OU) de Google Workspace seleccionados
* Sincronizarlos en Command como usuarios y grupos administrados
* Mantener la precisión del directorio con sincronizaciones programadas en segundo plano y sincronizaciones bajo demanda desde la interfaz de administración
***
### Crear una cuenta de servicio de Google
Para permitir que Command lea datos de usuarios y grupos de su dominio de Google Workspace, debe autenticarse con las API de Google mediante una cuenta de servicio. Este tipo de cuenta está diseñado para acceso programático y debe configurarse con los ámbitos de API correctos y la delegación a nivel de dominio. Estos ajustes se configuran en su [Consola de Google Cloud](https://console.cloud.google.com/?hl=en-au) cuenta.
#### Verificar políticas y roles
Primero debe verificar si su usuario tiene permisos para crear una cuenta de servicio y generar la clave JSON de la cuenta de servicio. Para asegurarse de que las políticas de seguridad de su inquilino no le bloqueen:
{% stepper %}
{% step %}
**Vaya a** [**Consola de Google Cloud**](https://console.cloud.google.com/?hl=en-au) **e inicie sesión con sus credenciales de superadministrador.**
{% endstep %}
{% step %}
**En la esquina superior izquierda, abra el menú desplegable Selector de proyectos y elija el recurso de nivel superior (Tipo: Organización).**
{% endstep %}
{% step %}
**En el panel izquierdo, vaya a IAM y administración → IAM.**
{% endstep %}
{% step %}
**Haga clic en Conceder acceso en Ver por principales.**
a. En **Agregar principales**, ingrese la dirección de correo electrónico del usuario.\
b. En **Asignar roles**, busque y seleccione **Administrador de políticas de la organización**.\
c. Haga clic en **Guardar**.
{% endstep %}
{% step %}
**En el panel izquierdo, seleccione Políticas de la organización.**
{% endstep %}
{% step %}
**En la lista de políticas, busque y deshabilite lo siguiente:**
{% code title="Políticas de la organización para deshabilitar" %}
```
Deshabilitar la creación de cuentas de servicio | Administrado
Deshabilitar la creación de cuentas de servicio | Administrado (heredado)
Deshabilitar la creación de claves de cuentas de servicio | Administrado
Deshabilitar la creación de claves de cuentas de servicio | Administrado (heredado)
```
{% endcode %}
{% endstep %}
{% endstepper %}
#### Crear una cuenta de servicio
{% stepper %}
{% step %}
**En el** [**Consola de Google Cloud**](https://console.cloud.google.com/?hl=en-au)**, en la parte superior izquierda, abra el menú desplegable Selector de proyectos.**
{% endstep %}
{% step %}
**Haga clic en Nuevo proyecto.**
{% endstep %}
{% step %}
**Introduzca un nombre de proyecto (por ejemplo, *****Sincronización de usuarios de Verkada*****) y cree el proyecto.**
{% endstep %}
{% step %}
**Una vez creado el proyecto, confirme que está seleccionado en la barra de navegación de la parte superior izquierda.**
{% endstep %}
{% step %}
**En la barra lateral izquierda, vaya a IAM y administración → Cuentas de servicio.**
{% endstep %}
{% step %}
**Haga clic en + Crear cuenta de servicio.**
{% endstep %}
{% step %}
**Complete los siguientes campos:**
* **Nombre:** Introduzca un nombre descriptivo (p. ej., *Aprovisionamiento de usuarios de Verkada*)
* **ID:** Déjelo como está o personalícelo (opcional)
* **Descripción:** Agregue una nota, como *Usado por Verkada para leer datos del directorio de Workspace* (opcional)
{% endstep %}
{% step %}
**Haga clic en Crear y continuar.**
{% endstep %}
{% step %}
**Omitir el paso Conceder acceso al proyecto: aquí no se requieren roles.**
{% endstep %}
{% step %}
**Haga clic en Continuar → Listo.**
{% endstep %}
{% step %}
**En la lista de cuentas de servicio, copie el ID de cliente OAuth 2 de la cuenta recién creada. Necesitará este ID más adelante para completar su configuración.**
{% endstep %}
{% endstepper %}
#### Generar una clave JSON
{% stepper %}
{% step %}
**En la lista de Cuentas de servicio, haga clic en el nombre de la cuenta o seleccione los tres puntos junto a su nueva cuenta de servicio y elija Administrar claves.**
{% endstep %}
{% step %}
**En la pestaña Claves, haga clic en Agregar clave → Crear nueva clave.**
{% endstep %}
{% step %}
**Seleccione JSON y haga clic en Crear.**
{% endstep %}
{% step %}
**Un `.json` archivo se descargará en su computadora. Guárdelo en una ubicación segura para usarlo más adelante al configurar la integración en Verkada Command.**
{% endstep %}
{% endstepper %}
{% hint style="danger" %}
Este archivo JSON contiene las credenciales que la integración de Google Workspace en Command utiliza para autenticarse en las API de Google mediante OAuth 2.0. Mantenga este archivo seguro, ya que proporciona acceso a los datos de su Workspace y nunca debe compartirse ni hacerse público.
{% endhint %}
#### Habilitar las API de Google requeridas
Verkada Command requiere acceso a API específicas de Google Workspace para leer usuarios, grupos, dominios y registros de auditoría. Estas API deben habilitarse en su proyecto de Google Cloud antes de que la integración pueda funcionar.
{% stepper %}
{% step %}
**Vaya a** [**Consola de Google Cloud**](https://console.cloud.google.com/)**, e inicie sesión con sus credenciales de superadministrador.**
{% endstep %}
{% step %}
**En la barra lateral izquierda, vaya a APIs y servicios → Biblioteca de API.**
{% endstep %}
{% step %}
**En la barra de búsqueda, busque y seleccione la API de Admin SDK y luego haga clic en Habilitar.**
{% hint style="warning" %}
Esta API es necesaria para leer usuarios, grupos y metadatos del dominio.
{% endhint %}
{% endstep %}
{% step %}
**(Opcional) Busque y habilite la API de Reports para permitir la supervisión del registro de auditoría y detectar cambios en el directorio.**
{% endstep %}
{% endstepper %}
***
### Habilitar la delegación a nivel de dominio
Para permitir que la cuenta de servicio suplante a un administrador y acceda a datos de usuarios y grupos en todo su dominio, debe concederle delegación a nivel de dominio. Esto permite que la cuenta de servicio realice operaciones de lectura en nombre de un administrador sin requerir una reautenticación manual.
{% stepper %}
{% step %}
**Vaya a la** [**Consola de administración de Google**](https://admin.google.com/) **e inicie sesión con las credenciales de superadministrador de su inquilino de Google Workspace.**
{% endstep %}
{% step %}
**Desde la página principal de la Consola de administración, vaya a Seguridad → Control de acceso y datos → Controles de API.**
{% endstep %}
{% step %}
**En la página de Controles de API, desplácese hasta la sección Delegación a nivel de dominio y haga clic en Administrar delegación a nivel de dominio.**
{% endstep %}
{% step %}
**Haga clic en Agregar nuevo e introduzca los siguientes detalles:**
* **ID de cliente:** Pegue el ID de cliente OAuth 2 de su archivo de clave de cuenta de servicio (el `client_id` campo del JSON).
* **Ámbitos de OAuth (separados por comas):**
https://www.googleapis.com/auth/admin.directory.user.readonly,
https://www.googleapis.com/auth/admin.directory.group.readonly,
https://www.googleapis.com/auth/admin.directory.orgunit.readonly
{% endstep %}
{% step %}
**Haga clic en Autorizar.**
{% endstep %}
{% endstepper %}
La nueva entrada de delegación aparecerá en la página, confirmando que la cuenta de servicio ahora puede ser utilizada por Verkada Command para consultar datos de usuarios, grupos y auditoría.
#### Establecer valores de atributos de usuario
Antes de sincronizar usuarios con Verkada Command, confirme que los atributos clave (como nombre, apellido, correo electrónico e ID de empleado) están completados correctamente en Google Workspace.
{% stepper %}
{% step %}
**Inicie sesión en la** [**Consola de administración de Google**](https://admin.google.com/) **usando su cuenta de superadministrador.**
{% endstep %}
{% step %}
**Vaya a Directorio → Usuarios.**
{% endstep %}
{% step %}
**Seleccione el perfil de usuario que desea actualizar.**
{% endstep %}
{% step %}
**Haga clic en Información del usuario y luego expanda las secciones relevantes (por ejemplo, Información básica o Información del empleado).**
{% endstep %}
{% step %}
**Actualice los siguientes campos según sea necesario:**
* **Dirección de correo electrónico principal**
* **Nombre** y **Apellido**
* **ID de empleado** (en *Información del empleado*)
* **Número de teléfono** (en *Información de contacto*)
{% endstep %}
{% step %}
**Haz clic en Guardar para aplicar los cambios.**
{% endstep %}
{% endstepper %}
Los siguientes atributos se pueden sincronizar desde Google Workspace a Verkada Command:
| Nombre del atributo de Google Workspace | Campo de Command |
| ------------------------------------------------------ | ------------------- |
| Correo electrónico | Correo electrónico |
| Nombre | Nombre |
| Apellido | Apellido |
| Departamento | Departamento |
| Centro de costos | ID de departamento |
| ID de empleado | ID de empleado |
| Puesto de trabajo | Título del empleado |
| Número de teléfono (principal del hogar/trabajo/móvil) | Número de teléfono |
{% hint style="danger" %}
Los usuarios y grupos sincronizados desde Google Workspace se administran exclusivamente en Workspace y no se pueden editar en Verkada Command. Los usuarios deben tener nombre, apellido y dirección de correo electrónico para sincronizarse correctamente con Command.
{% endhint %}
{% hint style="info" %}
Para garantizar que los números de teléfono de los usuarios se sincronicen correctamente con Verkada Command, introdúzcalos en formato internacional, incluyendo el código de país y sin espacios ni guiones.
**Ejemplo:** `+14155552671`
{% endhint %}
***
### Habilitar la integración en Command
{% hint style="danger" %}
Necesitas **Administrador de la organización** permisos para configurar esta integración.
{% endhint %}
{% stepper %}
{% step %}
**En Verkada Command, ve a All Products > Admin.**
{% endstep %}
{% step %}
**En Configuración de la organización, seleccione Inicio de sesión y acceso → Aprovisionamiento de usuarios → Google Workspace.**
a. Introduzca la dirección de correo electrónico de su superadministrador de Google Workspace. Por seguridad y continuidad, Verkada recomienda usar una cuenta de servicio dedicada que tenga permisos de administrador equivalentes, en lugar de una cuenta de usuario personal.\
a. Cargue la clave JSON que generó en su proyecto de la Consola de Google Cloud.\
b. Una vez que la autenticación se realice correctamente, haga clic en **Agregar** para seleccionar los Grupos y/o Unidades Organizativas que desea sincronizar con Command.\
c. Haga clic en **Activar**.
{% endstep %}
{% step %}
**Tras completar correctamente la primera sincronización, el botón Sincronizar ahora estará disponible para actualizaciones bajo demanda en cualquier momento.**
{% endstep %}
{% endstepper %}
***
### Preguntas frecuentes
¿Los usuarios se sincronizan automáticamente según un horario regular?
Sí, los usuarios se sincronizan automáticamente desde su cuenta de Google Workspace a Verkada Command cada 40 minutos.
{% endtab %}
{% endtabs %}
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.verkada.com/command/es/seguridad/identity-providers/google-workspace.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.