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 Agentes 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.
- El límite de velocidad para esta API es de 4 peticiones por segundo, si encuentra un código de estado de respuesta 429 (demasiadas peticiones), vuelva a intentarlo en el siguiente segundo.
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 pulse enter.
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 URL" [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.
Nota: Si el campo Role está vacío, Talkdesk va a crear el usuario con el rol de Agente predeterminado.
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 Save [11].
Cómo Obtener Acceso a la SCIM API
La configuración y la habilitación son realizadas por Talkdesk. Póngase en contacto con nosotros si desea empezar a utilizar 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.