Las aplicaciones SAML personalizadas creadas en Microsoft Entra ID ofrecen aprovisionamiento automático limitado, que incluye la creación y eliminación de usuarios.
Microsoft Entra ID anteriormente se llamaba Azure.
Lo que necesitas
- Antes de configurar el aprovisionamiento, debes tener SAML personalizado habilitado en tu Entorno de trabajo.
- El SAML personalizado solo está disponible para los Entornos de trabajo en el Plan Enterprise.
- Solo los propietarios y administradores del Entorno de trabajo pueden habilitar SAML.
- Solo los administradores de Entra ID pueden configurar el 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 la aplicación SAML personalizada de Microsoft Entra ID
Para configurar la aplicación SAML personalizada:
- Crea una nueva aplicación SAML personalizada en Microsoft Entra ID. Esta no es la aplicación oficial de la galería de Microsoft Entra ID de ClickUp ClickUp Productivity Platform.
- En ClickUp, en la esquina superior izquierda, haz clic en el avatar de tu Entorno de trabajo.
- Selecciona Configuración.
- En la barra lateral Todas las configuraciones, haz clic en Seguridad y permisos.
- En la sección Inicio de sesión único (SSO), selecciona SAML.
- Para una nueva aplicación de Microsoft Entra ID, copia el SP Entity ID desde ClickUp.
- Pega el SP Entity ID de ClickUp en el campo Identifier (Entity ID) de Microsoft Entra ID.
- Copia la Single sign-on URL (ACS URL) de ClickUp y pégala en el campo Reply URL (Assertion Consumer Service URL) de Microsoft Entra ID.
- Haz clic en Guardar en Microsoft Entra ID.
Vincular SSO en ClickUp
Ahora que la aplicación está configurada, puedes completar la conexión SSO en ClickUp:
- Asegúrate de que la persona que configura la integración SSO esté asignada en la aplicación de Microsoft Entra ID. Puedes agregar a otras personas después.
- Copia la URL de inicio de sesión y el Certificado público de IDP desde Microsoft Entra ID.
- Pega estos valores en texto sin formato en los campos vacíos correspondientes de ClickUp al seleccionar el conector SAML.
- Para obtener el certificado en texto sin formato, descárgalo y haz clic derecho sobre el archivo para abrirlo con el editor de texto de tu preferencia. El texto comienza con -----BEGIN CERTIFICATE-----. Pega el valor de texto completo sin ninguna modificación en el campo Certificado público de IDP.
- Selecciona Guardar metadatos.
- Se te pedirá que completes el vínculo iniciando sesión con SSO. Si el proceso es exitoso, serás redirigido a ClickUp.
- En la página Seguridad y permisos de ClickUp, verás tres nuevas opciones:
- URL base de SCIM: Ingresarás esta información en el siguiente paso.
- Token de API de SCIM: Ingresarás esta información en el siguiente paso.
- 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 con acceso limitado e invitados deben usar autenticación SAML: Los miembros con acceso limitado y los miembros con acceso limitado 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.
- Ve al siguiente paso para aprovisionar a las demás personas en 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 existe en tu Entorno de trabajo.
- Los grupos anidados no son compatibles.
- Cada usuario puede tener solo un rol de aplicación. El aprovisionamiento falla para un usuario que recibe un rol directamente y un rol 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 tener un rol. Los grupos sin rol no son compatibles.
- Los invitados con acceso de solo lectura que se agregan a un equipo se convierten en invitados, lo que puede ocupar un puesto de pago. Revisa la membresía de invitados en tus grupos antes de aprovisionarlos.
- El aprovisionamiento no le da 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 agregan a un equipo de ClickUp. Si no quieres que estos usuarios se agreguen a un equipo, elimina el equipo después del aprovisionamiento.
Cuando agregas un perfil de usuario a la aplicación SAML personalizada, ese usuario no es un usuario de ClickUp hasta que lo aprovisiones mediante SCIM.
El aprovisionamiento automático puede realizarse a demanda o en ciclos que se ejecutan cada 30 minutos de forma predeterminada. Los usuarios asignados a la aplicación solo se agregará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.
Para configurar el aprovisionamiento automático:
- En Microsoft Entra ID, abre la pestaña Aprovisionamiento y cambia el menú desplegable de Manual a Automático. Esto hace 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 a demanda.
- Si quieres aprovisionar hasta cinco usuarios a la vez de forma manual, en la pestaña Aprovisionamiento selecciona Aprovisionar a demanda.
- Ingresa la URL base de SCIM de tu página de Seguridad y permisos de ClickUp en el campo URL del inquilino.
- Ingresa el Token de API de SCIM de tu página de Seguridad y permisos de ClickUp en el campo Token secreto.
- Haz clic en Probar conexión.
- Una vez que la prueba sea exitosa, haz clic en Guardar.
- Desde la página Aprovisionamiento, haz clic en Asignaciones. Asegúrate de que tanto Aprovisionar usuarios de Microsoft Entra ID como Aprovisionar grupos de Microsoft Entra ID estén habilitados. Si la asignación de grupos está desactivada, no se crearán equipos.
- Después de guardar, SCIM queda configurado en tu entorno de trabajo. Los usuarios pueden iniciar sesión en ClickUp con Microsoft Entra ID.
Selecciona los roles de usuario de ClickUp que quieres aprovisionar
El rol de usuario se establece como miembro de forma predeterminada, a menos que selecciones los roles de usuario de ClickUp que quieres aprovisionar.
Para mapear Microsoft Entra ID a los roles de usuario de ClickUp:
- Como administrador, inicia sesión en el centro de administración de Microsoft Entra.
- Selecciona Identidad, Aplicaciones y luego Aplicaciones empresariales.
- En la página de aplicaciones empresariales, selecciona tu aplicación SAML.
- En la página de información general del panel lateral izquierdo, selecciona Aprovisionamiento.
- En la página de aprovisionamiento, haz clic en Asignaciones.
- Selecciona Aprovisionar usuarios de Microsoft Entra ID para ver una lista de atributos.
- Desplázate hasta el final de la página y marca la casilla Mostrar opciones avanzadas.
- Haz clic en Editar lista de atributos.
- Desplázate hasta la última fila de la columna Nombre e ingresa este atributo urn para los roles de usuario: urn:ietf:params:scim:schemas:extension:ClickUp:2.0:User:role.
- En el menú desplegable de la columna Tipo, asegúrate de que esté seleccionado Cadena.
- 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 tus asignaciones a los valores predeterminados.
- Serás redirigido a la página de Asignación de atributos.
- Selecciona Agregar nueva asignación.
- En la página Editar atributo, en Tipo de asignación selecciona Constante.
- Para mapear de forma dinámica, consulta la sección Aprovisionar roles de usuario de forma dinámica que aparece más abajo.
- En Valor constante, ingresa uno de los siguientes valores:
- 2 para administradores.
- 3 para miembros.
- 4 para invitados.
- 100 para miembros con acceso limitado.
- {custom_role_id} para roles personalizados.
- En Atributo de destino, ingresa urn:ietf:params:scim:schemas:extension:ClickUp:2.0:User:role.
- Haz clic en OK y luego en Guardar.
- Todos los usuarios que aprovisiones tendrán asignado ese rol de usuario de ClickUp.
- Para mapear otro rol de usuario, comienza desde el paso 5 y selecciona un valor constante diferente. Para mapear de forma dinámica, consulta la sección Aprovisionar roles de usuario de forma dinámica que aparece más abajo.
También se pueden mapear los siguientes atributos:
| Modelo | Atributos de rol de usuario |
| Base | id: user.id userName: user.userName name: user.givenName+""+familyName active: user.active emails: Arreglo de correos electrónicos con la propiedad value y la propiedad primary (booleana). title: user.title manager: user.role |
| Extensión | role: user.role customRoleId: Ingresa 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: Ingresa el nombre del rol personalizado de ClickUp. |
| Enterprise Estos atributos se están lanzando de forma gradual a todos los entornos de trabajo Enterprise. Cuando estos atributos están configurados, también se muestran en la página de información general de personas en Teams Hub. |
cadena de gestión department: user.department region: user.region |
Aprovisionar roles de usuario de forma dinámica
Administra de forma dinámica los roles de usuario en ClickUp según los roles de usuario asignables en Entra. Esto se logra compartiendo dinámicamente los valores de rol con el atributo de destino. El resultado te permite asignar roles en Entra que se correspondan con los roles de ClickUp, lo que simplifica el aprovisionamiento.
Para ajustar la asignación del atributo de destino de constante a una expresión y aprovisionar roles de usuario de forma dinámica:
- En la página de descripción general, en la barra lateral izquierda, selecciona Aprovisionamiento.
- En la página de aprovisionamiento, haz clic en Asignaciones y luego 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 ingresa este atributo urn para los roles de usuario:
urn:ietf:params:scim:schemas:extension:ClickUp:2.0:User:role.
- Si aún no lo has hecho, desplázate hasta la última fila de la columna Nombre e ingresa este atributo urn para los roles de usuario:
- Selecciona Editar a la derecha del atributo urn.
- Elige el tipo de asignación de expresión y agrega 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 de clave y valor correspondientes para el rol de Entra / rol de ClickUp. Obtén más información sobre cómo escribir expresiones para asignaciones de atributos en Microsoft Entra ID.
- Puedes nombrar estos roles de Entra como quieras al crearlos en la sección de registro de aplicaciones. Siempre que el argumento correspondiente se asigne al valor de rol de usuario correcto en 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.
- Haz clic en Guardar.
- Ahora, al asignar usuarios o grupos en Usuarios y grupos, selecciona el rol correspondiente que deseas que ese usuario tenga en ClickUp.
- 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, asegúrate de que no esté asignado a dos roles de aplicación distintos, ya que esto generará 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. Se crean los usuarios nuevos y los existentes se agregan al equipo.
Para aprovisionar grupos:
- En tu aplicación de Microsoft Entra ID, en la barra lateral izquierda, haz clic en Usuarios y grupos.
- En la parte superior izquierda, haz clic en Agregar usuario/grupo y asigna los grupos que quieres convertir en equipos. Asignar usuarios individuales no crea un equipo.
- Para hacer una prueba, en la pestaña de aprovisionamiento, selecciona Aprovisionar a petición y elige un solo usuario. El aprovisionamiento a petición envía hasta cinco miembros de un grupo a la vez, así que durante las pruebas un equipo puede aparecer incompleto.
- Inicia el aprovisionamiento en Microsoft Entra ID. Los equipos y sus miembros se agregan cuando corre el siguiente ciclo de aprovisionamiento.
- En ClickUp, comparte los Espacios, Carpetas, Subcarpetas o Listas que necesite.
Aprovisionar usuarios nuevos y existentes
Para usuarios nuevos, sigue los pasos anteriores. Prueba el aprovisionamiento con un usuario nuevo antes de agregar más personas.
Para usuarios existentes de ClickUp, verifica 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 coincidir con una cuenta existente, comunícate con el equipo de soporte antes de quitar o volver a invitar a esa persona.
Quitar un usuario a través de Entra ID
Con el aprovisionamiento automático habilitado, quita la asignación del usuario a la aplicación SAML personalizada en Entra ID.
Verifica el resultado del aprovisionamiento y confirma que la persona ya no tenga acceso a tu Entorno de trabajo de ClickUp. Si el aprovisionamiento falla o el acceso persiste, comunícate con el equipo de soporte.
Actualizar el nombre o la dirección de correo electrónico de un usuario
Después de 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. Verifica el nombre o el correo electrónico que aparece en ClickUp. Si no coincide con el valor asignado, comunícate 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 de SAML personalizado.