Búsqueda

Pregúntame cualquier cosa

Guía de configuración de ClickUp con SCIM de Okta

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 añadirse como opción en Okta, lo que facilita incorporar roles personalizados en los flujos de trabajo existentes.

Antes de configurar el aprovisionamiento, necesitas tener Okta SSO habilitado en tu Entorno de trabajo.

Okta SSO solo está disponible para los Entornos de trabajo con el 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 de ClickUp en Okta está preconfigurada para aprovisionar administradores, miembros e invitados. Para aprovisionar miembros con acceso limitado, desplázate hasta la siguiente sección.

Para configurar Okta SCIM:

  1. Una vez habilitado 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 utilizas Okta, seguirás necesitando el URI de audiencia (ID de entidad SP) y la URL de inicio de sesión único (ACS URL) que aparecen tras integrar correctamente el SSO. Si SCIM no es compatible con la integración oficial de SSO de ClickUp de tu IdP, deberás usar el SAML personalizado en su lugar.

      Screenshot of Okta configuration in ClickUp.png

  2. En la barra lateral izquierda del panel de Okta, haz clic en Aplicaciones y selecciona Aplicaciones.
  3. Selecciona la aplicación de 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 quieres habilitar.
  12. Asigna personas a la aplicación y finaliza la configuración.
  13. Al asignar usuarios o grupos, asigna el atributo de rol de ClickUp. Si este atributo no está definido, todos tendrán por defecto el rol de miembro.

Aprovisionar miembros con acceso limitado

Para aprovisionar el rol de usuario de miembro con acceso limitado, un administrador de Okta tiene que hacer algunos cambios.

Para aprovisionar el rol de usuario de miembro con acceso limitado:

  1. En tu panel de Okta, ve a Directory y elige Editor de perfiles.

    Screenshot highlighting the Profile Editor button.png

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

    Screenshot of the clickup role row.png

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

    Screenshot of the limiter member value.png

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

Acciones disponibles con Okta SCIM

Puedes realizar las siguientes acciones con Okta SCIM:

Acción Descripción
Enviar nuevos usuarios Los nuevos usuarios creados a través de Okta también se crean en la aplicación de terceros.
Enviar nuevo grupo Los nuevos grupos creados a través de Okta también se crean como Equipos dentro de ClickUp. Cuando se crea un equipo a través de Okta, en la columna de origen de la página Equipos aparece Aprovisionado por SCIM. Los equipos creados manualmente muestran Manual en la columna de origen.
Asegúrate de activar la importación de grupos en la pestaña Aprovisionamiento para usar SCIM con grupos.
Enviar actualizaciones de perfil Las actualizaciones del perfil del usuario realizadas a través de Okta también se aplican en la aplicación de terceros.
Desactivar usuarios Desactivar o deshabilitar el acceso del usuario a la aplicación a través de Okta también desactiva al usuario en la aplicación de terceros. Cuando los usuarios se desactivan en Okta, se eliminan del Entorno de trabajo de ClickUp asociado. Los usuarios no podrán acceder a nada en ese Entorno de trabajo, pero sus datos seguirán estando disponibles como «usuario inactivo». En las respuestas SCIM no devolvemos ningún dato de los usuarios desactivados, salvo su estado de desactivación.
En esta aplicación, desactivar a un usuario significa retirarle el acceso para iniciar sesión, pero conservar su información como usuario inactivo.
Reactivar usuarios Las cuentas de usuario se pueden reactivar en la aplicación.

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 habituales son un token de API de SCIM caducado 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 tu 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 pasados 60 segundos. No es necesaria ninguna acción a menos que los fallos 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 el SSO se ha desvinculado, 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, después, cambia el correo electrónico en ClickUp.
  3. Si has hecho que la autenticación SSO sea opcional, vuelve a exigirla.
  4. Comprueba que el usuario puede iniciar sesión en ClickUp mediante SSO.

El correo electrónico puede usarse como valor nameID en Okta. Si cambias el valor nameID, tendrás que volver a vincular tu cuenta SSO una vez que hayas cambiado el correo electrónico en Okta y en ClickUp.

Asignación del campo Manager

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

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

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

Establece Aplicar en como Crear y actualizar para mantener la información del responsable siempre sincronizada. 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 de forma gradual para todos los entornos de trabajo Enterprise:

Atributo Descripción
Departamento El departamento del usuario dentro de la organización.
Región La región geográfica del usuario.

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