Base de Conocimientos

Integración de Okta - Configuración de SCIM

Última modificación: 10 sept 2025

Sincroniza usuarios y grupos de Okta con TeamViewer mediante SCIM (System for Cross-domain Identity Management). SCIM ayuda a los administradores a crear, actualizar, desactivar y gestionar usuarios en TeamViewer automáticamente y directamente desde Okta. Este artículo explica cómo configurar el aprovisionamiento SCIM utilizando la aplicación TeamViewer del Okta Integration Network (OIN) o una aplicación SCIM personalizada.

Este artículo se aplica a todos los titulares de licencias TeamViewer Tensor.

Requisitos

Para utilizar el aprovisionamiento SCIM, debes cumplir los siguientes requisitos:
Una licencia válida de TeamViewer Tensor
Inicio de sesión único (SSO) de TeamViewer configurado correctamente con Okta
El formato de nombre de usuario de la aplicación está configurado como Correo electrónico, ya que TeamViewer utiliza la dirección de correo electrónico como atributo userName de SCIM
Acceso de administrador tanto a TeamViewer como a Okta

Funciones compatibles

TeamViewer admite las siguientes funciones de aprovisionamiento SCIM 2.0:

Crear usuarios
Actualizar atributos de usuario
Desactivar usuarios
Sincronizar contraseñas
Importar usuarios
Importar actualizaciones de perfil
Enviar grupos y membresías de grupo

Nota: Los usuarios nunca se eliminan permanentemente mediante SCIM. Cuando se elimina o se desasigna un usuario, TeamViewer desactiva la cuenta en lugar de eliminarla.

La aplicación de Okta Integration Network (OIN) incluye un conector SCIM preconfigurado. Solo necesitas proporcionar un token de API y habilitar las funciones de aprovisionamiento.

Requisitos previos

Antes de configurar el aprovisionamiento SCIM:

Agrega la aplicación TeamViewer desde Okta Integration Network (OIN)
Completa la configuración de SSO de SAML 2.0 entre TeamViewer y Okta
Genera un token de script en TeamViewer

Configuración del endpoint SCIM

La aplicación OIN ya incluye la siguiente configuración:

Configuración	Valor
URL base del conector SCIM	https://webapi.teamviewer.com/scim/v2
Campo de identificador único	nombreDeUsuario (formato de correo electrónico)
Autenticación	Encabezado HTTP (token Bearer)

Paso 1: Crea un token de script

Inicia sesión en la aplicación web o el cliente de escritorio de TeamViewer.
Ve a Configuración (Settings) > Aplicaciones y tokens (Apps & Tokens).
Selecciona Crear aplicación o token (Create app or token).
Selecciona Crear token de script (Create script token).

Ingresa un nombre y una descripción opcional.
Selecciona los permisos de token requeridos.

Permisos de token

Categoría	Permisos para habilitar
Gestión de usuarios	crea usuarios, editar usuarios, ver usuarios
Gestión de usuarios (solo si también aprovisiona administradores de la empresa)	crea administradores de la empresa, editar administradores de la empresa
Administración de grupos (obligatorio para Group Push)	crea grupos, editar grupos, eliminar grupos, leer grupos

Haz clic en Guardar (Save).

Abre el menú de tokens y selecciona Copiar token (Copy token). Pegaremos este valor en Okta en el paso 2

Paso 2: Habilita la integración de API (aprovisionamiento) en Okta

Abre la aplicación TeamViewer en la Consola de administración de Okta.
Abre la pestaña Provisioning.
Haz clic en Configure API Integration.

Habilita API Integration.
Pega el token del script (generado en el paso 1) en el campo API Token.
Opcionalmente, habilita Import Groups.
Haz clic en Test API Credentials.
Haz clic en Save.

Paso 3: Habilita las acciones de aprovisionamiento

En la pestaña Provisioning , abre To App.
Haz clic en Edit.
Habilita:
1. Create Users
2. Set password when creating new users
3. Update User Attributes
4. Deactivate Users
Haz clic en Save.

Opcional:

Abra la pestaña Import .
Ejecute una importación de usuarios para sincronizar los usuarios existentes de TeamViewer.

Paso 4: Configura el identificador de cliente

Abre la pestaña Provisioning.
Ve a TeamViewer Attribute Mappings.
Edita TeamViewer SSO Customer Identifier (ssoCustomerId).
Selecciona Same value for all users.
Introduce tu identificador de cliente de SSO.
Establece Apply on en Create and update.
Haz clic en Save.

Paso 1: Crea un token de script

Inicia sesión en la aplicación web o el client de escritorio de TeamViewer.
Ve a Configuración (Settings) > Aplicaciones y tokens (Apps & Tokens).
Selecciona Crear aplicación o token (Create app or token).
Selecciona Crear token de script (Create script token).

Introduce un nombre y una descripción opcional.
Selecciona los permisos de token necesarios.

Permisos de token

Categoría	Permisos para habilitar
Gestión de usuarios	crea usuarios, editar usuarios, ver usuarios
Gestión de usuarios (solo si también aprovisiona administradores de la empresa)	crea administradores de la empresa, editar administradores de la empresa
Administración de grupos (obligatorio para Group Push)	crea grupos, editar grupos, eliminar grupos, leer grupos

Haz clic en Guardar (Save).

Abre el menú de tokens y selecciona Copiar token (Copy token). Pegaremos este valor en Okta en el paso 2

Paso 2 – Habilita el aprovisionamiento SCIM

1. Abre tu aplicación de OKTA.

2. Ve a la pestaña General.

3. Haz clic en Editar la configuración de la aplicación.

4. Habilita SCIM junto a la sección Provisioning, luego haz clic en Save.

5. En la pestaña Provisioning, selecciona Edit e introduce la siguiente información en los campos:

Campos	Información por ingresar
URL base del conector SCIM	https://webapi.teamviewer.com/scim/v2
Campo de identificador único para usuarios	nombreDeUsuario

6. Selecciona Push New Users, Push Profile Updates y Push Groups.

7. Cambia Authentication Mode a HTTP Header.

8. Introduce tu token SCRIPT que creaste anteriormente en la consola de administración de TeamViewer junto a Authorization.

9. Una vez completado, puedes hacer clic en Test Connector Configuration y, a continuación, en Save.

La configuración completada debería verse así:

10. Edita tu Aprovisionamiento nuevamente y marca las casillas Create Users, Update User Attributes, Deactivate Users y Sync Password checkbox, luego haz clic en Save.

Paso 3: Habilita las acciones de aprovisionamiento

Abre la pestaña Provisioning.
En To App, haz clic en Edit.
Habilita:
1. Create Users
2. Update User Attributes
3. Deactivate Users
4. Sync Password
Haz clic en Save.

Opcional:

En To Okta, habilita:

Import New Users
Import Profile Updates

Paso 4: Agrega el atributo SCIM de identificador del cliente

Después de seguir los pasos anteriores, los parámetros de SCIM deben adaptarse para incluir el identificador del cliente.

1. Ve a Applications.

2. Abre la aplicación correspondiente.

3. Cambia a la pestaña Provisioning y desplázate hacia abajo hasta Attribute Mapping.

4. Presiona Go to Profile Editor.

5. Haz clic en + Add atribute.

6. Establece las siguientes variables donde el nombre externo y el espacio de nombres externo no deben cambiarse:

Campos	Información que se debe introducir
Nombre para mostrar	ssoCustomerId
Nombre de variable	ssoCustomerId
Nombre externo	ssoCustomerId
Espacio de nombres externo	urn:ietf:params:scim:schemas:extension:teamviewer:1.0:SsoUser
Longitud del atributo	Mayor que 0
Atributo requerido	Sí
Tipo de atributo	Personal
Permiso del usuario (No es obligatorio, pero se recomienda)	Ocultar

7. Abre Mappings para esa aplicación.

8. Cambia a Okta User to App.

9. Establece el identificador del cliente, utilizado también para el SSO, como un valor estático.

10. Aplica las actualizaciones ahora.

11. En la aplicación proporcionada, haz clic en Provisioning, y el atributo recién creado debería ser visible.

12. Edita el atributo para aplicar el valor solo en Create.

Los usuarios aprovisionados recientemente ahora deberían poder iniciar sesión directamente a través de su cuenta de Okta.

Inserción de grupos

La inserción de grupos permite a los administradores sincronizar grupos de Okta con grupos de TeamViewer.

Cómo funciona

Abre la aplicación TeamViewer en Okta.
Ve a Push Groups.
Haz clic en Push Groups.
Selecciona los grupos que deseas sincronizar.
Completa la configuración de la inserción.

Operaciones compatibles:

Crear grupos
Renombrar grupos
Actualizar membresías
Eliminar grupos

Resolución de problemas de la inserción de grupos

Los usuarios deben estar asignados a la aplicación TeamViewer antes de que las membresías de grupo puedan sincronizarse
Aprovisiona a los usuarios antes o al mismo tiempo que la sincronización de grupos
Elimina un grupo sincronizado solo elimina el grupo y no desactiva a los usuarios

Limitaciones conocidas

Las direcciones de correo electrónico deben ser únicas en todas las cuentas de TeamViewer
El aprovisionamiento puede fallar si la dirección de correo electrónico ya existe en otra cuenta de TeamViewer
Los usuarios se desactivan, no se eliminan
El reaprovisionamiento de un usuario previamente desactivado puede fallar porque la cuenta subyacente todavía existe

Soporte

Si experimentas problemas con el aprovisionamiento SCIM, ponte en contacto con el equipo de Soporte de TeamViewer.

TeamViewer Remote

TeamViewer Tensor

TeamViewer DEX

TeamViewer Frontline

Plataforma TeamViewer ONE

Base de Conocimientos

Integración de Okta - Configuración de SCIM

Requisitos

Funciones compatibles

Requisitos previos

Configuración del endpoint SCIM

Permisos de token

Permisos de token

Inserción de grupos

Cómo funciona

Resolución de problemas de la inserción de grupos

Limitaciones conocidas

Soporte