Descripción general
El aprovisionamiento SCIM automatiza la gestión de usuarios y grupos entre Okta y ThingLink.
Con el aprovisionamiento SCIM, Okta puede crear usuarios, actualizar sus datos, desactivar usuarios, crear grupos y mantener sincronizada la pertenencia a grupos en ThingLink.
El aprovisionamiento SCIM no gestiona cómo inician sesión los usuarios. La autenticación se gestiona por separado mediante el inicio de sesión único de Okta, que debe configurarse antes de configurar SCIM. Consulta Activar el inicio de sesión único de Okta para ver las instrucciones de configuración.
¿Por qué usar el aprovisionamiento SCIM?
Con el aprovisionamiento SCIM, el acceso de los usuarios se gestiona desde Okta en lugar de manualmente en ThingLink. Esto reduce la administración manual de cuentas y ayuda a mantener sincronizados el acceso y la pertenencia a grupos.
Si usas grupos de Okta para gestionar el acceso, también puedes enviar (push) esos grupos a ThingLink. Así puedes usar los grupos de ThingLink para compartir contenido automáticamente con los usuarios adecuados. Consulta este artículo para obtener más información.
Cómo configurar el aprovisionamiento SCIM
Requisitos previos
Asegúrate de que:
- Ya has configurado el inicio de sesión único de Okta para tu organización de ThingLink.
- Tienes una cuenta de administrador en ThingLink.
- Tienes una cuenta de administrador de Okta con permiso para añadir aplicaciones y configurar el aprovisionamiento.
Paso 1: Activa SCIM en ThingLink
En ThingLink, ve a Organización > Integraciones > Aprovisionamiento SCIM.
Haz clic en Activar y configurar.
Copia Endpoint URL y Secret token. Los necesitarás más adelante.
Paso 2: Configura el aprovisionamiento en Okta
Añade la aplicación SCIM en Okta
- En Okta Admin Console, ve a Applications > Applications.
- Haz clic en Browse App Catalog.
- Busca SCIM 2.0 Test App (OAuth Bearer Token):
- Selecciona la aplicación y haz clic en Add Integration.
Configura los ajustes generales
Configura los ajustes generales:
- Application label: Introduce un nombre descriptivo, como ThingLink SCIM.
- Application visibility: Marca la casilla para ocultar la aplicación a los usuarios. Esta aplicación solo se usa para el aprovisionamiento. Los usuarios deben acceder a ThingLink a través de la aplicación SSO de Okta.
- Browser plugin auto-submit: Déjalo desactivado.
- Haz clic en Next.
Configura las opciones de inicio de sesión
Esta aplicación no se usará para iniciar sesión, por lo que estos ajustes no deberían afectar a cómo acceden tus usuarios a ThingLink.
- En Sign-On Options, selecciona Secure Web Authentication.
- Selecciona User sets username and password.
- Los ajustes de inicio de sesión no se usan para el aprovisionamiento SCIM de ThingLink. Si Okta requiere una Login URL, introduce https://www.thinglink.com/login. No uses aquí la URL de callback de OIDC.
- Deja el resto de los ajustes de inicio de sesión (Credential Details) con sus valores predeterminados y termina de crear la aplicación.
Haz clic en Done para finalizar la configuración inicial.
Configura la integración de la API
- Abre la aplicación ThingLink SCIM en Okta.
- Ve a Provisioning > Configure API Integration.
- Selecciona Enable API Integration.
- Introduce los siguientes valores:
- SCIM 2.0 Base URL: Pega la Endpoint URL copiada de ThingLink.
- OAuth Bearer Token: Pega el Secret token copiado de ThingLink.
- Deja activado Import Groups.
- Haz clic en Test API Credentials. Si la prueba se realiza correctamente, haz clic en Save.
Configura los ajustes de aprovisionamiento
- Ve a Provisioning > To App y haz clic en Edit.
- Activa las siguientes opciones:
- Create Users
- Update User Attributes
- Deactivate Users
- Deja desactivado Sync Password.
- Guarda los cambios.
Revisa las asignaciones de atributos
- En la misma pestaña Provisioning > sección To App, desplázate hasta las asignaciones de atributos SCIM.
- ThingLink solo necesita los atributos de usuario básicos para identificar y mostrar a los usuarios. Mantén activadas las siguientes asignaciones:
- userName
- displayName
- Given Name
- Family Name
- Elimina cualquier asignación adicional, salvo que tu contacto de ThingLink te haya indicado lo contrario.
Paso 3: Asigna usuarios y grupos
Asigna usuarios y grupos
Ve a la pestaña Assignments de la aplicación ThingLink SCIM. Asigna los usuarios y grupos que deben aprovisionarse en ThingLink.
Las asignaciones de la aplicación SCIM son independientes de las de la aplicación SSO de Okta. Asignar un usuario a la aplicación SSO de Okta le permite iniciar sesión, pero no lo asigna automáticamente a la aplicación SCIM.
Cuando se asigna un usuario a la aplicación SCIM, Okta lo aprovisiona en ThingLink. Si se anula la asignación de un usuario a la aplicación SCIM, su cuenta de ThingLink se desactiva, salvo que siga asignado mediante otro grupo o asignación.
Opcional: Configura Push Groups
Para crear grupos de ThingLink y mantener sincronizada la pertenencia a grupos, configura Push Groups en Okta:
- En la aplicación ThingLink SCIM, ve a Push Groups.
- Haz clic en Push Groups.
- Selecciona el grupo de Okta que quieres enviar a ThingLink.
- Confirma el nombre del grupo y guarda la configuración del grupo push.
- Repite este paso para cada grupo que deba crearse y gestionarse en ThingLink.
Al asignar un grupo a la aplicación SCIM, se aprovisionan los usuarios de ese grupo. Push Groups es necesario si además quieres que Okta cree el grupo correspondiente en ThingLink y mantenga sincronizada su pertenencia.
Los grupos push deben ser distintos de los grupos de asignación. Consulta las páginas siguientes para obtener más orientación de Okta:
- Okta Identity Engine: https://help.okta.com/oie/en-us/content/topics/users-groups-profiles/app-assignments-group-push.htm
- Okta Classic Engine: https://help.okta.com/en-us/content/topics/users-groups-profiles/app-assignments-group-push.htm
Cómo funciona el aprovisionamiento
Usuarios
Cuando se asigna un usuario a la aplicación ThingLink SCIM en Okta, ThingLink le crea una cuenta de usuario.
Las cuentas aprovisionadas se crean con el nivel de acceso más bajo disponible en tu organización: Alumno o Estudiante, según el tipo de organización y la suscripción. Actualmente no se admite el aprovisionamiento de distintos roles de ThingLink mediante SCIM.
Si se anula la asignación de un usuario a la aplicación SCIM, su cuenta de ThingLink se desactiva. Las cuentas no se eliminan por completo para evitar la pérdida de contenido o datos.
Grupos
Puedes usar los grupos de Okta para gestionar asignaciones de forma masiva. Además, Okta puede enviar grupos a ThingLink y mantener sincronizada su pertenencia.
Usa Push Groups cuando quieras que los grupos de ThingLink se creen y gestionen automáticamente a partir de los grupos de Okta.
Solución de problemas
Si el aprovisionamiento no funciona como esperabas:
Comprueba que la Endpoint URL y el Secret token se copiaron correctamente de ThingLink.
Haz clic en Test API Credentials en Okta para confirmar que Okta puede conectarse a ThingLink.
Revisa los ajustes de aprovisionamiento en Provisioning > To App y confirma que Create Users, Update User Attributes y Deactivate Users están activados.
Revisa si hay errores en los registros de aprovisionamiento de Okta.
Asegúrate de que los usuarios y grupos correspondientes están asignados a la aplicación SCIM, no solo a la aplicación SSO de Okta.
Asegúrate de que Push Groups está configurado si esperas que los grupos y la pertenencia a ellos aparezcan en ThingLink.
Si el problema continúa, ponte en contacto con el soporte de ThingLink.
Limitaciones y notas
- El aprovisionamiento SCIM y el inicio de sesión único de Okta se configuran por separado.
- Actualmente no se admite la asignación de roles. Los nuevos usuarios se aprovisionan con el nivel de acceso más bajo disponible en tu organización.
- Asegúrate de que tu licencia de ThingLink tenga suficientes plazas de usuario para los usuarios que piensas aprovisionar.
- Si un usuario ya tiene una cuenta de ThingLink independiente que no está conectada a tu licencia, es posible que el aprovisionamiento SCIM no mueva esa cuenta a tu organización automáticamente. Puede que primero haya que añadir o invitar al usuario a tu licencia.
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.