Guía de configuración personalizada de SAML SCIM a través de Entra ID

Las aplicaciones SAML personalizadas creadas en Microsoft Entra ID ofrecen un aprovisionamiento automático limitado, que incluye la creación y eliminación de usuarios.

Microsoft Entra ID anteriormente se llamaba Azure.

Lo que necesitarás

  • Antes de configurar el aprovisionamiento, debes tener SAML personalizado habilitado en tu Entorno de trabajo.
  • Solo los administradores de Entra ID pueden configurar SCIM de Entra ID.
  • El aprovisionamiento requiere una aplicación personalizada fuera de la galería en Microsoft Entra ID. La aplicación de la galería ClickUp Productivity Platform no es compatible con SCIM y no puede aprovisionar grupos.

Configurar una aplicación SAML personalizada de Microsoft Entra ID

Para configurar la aplicación SAML personalizada:

  1. Crea una nueva aplicación SAML personalizada en Microsoft Entra ID. No es la aplicación oficial de ClickUp en la galería de Microsoft Entra ID ClickUp Productivity Platform.

Captura de pantalla de alguien configurando una nueva aplicación SAML personalizada en Microsoft Entra ID.

  1. En ClickUp, en la esquina superior izquierda, haz clic en el avatar de tu Entorno de trabajo.
  2. Selecciona Ajustes.
  3. En la barra lateral Todos los ajustes, haz clic en Seguridad y permisos.
  4. En la sección Inicio de sesión único (SSO), selecciona SAML.

    Captura de pantalla de la opción SAML en los ajustes de Seguridad y permisos de ClickUp.

  5. Para una nueva aplicación de Microsoft Entra ID, copia el ID de entidad de SP desde ClickUp.

    Captura de pantalla del ID de entidad de SP desde ClickUp.

  6. Pega el ID de entidad de SP de ClickUp en el campo Identificador (ID de entidad) de Microsoft Entra ID.

    Captura de pantalla de alguien pegando el ID de entidad de SP en el campo Identificador.

  7. Copia la URL de inicio de sesión único (URL de ACS) desde ClickUp y pégala en el campo URL de respuesta (URL del Servicio de consumidor de aserciones) de Microsoft Entra ID.
  8. Haz clic en Guardar en Microsoft Entra ID.

Captura de pantalla del botón Guardar en Microsoft Entra.

Vincular SSO en ClickUp

Una vez configurada la aplicación, puedes completar la conexión SSO en ClickUp:

  1. Asegúrate de que la persona que configura la integración SSO esté asignada en la aplicación Microsoft Entra ID. Puedes añadir a otras personas más adelante.
  2. Copia la URL de inicio de sesión y el Certificado público de IDP de Microsoft Entra ID.

Captura de pantalla de la URL de inicio de sesión y el certificado público de IDP en Microsoft Entra ID

  1. Pega estos valores en texto sin formato en los campos vacíos correspondientes de ClickUp al seleccionar el conector SAML.

    Captura de pantalla de un certificado.

    • Para obtener el certificado en texto sin formato, descarga el archivo y haz clic derecho sobre él para abrirlo con el editor de texto que prefieras. El texto empieza por -----BEGIN CERTIFICATE-----. Pega el valor de texto completo sin ninguna modificación en el campo Certificado público de IDP.
  2. Selecciona Guardar metadatos.

    Captura de pantalla del botón Guardar metadatos.

  3. Se te pedirá que completes la vinculación iniciando sesión con SSO. Si todo va bien, serás redirigido a ClickUp.
  4. En la página Seguridad y permisos de ClickUp, verás tres opciones nuevas:
    • URL base de SCIM: Introducirás esta información en el paso siguiente.
    • Token de API de SCIM: Introducirás esta información en el paso siguiente.
    • Política de inicio de sesión: Elige una de estas cuatro opciones:
    • Todos los usuarios deben usar autenticación SAML: Todos los usuarios de tipo miembro y de tipo invitado deben usar autenticación SAML.
    • Todos los usuarios excepto los invitados deben usar autenticación SAML: Los usuarios de tipo invitado no están obligados a usar autenticación SAML.
    • Todos los usuarios excepto los miembros limitados y los invitados deben usar autenticación SAML: Los miembros limitados y los miembros limitados de solo lectura, así como todos los usuarios de tipo invitado, no están obligados a usar autenticación SAML.
    • El uso de autenticación SAML es opcional: El uso de autenticación SAML es opcional para todos los usuarios.
  5. Ve al paso siguiente para aprovisionar al resto de personas de tu Entorno de trabajo.

Antes de aprovisionar grupos

Revisa estos límites antes de enviar grupos de Microsoft Entra ID a ClickUp:

  • El aprovisionamiento crea equipos nuevos. No puede vincular un grupo a un equipo que ya exista en tu Entorno de trabajo.
  • Los grupos anidados no son compatibles.
  • Cada usuario solo puede tener un rol de aplicación. El aprovisionamiento falla para un usuario que recibe un rol directamente y otro diferente a través de un grupo, o roles distintos a través de dos grupos.
  • Si usas roles de aplicación personalizados, cada grupo asignado necesita un rol. Los grupos sin rol no son compatibles.
  • Los invitados de solo vista añadidos a un equipo se convierten en invitados, lo que puede ocupar un puesto de pago. Revisa la pertenencia de los invitados en tus grupos antes de aprovisionarlos.
  • El aprovisionamiento no otorga a un equipo acceso a ningún Espacio, Carpeta, subcarpeta ni Lista.

Configurar el aprovisionamiento automático con ClickUp

Admitimos el aprovisionamiento de usuarios individuales y grupos con SCIM. Al aprovisionar grupos en ClickUp, los nuevos usuarios se aprovisionan como individuos, y tanto los usuarios nuevos como los existentes se añaden a un equipo de ClickUp. Si no quieres que estos usuarios se añadan a un equipo, elimina el equipo después del aprovisionamiento.

Al añadir un perfil de usuario a la aplicación SAML personalizada, ese usuario no será un usuario de ClickUp hasta que lo aprovisiones mediante SCIM.

El aprovisionamiento automático puede realizarse bajo demanda o en ciclos que se ejecutan cada 30 minutos de forma predeterminada. Los usuarios asignados a la aplicación solo se añadirán cuando se ejecute el siguiente ciclo de aprovisionamiento automático. Obtén más información sobre cómo funciona el aprovisionamiento de aplicaciones en Microsoft Entra ID.

Captura de pantalla del botón de aprovisionamiento bajo demanda

Para configurar el aprovisionamiento automático:

  1. En Microsoft Entra ID, abre la pestaña Aprovisionamiento y cambia el desplegable de Manual a Automático. Esto hará que aparezca la ventana Credenciales de administrador en la pestaña Aprovisionamiento.
    • Si quieres aprovisionar hasta cinco usuarios a la vez de forma manual, en la pestaña Aprovisionamiento selecciona Aprovisionar bajo demanda.

      Captura de pantalla de la ventana de credenciales de administrador en la pestaña Aprovisionamiento.

  2. Introduce la URL base de SCIM de tu página de Seguridad y permisos de ClickUp en el campo URL de inquilino.
  3. Introduce el token de API de SCIM de tu página de Seguridad y permisos de ClickUp en el campo Token secreto.
  4. Haz clic en Probar conexión.

    Captura de pantalla del botón de probar conexión.

  5. Cuando la prueba sea correcta, haz clic en Guardar.
  6. Desde la página de Aprovisionamiento, haz clic en Asignaciones. Comprueba que tanto Aprovisionar usuarios de Microsoft Entra ID como Aprovisionar grupos de Microsoft Entra ID estén activados. Si la asignación de grupos está desactivada, no se creará ningún equipo.
  7. Tras guardar, SCIM quedará configurado en tu Entorno de trabajo. Los usuarios podrán iniciar sesión en ClickUp con Microsoft Entra ID.

Selecciona los roles de usuario de ClickUp que quieres aprovisionar

El rol de usuario tiene como valor predeterminado miembro, a menos que selecciones los roles de usuario de ClickUp que quieres aprovisionar.

Para asignar Microsoft Entra ID a los roles de usuario de ClickUp:

  1. Como administrador, inicia sesión en el centro de administración de Microsoft Entra.
  2. Selecciona Identidad, Aplicaciones y, a continuación, Aplicaciones empresariales.
  3. En la página de aplicaciones empresariales, selecciona tu aplicación SAML.
  4. En la página de información general de la barra lateral izquierda, selecciona Aprovisionamiento.
  5. En la página de aprovisionamiento, haz clic en Asignaciones.
  6. Selecciona Aprovisionar usuarios de Microsoft Entra ID para ver una lista de atributos.
  7. Desplázate hasta la parte inferior de la página y marca la casilla Mostrar opciones avanzadas.
  8. Haz clic en Editar lista de atributos.

Captura de pantalla de alguien seleccionando Mostrar opciones avanzadas y Editar lista de atributos

  1. Desplázate hasta la última fila de la columna Nombre e introduce este atributo urn para los roles de usuario: urn:ietf:params:scim:schemas:extension:ClickUp:2.0:User:role.
  2. En el desplegable de la columna Tipo, comprueba que esté seleccionado Cadena.
  3. En la esquina superior izquierda, haz clic en Guardar.
    • Si el nombre no se guarda, selecciona Descartar e inténtalo de nuevo. Si el problema persiste, intenta restablecer las asignaciones a sus valores predeterminados.
  4. Se te redirigirá a la página Asignación de atributos.
  5. Selecciona Añadir nueva asignación.
  6. En la página Editar atributo, en el campo Tipo de asignación selecciona Constante.
    • Para asignar de forma dinámica, consulta la sección Aprovisionar roles de usuario dinámicamente más abajo.
  7. En Valor constante, introduce uno de los siguientes valores:
    • 2 para administradores.
    • 3 para miembros.
    • 4 para invitados.
    • 100 para miembros limitados.
    • {custom_role_id} para roles personalizados.
  8. En Atributo de destino, introduce urn:ietf:params:scim:schemas:extension:ClickUp:2.0:User:role.
  9. Haz clic en Aceptar y luego en Guardar.
  10. Cualquier usuario que aprovisiones adoptará ese rol de usuario de ClickUp.
    • Para asignar otro rol de usuario, empieza en el paso 5 y selecciona un valor constante diferente. Para asignar de forma dinámica, consulta la sección Aprovisionar roles de usuario dinámicamente más abajo.

También se pueden asignar los siguientes atributos:

Esquema Atributos de rol de usuario
Base id: user.id
userName: user.userName
name: user.givenName+""+familyName
active: user.active
emails: Array of emails with value property and primary (boolean) property.
title: user.title
manager: user.role
Extensión role: user.role
customRoleId: Introduce el ID del rol personalizado de ClickUp.
Para encontrar el ID del rol personalizado, envía la solicitud Obtener usuario desde la API de ClickUp. Este endpoint solo está disponible en los planes Enterprise.
customRoleName: Introduce el nombre del rol personalizado de ClickUp.
Enterprise
Estos atributos se están publicando de forma gradual en todos los Entornos de trabajo Enterprise.
Cuando se establecen estos atributos, también se muestran en la página de información general de personas en Teams Hub.
management chain
department: user.department
region: user.region

Aprovisionar roles de usuario de forma dinámica

Gestiona de forma dinámica los roles de usuario en ClickUp en función de los roles de usuario asignables en Entra. Para ello, se comparten dinámicamente los valores de rol con el atributo de destino. El resultado te permite asignar roles en Entra que se correspondan con roles de ClickUp, lo que simplifica el aprovisionamiento.

Para cambiar la asignación del atributo de destino de constante a expresión y aprovisionar roles de usuario de forma dinámica:

  1. En la página de información general de la barra lateral izquierda, selecciona Aprovisionamiento.
  2. En la página de aprovisionamiento, haz clic en Asignaciones y, a continuación, en Aprovisionar usuarios de Microsoft Entra ID.
    • Si aún no lo has hecho, desplázate hasta la última fila de la columna Nombre e introduce este atributo urn para los roles de usuario: urn:ietf:params:scim:schemas:extension:ClickUp:2.0:User:role.
  3. Selecciona Editar a la derecha del atributo urn.
  4. Elige el tipo de asignación de expresión y añade esta expresión: Switch(SingleAppRoleAssignment([appRoleAssignments]), "3", "ClickUpAdmin", "2", "ClickUpGuest", "4", "ClickUpLimitedMember", "100").
    • En esta expresión, 3 es el valor predeterminado, seguido de los pares clave-valor correspondientes al rol de Entra y al rol de ClickUp. Obtén más información sobre cómo escribir expresiones para asignaciones de atributos en Microsoft Entra ID.
    • Puedes ponerles el nombre que quieras a estos roles de Entra al crearlos en la sección de registro de la aplicación. Siempre que el argumento siguiente se corresponda con el valor correcto del rol de usuario de ClickUp y selecciones esos roles de Entra al asignar usuarios a ClickUp, se aprovisionarán correctamente.
    • Puedes elegir otras expresiones lógicas si lo prefieres, siempre que al atributo urn de ClickUp se le asigne un número válido que corresponda a un rol de usuario.
  5. Haz clic en Guardar.
  6. A partir de ahora, cuando asignes usuarios o grupos en Usuarios y grupos, selecciona el rol que quieras que tenga ese usuario en ClickUp.
  7. Cuando aprovisiones a ese usuario, recibirá el rol correcto. Si un usuario se aprovisiona de forma individual y también como parte de un grupo, comprueba que no esté asignado a dos roles de aplicación distintos, ya que esto provocará errores.

Aprovisionar grupos como equipos

Cada grupo de Microsoft Entra ID que asignes a la aplicación se convierte en un nuevo equipo de ClickUp con el mismo nombre. Los usuarios nuevos se crean y los existentes se añaden al equipo.

Para aprovisionar grupos:

  1. En tu aplicación de Microsoft Entra ID, en la barra lateral izquierda, haz clic en Usuarios y grupos.
  2. En la parte superior izquierda, haz clic en Añadir usuario/grupo y asigna los grupos que quieras como equipos. Asignar usuarios individuales no crea un equipo.
  3. Para hacer una prueba, en la pestaña Aprovisionamiento, selecciona Aprovisionar a petición y elige un único usuario. El aprovisionamiento a petición envía hasta cinco miembros de un grupo a la vez, por lo que el equipo puede parecer incompleto durante las pruebas.
  4. Inicia el aprovisionamiento en Microsoft Entra ID. Los equipos y sus miembros se añaden cuando se ejecute el siguiente ciclo de aprovisionamiento.
  5. En ClickUp, comparte los Espacios, Carpetas, Subcarpetas o Listas que necesite.

Aprovisionar usuarios nuevos y existentes

Para los usuarios nuevos, sigue los pasos anteriores. Prueba el aprovisionamiento con un usuario nuevo antes de añadir más personas.

Para los usuarios existentes de ClickUp, comprueba que el correo electrónico enviado por la asignación de atributos de Entra coincida con su correo electrónico de ClickUp. Revisa el resultado del aprovisionamiento. Si el aprovisionamiento no logra asociarse a una cuenta existente, contacta con el soporte antes de eliminar o volver a invitar a esa persona.

Eliminar un usuario mediante Entra ID

Con el aprovisionamiento automático activado, elimina la asignación del usuario a la aplicación SAML personalizada en Entra ID.

Comprueba el resultado del aprovisionamiento y confirma que la persona ya no puede acceder a tu Entorno de trabajo de ClickUp. Si el aprovisionamiento falla o el acceso persiste, contacta con el equipo de soporte.

Actualizar el nombre o la dirección de correo electrónico de un usuario

Tras cambiar el nombre o la dirección de correo electrónico de un usuario en Entra ID, revisa las asignaciones de atributos y el resultado del aprovisionamiento. Comprueba el nombre o el correo electrónico que aparece en ClickUp. Si no coincide con el valor asignado, contacta con el soporte.

Si usas una dirección de correo electrónico como NameID de SAML, un cambio de correo electrónico requiere que la persona vuelva a vincular su cuenta de ClickUp. Sigue los pasos para vincular la cuenta en Configurar el inicio de sesión único con SAML personalizado.