Resumen
El token de API de SCIM (SCIM API token) autentica a su proveedor de identidad ante KnowledgeCity para que pueda aprovisionar, actualizar y desactivar automáticamente cuentas de usuario y grupos. Desde el área de Integrations puede copiar la SCIM API URL y su token, y generar un token nuevo cada vez que necesite rotar credenciales. Regenerar el token emite un secreto nuevo y reemplaza al anterior para que la conexión se mantenga segura.
Introducción
El aprovisionamiento SCIM (System for Cross-domain Identity Management) permite que su proveedor de identidad cree, actualice y desactive cuentas y ajuste la membresía de grupos en KnowledgeCity automáticamente, de modo que el ciclo de vida de las cuentas refleje su directorio sin introducción manual de datos. Para hacer esto, su proveedor de identidad se conecta a un endpoint de la API de SCIM (URL) y se autentica con un token de API de SCIM.
Esta función la utilizan administradores y responsables de integraciones, las personas encargadas de aprovisionar el acceso y mantener la conexión entre su proveedor de identidad y KnowledgeCity. Regenerar el token resuelve el problema de rotar credenciales según un calendario o de reemplazar un token que cree que puede haberse expuesto, todo sin salir de la configuración de Integrations.
Conceptos clave
- SCIM provisioning (aprovisionamiento SCIM): creación, actualización y desactivación automática de cuentas de usuario y su membresía de grupo, impulsada por su proveedor de identidad para que las cuentas se mantengan sincronizadas con su directorio.
- SCIM API URL: el endpoint al que se conecta su proveedor de identidad para enviar solicitudes de aprovisionamiento a KnowledgeCity.
- SCIM API token: la credencial secreta que su proveedor de identidad presenta para autenticar sus solicitudes a la API de SCIM; trátela como una contraseña.
- Copy (copiar): la acción que coloca la SCIM API URL o el token en su portapapeles para que pueda pegarlo en la configuración de su proveedor de identidad.
- Regenerating the token (regenerar el token): emitir un nuevo token de API de SCIM que reemplaza al anterior, de modo que el token antiguo deja de funcionar y solo el nuevo valor permanece válido.
- Credential rotation (rotación de credenciales): la práctica de reemplazar periódicamente un token, o reemplazarlo inmediatamente si puede haberse expuesto, para reducir el riesgo de acceso no autorizado.
Pasos a seguir
Abrir la configuración de Integrations
Inicie sesión como administrador y abra el área de Integrations desde la configuración de su cuenta. Aquí es donde se gestionan los detalles de conexión SCIM de su cuenta, junto con su otra configuración de integraciones.
Copiar la SCIM API URL
Localice la SCIM API URL y use la acción Copy para colocarla en su portapapeles. Pegue este valor en la configuración de aprovisionamiento de su proveedor de identidad para que sepa a qué endpoint enviar las solicitudes.
Copiar el token de API de SCIM actual
Localice el SCIM API token y use la acción Copy para colocarlo en su portapapeles. Péguelo en su proveedor de identidad junto con la URL para que pueda autenticar sus solicitudes de aprovisionamiento. Mantenga este valor fuera de correos electrónicos, foros públicos y código del lado del cliente, porque cualquiera que lo posea puede actuar contra su endpoint de SCIM.
Generar un nuevo token de SCIM
Cuando esté rotando credenciales según un calendario, o sospeche que el token actual ha sido expuesto, genere un nuevo token de SCIM. Regenerar el token emite un secreto nuevo y reemplaza al anterior, lo que significa que el token antiguo deja de funcionar. Debido a que esto invalida el valor anterior, cualquier sistema que todavía use el token antiguo perderá el acceso hasta que se actualice.
Actualizar su proveedor de identidad con el nuevo token
Después de generar el nuevo token, cópielo y péguelo en la configuración SCIM de su proveedor de identidad, reemplazando el valor antiguo. Guarde la configuración en el lado del proveedor de identidad para que el aprovisionamiento continúe sin interrupciones. Es una buena práctica confirmar que la sincronización de usuarios y grupos siga funcionando después del cambio.
Conclusión
La SCIM API URL y el token conectan a su proveedor de identidad con KnowledgeCity para que el aprovisionamiento de usuarios y grupos se mantenga automático y preciso. Copiar estos valores establece la conexión, y generar un token nuevo le permite rotar credenciales de forma segura. Solo recuerde que un token nuevo reemplaza al anterior, así que actualice su proveedor de identidad con prontitud para evitar una interrupción en el aprovisionamiento.