Los entornos de trabajo que dependen de Okta para el aprovisionamiento pueden usar roles personalizados para integrarse completamente con Okta. Cualquier rol creado en ClickUp puede agregarse como opción dentro de Okta, lo que facilita la integración de roles personalizados en los flujos de trabajo existentes.

Antes de configurar el aprovisionamiento, debes tener Okta SSO habilitado para tu entorno de trabajo.

Okta SSO solo está disponible para los entornos de trabajo del plan Enterprise.

Solo los propietarios y administradores del entorno de trabajo pueden habilitar Okta SSO.

Solo los administradores de Okta pueden configurar Okta SCIM.

Configurar Okta SCIM y aprovisionar administradores, miembros e invitados

La aplicación ClickUp en Okta está preconfigurada para aprovisionar administradores, miembros e invitados. Para aprovisionar miembros limitados, desplázate a la siguiente sección.

Para configurar Okta SCIM:

1. Después de habilitar Okta SSO, verás una URL base de SCIM y un token de API de SCIM.
   • Si tu proveedor de identidad (IdP) es compatible con SCIM pero no estás usando Okta, también necesitarás el URI de audiencia (ID de entidad SP) y la URL de inicio de sesión único (URL ACS) que aparecen después de integrar SSO correctamente. Si SCIM no es compatible con la integración oficial de Okta SSO de tu IdP, debes usar SAML personalizado en su lugar.

     

2. En la barra lateral izquierda del panel de Okta, haz clic en Aplicaciones y selecciona Aplicaciones.
3. Selecciona la aplicación ClickUp y haz clic en la pestaña Aprovisionamiento.
4. Marca la casilla Habilitar funciones de aprovisionamiento.
5. Haz clic en Configurar integración de API.
6. Marca la casilla Habilitar integración de API.
7. Copia y pega la URL base de SCIM y el token de API de SCIM del paso 1.
8. Haz clic en Probar credenciales de API. Si se realiza correctamente, aparece un mensaje de verificación.
9. Haz clic en Guardar.
10. En el panel izquierdo, selecciona A la aplicación.
11. Elige las Funciones de aprovisionamiento que deseas habilitar.
12. Asigna personas a la aplicación y termina la configuración.
13. Al asignar usuarios o grupos, asigna el atributo Rol de ClickUp. Si no se define este atributo, todos tendrán el rol de miembro de forma predeterminada.

Aprovisionar miembros limitados

Para aprovisionar el rol de usuario de miembro limitado, un administrador de Okta debe realizar algunas actualizaciones.

Para aprovisionar el rol de usuario de miembro limitado:

1. En tu panel de Okta, ve al Directorio y elige Editor de perfiles.

   

2. Haz clic en el perfil de ClickUp.
3. Se te redirige a la página de Atributos.
4. En la fila Rol de ClickUp, en el extremo derecho, haz clic en el icono de lápiz.

   

5. En la página Miembros del atributo, en la sección Nombre para mostrar, haz clic en Agregar otro.
6. En el cuadro de texto Nombre para mostrar, escribe Miembro limitado.
7. A la derecha del nombre para mostrar, en la columna Valor, escribe 100.

   

8. En la esquina inferior derecha, haz clic en Guardar atributo.
9. El rol de usuario de miembro limitado ya está disponible como opción al aprovisionar usuarios en ClickUp.

Acciones que puedes realizar con Okta SCIM

Puedes realizar las siguientes acciones con Okta SCIM:

Solucionar problemas con el envío de actualizaciones de perfil

Al usar el envío de actualizaciones de perfil en usuarios existentes, es posible que encuentres los siguientes errores en el registro del sistema de Okta:

• TEAM_749 Unauthorized: Okta intentó enviar una actualización de perfil a ClickUp, pero la solicitud fue rechazada. Las causas más comunes son un token de API de SCIM vencido o no válido, o que el usuario de destino no esté correctamente vinculado entre Okta y ClickUp. Para resolverlo, regenera tu token de API de SCIM en ClickUp, actualízalo en la configuración de integración de Okta y vuelve a intentar el envío del perfil.
• Rate limit exceeded: Enviar actualizaciones de perfil para muchos usuarios a la vez puede activar la limitación de velocidad. Estas operaciones se reintentan automáticamente después de 60 segundos. No se requiere ninguna acción a menos que los errores persistan tras varios reintentos.

Cambiar o actualizar una dirección de correo electrónico

Cuando se crean nuevos usuarios con la acción Enviar nuevos usuarios, Okta crea un nombre de usuario y un correo electrónico, pero no una contraseña. Si un usuario queda bloqueado porque SSO se desvincula, un propietario o administrador debe seguir estos pasos:

1. Si exiges el uso de SSO para este usuario, haz que la autenticación SSO sea temporalmente opcional.
2. Cambia el correo electrónico en Okta y luego cámbialo en ClickUp.
3. Si hiciste que la autenticación SSO fuera opcional, vuelve a exigirla.
4. Verifica que el usuario pueda iniciar sesión en ClickUp mediante SSO.

El correo electrónico puede usarse como valor nameID en Okta. Si cambias el valor nameID, deberás volver a vincular tu cuenta SSO después de haber actualizado el correo electrónico en Okta y en ClickUp.

Mapeo del campo Responsable

El atributo Responsable está disponible para todos los entornos de trabajo Enterprise.

En Okta, abre la tabla de mapeos de atributos de ClickUp y verás la fila Responsable configurada como manager.value. Así es como Okta apunta al responsable de cada persona.

El campo manager.value debe contener la dirección de correo electrónico del responsable que coincida con la de su cuenta de ClickUp, o bien su ID de usuario de ClickUp. Los nombres para mostrar como "John Smith" no se aceptan y causarán errores de aprovisionamiento.

Configura Aplicar en como Crear y actualizar para mantener sincronizada la información del responsable. Una vez configurado, el responsable de cada persona aparece en la página de resumen de personas en Teams Hub.

Atributos adicionales

Los siguientes atributos también están disponibles y se están publicando gradualmente para todos los entornos de trabajo Enterprise:

Cuando se configuran estos atributos, también se muestran en la página de resumen de personas en Teams Hub.