Sincronización con Google Workspace

Este artículo te ayudará a comenzar a usar Directory Connector para la sincronización de usuarios y grupos desde tu Google Workspace (anteriormente "G Suite") Directory a tu organización Bitwarden.

Para configurar la sincronización de directorio con Google Workspace (anteriormente "G Suite"), necesitará acceso al Portal de Administrador de Google Workspace y a la Consola de la Plataforma de Google Cloud. El Conector de Directorio requerirá información obtenida de estos procesos para funcionar correctamente.

Completa los siguientes pasos para crear un proyecto de Google Cloud que usarás para conectar el Conector de Directorio a tu directorio. Si ya tienes un proyecto de Google Cloud disponible, salta a Habilitar SDK de Administrador:

1. En la Consola de GCP, selecciona el botón de Crear Proyecto.

2. Ingrese un nombre específico de Bitwarden para el proyecto (por ejemplo, bitwarden-dc-project) y seleccione el botón Crear.

Complete los siguientes pasos para habilitar la API del SDK del administrador, a la que el Conector de Directorio realizará solicitudes:

1. En la Consola de GCP, selecciona el proyecto creado o preexistente.

2. Desde la navegación de la izquierda, selecciona APIs & Servicios → Biblioteca.

3. En el cuadro de búsqueda, ingrese SDK del administrador y abra el servicio API del SDK del administrador.

4. Selecciona el botón Habilitar.

Completa los siguientes pasos para crear una cuenta de servicio para usar al hacer llamadas a la API:

1. En la Consola de GCP, selecciona el proyecto creado o preexistente.

2. Desde la navegación de la izquierda, selecciona APIs & Servicios → Credenciales.

3. Seleccione el botón Crear Credenciales, y seleccione Cuenta de servicio del menú desplegable.

4. Complete la sección de detalles de la cuenta de servicio, y seleccione el botón de Crear.

5. En la sección Otorgar a esta cuenta de servicio acceso al proyecto, seleccione Proyecto → Propietario del menú desplegable Rol y seleccione el botón Continuar.

6. Seleccione el botón Hecho.

Complete los siguientes pasos para obtener los permisos apropiados para la cuenta de servicio creada:

1. En la Consola de GCP, selecciona el proyecto creado o preexistente.

2. Desde la navegación de la mano izquierda, selecciona IAM & Administrador → Cuentas de Servicio.

3. Seleccione la cuenta de servicio creada.

4. En la página de Detalles de la Cuenta de Servicio, selecciona el botón Añadir Clave y selecciona Crear nueva clave del menú desplegable.

5. Seleccione el tipo de clave JSON y seleccione el botón Crear para descargar una clave en formato JSON a su máquina local.

6. De vuelta en la página de detalles de tu cuenta de servicio, selecciona el menú desplegable Mostrar Delegación en todo el Dominio.

7. Sigue estos pasos para habilitar la autoridad delegada en todo el dominio.

8. Ingrese un Nombre de producto para la pantalla de consentimiento.

9. Selecciona Guardar.

Complete los siguientes pasos para autorizar al cliente a leer su directorio:

1. Abre el Portal de Administrador de Google.

2. Desde la navegación de la izquierda, selecciona Seguridad → Controles de API.

3. Seleccione el botón Gestionar Delegación de Dominio Amplio.

4. Seleccione el botón Agregar nuevo.

5. En el campo de ID del Cliente, pegue el ID del Cliente creado.

   Para recuperar el ID de Cliente creado, abra la Consola GCP y navegue a API & Servicios → Credenciales.

6. En el campo de alcances de OAuth, pega el siguiente valor para conceder sólo acceso de lectura:

   BashCopy
   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.group.member.readonly

7. Seleccione el botón Autorizar.

Completa los siguientes pasos para configurar el Conector de Directorio para usar tu directorio de Google:

1. Abre la aplicación de escritorio del Conector de Directorio.

2. Navega a la pestaña de Ajustes.

3. Desde el menú desplegable Tipo, selecciona G Suite (Google).

   Los campos disponibles en esta sección cambiarán de acuerdo con el tipo seleccionado.

4. Ingrese al Dominio de su cuenta de Google.

5. Ingrese la dirección de correo electrónico de un Usuario Administrador con acceso completo a su directorio de Google.

6. Si tienes uno, ingresa el ID del Cliente de tu directorio. Muchos usuarios no tendrán o se les requerirá ingresar una identificación de cliente.

7. Seleccione el botón Elegir Archivo y seleccione la clave JSON descargada.

Complete los siguientes pasos para configurar el ajuste utilizado al sincronizar usando el Conector de Directorio:

1. Abre la aplicación de escritorio del Conector de Directorio.

2. Navega a la pestaña de Ajustes.

3. En la sección de Sincronización, configure las siguientes opciones según lo desee:

Utilice listas separadas por comas para incluir o excluir de una sincronización basada en el correo electrónico del usuario o grupo.

La API del SDK del administrador proporciona capacidades de filtrado limitadas para usuarios y grupos con un parámetro de consulta. Para aprender más:

• Buscar usuarios

• Buscar grupos

Filtros de usuario

Las siguientes sintaxis de filtrado deben usarse en el campo Filtro de Usuario:

Incluir/Excluir usuarios por correo electrónico

Para incluir o excluir usuarios específicos de una sincronización basada en la dirección de correo electrónico:

BashCopy
include:joe@example.com,bill@example.com,tom@example.com

BashCopy
exclude:joe@example.com,bill@example,tom@example.com

Concatenar con consulta

Para concatenar un filtro de usuario con el parámetro consulta, use una barra vertical (|):

BashCopy
include:john@example.com,bill@example.com|orgName=Engineering orgTitle:Manager

BashCopy
exclude:john@example.com,bill@example.com|orgName=Engineering orgTitle:Manager

Usa solo consulta

Para usar solo el parámetro consulta, precede la consulta con una barra vertical (|):

BashCopy
|orgName=Engineering orgTitle:Manager

Filtros de grupo

Las siguientes sintaxis de filtrado deben usarse en el campo Filtro de Grupo:

Incluir/Excluir grupos

Para incluir o excluir grupos de una sincronización basada en el Nombre del Grupo:

BashCopy
include:Group A,Group B

BashCopy
exclude:Group A,Group B

Incluye grupos con comodín

BashCopy
|name:*marketing*

Los comodines * son compatibles en ambos lados del parámetro de búsqueda. Además, la búsqueda no distingue entre mayúsculas y minúsculas.

Concatenar con consulta

Para concatenar un filtro de grupo con el parámetro consulta, usa una tubería (|):

BashCopy
include:name='Engineering'|email:admin*

BashCopy
exclude:name='Engineering'|email:admin*

Usa solo consulta

Para usar solo el parámetro consulta, precede la consulta con una barra vertical (|):

BashCopy
|memberKey=user@company.com

Para probar si el Conector de Directorio se conectará con éxito a su directorio y devolverá los usuarios y grupos deseados, navegue hasta la pestaña Dashboard y seleccione el botón Test Now. Si tiene éxito, los usuarios y grupos se imprimirán en la ventana del Conector de Directorio de acuerdo con las opciones de sincronización y los filtros especificados:

Una vez que las opciones de sincronización y los filtros están configurados y probados, puedes comenzar la sincronización. Complete los siguientes pasos para iniciar la sincronización automática con Directory Connector:

1. Abre la aplicación de escritorio del Conector de Directorio.

2. Navega a la pestaña Dashboard.

3. En la sección de Sincronización, selecciona el botón de Iniciar sincronización.

   Alternativamente, puede seleccionar el botón Sincronización ahora para ejecutar una sincronización manual única.

El Conector de Directorio comenzará a sondear su directorio basado en las opciones de sincronización y los filtros configurados.

Si sales o cierras la aplicación, la sincronización automática se detendrá. Para mantener el Conector de Directorio funcionando en segundo plano, minimiza la aplicación o escóndela en la bandeja del sistema.