SCIM 2.0, el estándar abierto System for Cross-domain Identity Management, permite gestionar la información de identidad del usuario entre sistemas en la nube. Talkdesk® permite gestionar los usuarios de forma automática y simplificada a través del protocolo SCIM 2.0.
A través de la SCIM API, Talkdesk recibe la siguiente información del usuario y crea el usuario a partir de: su nombre, apellidos y dirección de correo electrónico. De forma predeterminada, el estado del usuario es "active", lo que significa que la licencia se consume automáticamente en el suministro.
Antes de iniciar la configuración, asegúrese de que las credenciales necesarias para proporcionar el servicio estén disponibles (token OAuth) y de que haya suficientes licencias en Talkdesk para todos los usuarios. Si al final del procedimiento algunos usuarios tienen el estado "Deactivated" en la consola Microsoft ADFS, puede deberse a que no hay licencias para todos los usuarios nuevos. En este caso, consulte la información completa en Agents y Licencias.
Para agregar o eliminar usuarios a través de SCIM 2.0 con OneLogin en Talkdesk, siga estos pasos:
Nota: La SCIM API no funciona para crear usuarios de Talkdesk Phone.
1. Inicie sesión en su cuenta OneLogin y seleccione Applications [1].
2. Vaya a la barra de búsqueda [2]. Añada el suministro SCIM w/SAML (SCIM v2 con OAuth y Scope) o el suministro SCIM w/SAML (SCIM v2 con OAuth) y presione Intro.
3. Agregue un "Display Name" [3] en la sección "Portal".
4. Escriba https://api.talkdeskapp.com/scim/v2 en el campo "SCIM Base URL" [4], en la sección "Application Details".
5. Desplácese hacia abajo y rellene la siguiente información:
- "Client Id"[5].
- "Client Secret" [6].
- En el campo "Site" introduzca https://<account_name>.talkdeskid.com [7].
- Pegue /oauth/token en «Token URI» [8].
- En "Authorization URL" [9] añada https://<account_name>.talkdeskid.com/oauth/authorize.
{
"schemas": [
"urn:scim:schemas:core:2.0",
"urn:ietf:params:scim:schemas:extension:Talkdesk:2.0:User"
]
"userName": "{$user.email}",
"name": {
"givenName": "{$user.firstname}",
"familyName": "{$user.lastname}"
},
"active": "{$user.active}"
}
6. Copie el «schema» anterior.
{
"schemas": [
"urn:scim:schemas:core:2.0",
"urn:ietf:params:scim:schemas:extension:Talkdesk:2.0:User"
]
"userName": "{$user.email}",
"name": {
"givenName": "{$user.firstname}",
"familyName": "{$user.lastname}"
},
"active": "{$user.active}",
"urn:ietf:params:scim:schemas:extension:Talkdesk:2.0:User": {
"rolesString": "{$parameters.rolesString}"
}
}
7. Como alternativa, si desea asignar el rol al usuario a través de SCIM, deberá usar el esquema anterior.
8. Desplácese hacia abajo hasta la sección "API Connection" y pegue la información del "schema" en "SCIM JSON Template" [10].
9. Pulse en Save [11].
Cómo Obtener Acceso a la SCIM API
Por ahora, esta característica solo está disponible a pedido. Comuníquese con su Customer Success Manager para habilitar esta función.
Renovación de Tokens
Talkdesk SCIM API ofrece una integración lista para usar con OneLogin.
Para la SCIM API, la duración predeterminada del token para el cliente OAuth de la SCIM API es de 30 días. Esto significa que deberá renovar el token cada 30 días realizando los siguientes pasos:
1. Inicie sesión en su cuenta OneLogin y seleccione Administration [1].
2. En el menú de la barra superior, vaya a Applications > Applications [2] y seleccione su aplicación SCIM.
3. En el menú de la barra lateral, vaya a Configuration [3].
4. Desplácese hacia abajo hasta la sección "API Connection" y haga clic en Authenticate [4].
5. En el cuadro de diálogo que aparece, haga clic en el enlace e inicie sesión en su cuenta de Talkdesk.