Les applications SAML personnalisées créées dans Microsoft Entra ID offrent un provisionnement automatique limité, notamment la création et la suppression d'utilisateurs.
Microsoft Entra ID s'appelait auparavant Azure.
Ce dont vous aurez besoin
- Avant de configurer le provisionnement, vous devez avoir activé le SAML personnalisé pour votre Environnement de travail.
- Le SAML personnalisé est uniquement disponible pour les Environnements de travail disposant du plan Enterprise.
- Seuls les propriétaires et administrateurs de l'Environnement de travail peuvent activer le SAML.
- Seuls les administrateurs Entra ID peuvent configurer le SCIM Entra ID.
- Le provisionnement nécessite une application personnalisée hors galerie dans Microsoft Entra ID. L'application de galerie ClickUp Productivity Platform ne prend pas en charge le SCIM et ne peut pas provisionner de groupes.
Configurer l'application SAML personnalisée Microsoft Entra ID
Pour configurer l'application SAML personnalisée :
- Créez une nouvelle application SAML personnalisée dans Microsoft Entra ID. Il ne s'agit pas de l'application officielle de la galerie Microsoft Entra ID ClickUp Productivity Platform.
- Dans ClickUp, dans le coin supérieur gauche, cliquez sur l'avatar de votre Environnement de travail.
- Sélectionnez Paramètres.
- Dans la barre latérale Tous les paramètres, cliquez sur Sécurité et autorisations.
- Dans la section Authentification unique (SSO), sélectionnez SAML.
- Pour votre nouvelle application Microsoft Entra ID, copiez l'Identificateur d'entité SP depuis ClickUp.
- Collez l'Identificateur d'entité SP copié depuis ClickUp dans le champ Identificateur (ID d'entité) de Microsoft Entra ID.
- Copiez l'URL d'authentification unique (URL ACS) depuis ClickUp et collez-la dans le champ URL de réponse (URL du service consommateur d'assertion) de Microsoft Entra ID.
- Cliquez sur Enregistrer dans Microsoft Entra ID.
Lier le SSO dans ClickUp
Maintenant que l'application est configurée, vous pouvez finaliser la connexion SSO dans ClickUp :
- Vérifiez que la personne qui configure l'intégration SSO est bien assignée dans l'application Microsoft Entra ID. D'autres personnes pourront être ajoutées ultérieurement.
- Copiez l'URL de connexion et le Certificat public IDP depuis Microsoft Entra ID.
- Collez ces valeurs en texte brut dans les champs ClickUp correspondants lorsque vous sélectionnez le connecteur SAML.
- Pour obtenir le certificat en texte brut, téléchargez le fichier, puis faites un clic droit dessus pour l'ouvrir avec l'éditeur de texte de votre choix. Le texte commence par -----BEGIN CERTIFICATE-----. Collez l'intégralité du texte, sans aucune modification, dans le champ Certificat public IDP.
- Sélectionnez Enregistrer les métadonnées.
- Vous serez invité à finaliser la liaison en vous connectant via SSO. Si l'opération réussit, vous serez redirigé vers ClickUp.
- Sur la page Sécurité et autorisations de ClickUp, trois nouvelles options apparaissent :
- URL de base SCIM : Vous saisirez cette information à l'étape suivante.
- Jeton API SCIM : Vous saisirez cette information à l'étape suivante.
- Politique de connexion : Choisissez l'une des quatre options suivantes :
- Tous les utilisateurs doivent utiliser l'authentification SAML : Tous les utilisateurs de type membre et de type invité doivent utiliser l'authentification SAML.
- Tous les utilisateurs sauf les invités doivent utiliser l'authentification SAML : Les utilisateurs de type invité ne sont pas tenus d'utiliser l'authentification SAML.
- Tous les utilisateurs sauf les membres limités et les invités doivent utiliser l'authentification SAML : Les membres limités, les membres limités en lecture seule et tous les utilisateurs de type invité ne sont pas tenus d'utiliser l'authentification SAML.
- L'utilisation de l'authentification SAML est facultative : L'authentification SAML est facultative pour tous les utilisateurs.
- Passez à l'étape suivante pour provisionner les autres personnes de votre Environnement de travail.
Avant de provisionner des groupes
Vérifiez ces limites avant de transférer des groupes Microsoft Entra ID vers ClickUp :
- Le provisionnement crée de nouvelles équipes. Il ne peut pas lier un groupe à une équipe qui existe déjà dans votre Environnement de travail.
- Les groupes imbriqués ne sont pas pris en charge.
- Chaque utilisateur ne peut avoir qu'un seul rôle d'application. Le provisionnement échoue pour un utilisateur qui reçoit un rôle directement et un rôle différent via un groupe, ou des rôles différents via deux groupes.
- Si vous utilisez des rôles d'application personnalisés, chaque groupe assigné doit avoir un rôle. Les groupes sans rôle ne sont pas pris en charge.
- Les invités en lecture seule ajoutés à une équipe sont convertis en invités, ce qui peut occuper un siège payant. Vérifiez les membres invités de vos groupes avant de les provisionner.
- Le provisionnement ne donne à une équipe aucun accès aux Espaces, Dossiers, sous-dossiers ou Listes.
Configurer le provisionnement automatique avec ClickUp
Nous prenons en charge le provisionnement d'utilisateurs individuels et de groupes avec SCIM. Lors du provisionnement de groupes vers ClickUp, les nouveaux utilisateurs sont provisionnés en tant qu'individus, et les utilisateurs nouveaux comme existants sont ajoutés à une équipe ClickUp. Si vous ne souhaitez pas que ces utilisateurs soient ajoutés à une équipe, supprimez l'équipe après le provisionnement.
Lorsque vous ajoutez un profil utilisateur à l'application SAML personnalisée, la personne n'est pas un utilisateur ClickUp tant que vous ne l'avez pas provisionnée via SCIM.
Le provisionnement automatique peut être effectué à la demande ou par cycles s'exécutant toutes les 30 minutes par défaut. Les utilisateurs affectés à l'application ne sont ajoutés qu'au prochain cycle de provisionnement automatique. En savoir plus sur le fonctionnement du provisionnement d'applications dans Microsoft Entra ID.
Pour configurer le provisionnement automatique :
- Dans Microsoft Entra ID, ouvrez l'onglet Approvisionnement et changez la liste déroulante de Manuel à Automatique. La fenêtre Informations d'identification de l'administrateur s'affiche alors dans l'onglet Approvisionnement.
- Pour provisionner jusqu'à cinq utilisateurs à la fois manuellement, dans l'onglet Approvisionnement, sélectionnez Approvisionner à la demande.
- Pour provisionner jusqu'à cinq utilisateurs à la fois manuellement, dans l'onglet Approvisionnement, sélectionnez Approvisionner à la demande.
- Saisissez l'URL de base SCIM de votre page Sécurité et autorisations ClickUp dans le champ URL du locataire.
- Saisissez le jeton API SCIM de votre page Sécurité et autorisations ClickUp dans le champ Jeton secret.
- Cliquez sur Tester la connexion.
- Une fois le test réussi, cliquez sur Enregistrer.
- Depuis la page Approvisionnement, cliquez sur Mappages. Vérifiez que Approvisionner les utilisateurs Microsoft Entra ID et Approvisionner les groupes Microsoft Entra ID sont tous les deux activés. Si le mappage des groupes est désactivé, aucune équipe n'est créée.
- Une fois l'enregistrement effectué, SCIM est configuré dans votre Environnement de travail. Les utilisateurs peuvent se connecter à ClickUp via Microsoft Entra ID.
Sélectionner les rôles d'utilisateur ClickUp à provisionner
Le rôle d'utilisateur est défini par défaut sur membre, sauf si vous sélectionnez les rôles d'utilisateur ClickUp à provisionner.
Pour mapper Microsoft Entra ID aux rôles d'utilisateur ClickUp :
- En tant qu'administrateur, connectez-vous au centre d'administration Microsoft Entra.
- Sélectionnez Identité, Applications, puis Applications d'entreprise.
- Depuis la page Applications d'entreprise, sélectionnez votre application SAML.
- Depuis la page Vue d'ensemble dans la barre latérale gauche, sélectionnez Provisionnement.
- Depuis la page Provisionnement, cliquez sur Mappages.
- Sélectionnez Provisionner les utilisateurs Microsoft Entra ID pour afficher la liste des attributs.
- Faites défiler la page jusqu'en bas et cochez la case Afficher les options avancées.
- Cliquez sur Modifier la liste d'attributs.
- Faites défiler jusqu'à la dernière ligne de la colonne Nom et saisissez cet attribut urn pour les rôles d'utilisateur : urn:ietf:params:scim:schemas:extension:ClickUp:2.0:User:role.
- Dans le menu déroulant de la colonne Type, vérifiez que Chaîne est sélectionné.
- Dans le coin supérieur gauche, cliquez sur Enregistrer.
- Si le nom ne s'enregistre pas, sélectionnez Ignorer et réessayez. Si le problème persiste, essayez de réinitialiser vos mappages à leurs valeurs par défaut.
- Vous êtes redirigé vers la page Mappage d'attributs.
- Sélectionnez Ajouter un nouveau mappage.
- Depuis la page Modifier l'attribut, pour le type de mappage, sélectionnez Constante.
- Pour effectuer un mappage dynamique, consultez la section Provisionner dynamiquement les rôles d'utilisateur ci-dessous.
- Pour la valeur constante, saisissez l'une des valeurs suivantes :
- 2 pour les administrateurs.
- 3 pour les membres.
- 4 pour les invités.
- 100 pour les membres limités.
- {custom_role_id} pour les rôles personnalisés.
- Pour l'attribut cible, saisissez urn:ietf:params:scim:schemas:extension:ClickUp:2.0:User:role.
- Cliquez sur OK puis sur Enregistrer.
- Tout utilisateur que vous provisionnez se verra attribuer ce rôle d'utilisateur ClickUp.
- Pour mapper un autre rôle d'utilisateur, reprenez à l'étape 5 et sélectionnez une valeur constante différente. Pour effectuer un mappage dynamique, consultez la section Provisionner dynamiquement les rôles d'utilisateur ci-dessous.
Les attributs suivants peuvent également être mappés :
| Modèle | Attributs de rôle d'utilisateur |
| Base | id: user.id userName: user.userName name: user.givenName+""+familyName active: user.active emails : tableau d'e-mails avec propriété de valeur et propriété primaire (booléen). title: user.title manager: user.role |
| Extension | role: user.role customRoleId : saisissez l'identifiant du rôle personnalisé ClickUp. Pour trouver l'identifiant du rôle personnalisé, envoyez la requête Obtenir un utilisateur depuis l'API ClickUp. Ce point de terminaison est uniquement disponible avec les forfaits Enterprise. customRoleName : saisissez le nom du rôle personnalisé ClickUp. |
| Enterprise Ces attributs sont progressivement déployés pour tous les Environnements de travail Enterprise. Lorsque ces attributs sont définis, ils s'affichent également sur la page Vue d'ensemble des personnes dans Teams Hub. |
chaîne hiérarchique department: user.department region: user.region |
Attribuer des rôles utilisateur de manière dynamique
Gérez les rôles utilisateur dans ClickUp de manière dynamique en vous basant sur les rôles utilisateur assignables dans Entra. Pour cela, les valeurs de rôle sont partagées dynamiquement avec l'attribut cible. Vous pouvez ainsi attribuer des rôles dans Entra qui correspondent aux rôles ClickUp, ce qui simplifie le provisionnement.
Pour modifier le mappage de l'attribut cible d'une valeur constante à une expression afin d'attribuer des rôles utilisateur de manière dynamique :
- Depuis la page Vue d'ensemble dans la barre latérale gauche, sélectionnez Provisionnement.
- Depuis la page Provisionnement, cliquez sur Mappages, puis sur Provisionner les utilisateurs Microsoft Entra ID.
- Si ce n'est pas encore fait, faites défiler jusqu'à la dernière ligne de la colonne Nom et saisissez cet attribut urn pour les rôles utilisateur :
urn:ietf:params:scim:schemas:extension:ClickUp:2.0:User:role.
- Si ce n'est pas encore fait, faites défiler jusqu'à la dernière ligne de la colonne Nom et saisissez cet attribut urn pour les rôles utilisateur :
- Sélectionnez Modifier à droite de l'attribut urn.
- Choisissez le type de mappage par expression et ajoutez cette expression :
Switch(SingleAppRoleAssignment([appRoleAssignments]), "3", "ClickUpAdmin", "2", "ClickUpGuest", "4", "ClickUpLimitedMember", "100").- Dans cette expression, 3 est la valeur par défaut, suivie des paires clé-valeur correspondant au rôle Entra / rôle ClickUp. Pour en savoir plus, consultez la documentation sur la rédaction d'expressions pour les mappages d'attributs dans Microsoft Entra ID.
- Vous pouvez nommer ces rôles Entra comme vous le souhaitez lors de leur création dans la section Inscription de l'application. Du moment que l'argument suivant correspond à la bonne valeur de rôle utilisateur ClickUp et que vous sélectionnez ces rôles Entra lors de l'attribution des utilisateurs à ClickUp, le provisionnement s'effectuera correctement.
- Vous pouvez choisir d'autres expressions logiques si vous le préférez, à condition que l'attribut urn ClickUp reçoive un nombre valide correspondant à un rôle utilisateur.
- Cliquez sur Enregistrer.
- Désormais, lors de l'attribution d'utilisateurs ou de groupes dans Utilisateurs et groupes, sélectionnez le rôle que vous souhaitez attribuer à cet utilisateur dans ClickUp.
- Lorsque vous provisionnez cet utilisateur, le rôle correct lui est attribué. Si un utilisateur est provisionné à la fois en tant qu'utilisateur individuel et dans un groupe, vérifiez qu'il n'est pas affecté à deux rôles d'application différents, car cela entraînerait des erreurs.
Provisionner des groupes en tant qu'équipes
Chaque groupe Microsoft Entra ID que vous attribuez à l'application devient une nouvelle équipe ClickUp portant le même nom. Les nouveaux utilisateurs sont créés et les utilisateurs existants sont ajoutés à l'équipe.
Pour provisionner des groupes :
- Dans votre application Microsoft Entra ID, dans la barre latérale gauche, cliquez sur Utilisateurs et groupes.
- En haut à gauche, cliquez sur Ajouter un utilisateur/groupe, puis attribuez les groupes que vous souhaitez utiliser comme équipes. L'attribution d'utilisateurs individuels ne crée pas d'équipe.
- Pour tester, dans l'onglet Provisionnement, sélectionnez Provisionner à la demande et choisissez un seul utilisateur. Le provisionnement à la demande envoie jusqu'à cinq membres d'un groupe à la fois, ce qui peut donner l'impression qu'une équipe est incomplète pendant les tests.
- Lancez le provisionnement dans Microsoft Entra ID. Les équipes et leurs membres sont ajoutés à l'issue du prochain cycle de provisionnement.
- Dans ClickUp, partagez les Espaces, Dossiers, sous-dossiers ou Listes dont l'équipe a besoin.
Provisionner des utilisateurs nouveaux et existants
Pour les nouveaux utilisateurs, suivez les étapes ci-dessus. Testez le provisionnement avec un seul nouvel utilisateur avant d'en ajouter d'autres.
Pour les utilisateurs ClickUp existants, vérifiez que l'adresse e-mail transmise par le mappage d'attributs Entra correspond à leur adresse e-mail ClickUp. Consultez le résultat du provisionnement. Si le provisionnement ne parvient pas à associer un compte existant, contactez le support avant de retirer ou de réinviter cette personne.
Retirer un utilisateur via Entra ID
Avec le provisionnement automatique activé, retirez l'attribution de l'utilisateur à l'application SAML personnalisée dans Entra ID.
Vérifiez le résultat du provisionnement, puis confirmez que la personne ne peut plus accéder à votre Environnement de travail ClickUp. Si le provisionnement échoue ou si l'accès persiste, contactez le support.
Mettre à jour le nom ou l'adresse e-mail d'un utilisateur
Après avoir modifié le nom ou l'adresse e-mail d'un utilisateur dans Entra ID, vérifiez les mappages d'attributs et le résultat du provisionnement. Contrôlez le nom ou l'adresse e-mail affichés dans ClickUp. S'ils ne correspondent pas à la valeur mappée, contactez le support.
Si vous utilisez une adresse e-mail comme NameID SAML, toute modification de l'adresse e-mail oblige la personne à relier son compte ClickUp. Suivez les étapes de liaison de compte décrites dans Configurer l'authentification unique SAML personnalisée.