Sincronización con Okta

Este artículo te ayudará a comenzar a usar Directory Connector para la sincronización de usuarios y grupos desde tu directorio Okta a tu organización Bitwarden.

Directory Connector requiere conocimiento de un token generado por Okta para conectarse a su directorio. Complete los siguientes pasos para crear y obtener un token de API de Okta para su uso por el Conector de Directorio:

1. Desde su Consola de Desarrollador de Okta (https://yourdomain-admin.okta.com) navegue a Seguridad → API → Tokens.

2. Seleccione el botón Crear token y dé a su token un nombre específico de Bitwarden (por ejemplo, bitwarden-dc).

3. Copia el valor del Token generado al portapapeles.

   advertencia

   Your token value will not be shown again. Paste it somewhere safe to prevent it from being lost.

Complete los siguientes pasos para configurar el Conector de Directorio para usar su Directorio Okta:

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

2. Navega a la pestaña de Ajustes.

3. Del menú desplegable Tipo, selecciona Okta.

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

4. Ingrese la URL de su organización Okta en el campo URL de la Organización (por ejemplo, https://yourdomain.okta.com).

5. Pega el valor del token de la API en el campo Token.

Complete los siguientes pasos para configurar los ajustes utilizados 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 en base al correo electrónico del usuario o al nombre del grupo. Además, las API de Okta proporcionan capacidades de filtrado limitadas para usuarios y grupos que pueden usarse en los campos de filtro del Conector de Directorio.

Consulte la documentación de Okta para obtener más información sobre el uso del parámetro de filtro para usuarios y grupos.

Filtros de usuario

Incluir/Excluir usuarios por correo electrónico

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

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

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

Concatenar con filtro

Para concatenar un filtro de usuario con el parámetro filtro, use una tubería (|):

Bash
include:john@example.com,bill@example.com|profile.firstName eq "John"

Bash
exclude:john@example.com,bill@example.com|profile.firstName eq "John"

Usa solo filtro

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

Bash
|profile.lastName eq "Smith"

Filtros de grupo

Incluir/Excluir grupos

Para incluir o excluir grupos por nombre:

Bash
include:Group A,Group B

Bash
exclude:Group A,Group B

Concatenar con filtro

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

Bash
include:Group A|type eq "APP_GROUP"

Bash
exclude:Group A|type eq "APP_GROUP"

Usa solo filtro

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

Bash
|type eq "BUILT_IN"

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 como se desea, 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, minimice la aplicación o escóndala en la bandeja del sistema.