L'intégration de Lucid à Azure permet à tes utilisateurs de s'authentifier à l'aide de SAML single-sign on via Azure. Azure propose également une connexion SCIM qui te permet de provisionner des utilisateurs dans ton IDP. Le tutoriel suivant décrit le processus d'intégration d'Azure avec Lucidchart et Lucidspark. Tu auras besoin de privilèges d'administrateur dans Azure et Lucid pour configurer cette intégration.

Cette intégration n'est disponible que pour les comptes Entreprise. Voir l'article Upgrade your Lucid account pour les instructions de mise à niveau.

Configurer l'intégration SAML pour Lucid via Azure Portal

Pour configurer l'intégration SAML pour Lucid via Azure Portal, suis les étapes suivantes :

Dans Azure :

Connecte-toi à Azure.
Depuis la page d'accueil, clique sur Azure Active Directory dans le menu de navigation sur le côté gauche.
Sélectionne Enterprise Applications dans le menu de navigation sur le côté gauche.
Clique sur +Nouvelle application en haut à gauche de la page.
Recherche "Lucid" et sélectionne la tuile Lucid (All Products) .
Clique sur Créer.
Dans l'appli, navigue vers "Configurer l'authentification unique".
Under Single Sign-on Mode, select SAML.
Sélectionnez Edit sur votre configuration SAML de base. Vos paramètres dans Azure devraient ressembler à l'exemple ci-dessous :
- ID d'entité : lucidchart.com
- Lien URL de réponse par défaut : https://lucid.app/saml/sso/<yourdomainnamehere>
- Lien URL de réponse secondaire : https://www.lucidchart.com/saml/sso/<votrenom de domaineici>
- Lien URL de connexion : https://lucid.app/saml/sso/<yourdomainnamehere>
Cliquez sur Enregistrer.
Confirme que l'identifiant de l'utilisateur est "user.userprincipalname".
- Tous les attributs de base et les revendications devraient être déjà configurés par défaut.
Cliquez sur Enregistrer.
Under "Federation Metadata XML" select Download to retrieve the IDP metadata.
- N'ouvrez pas le fichier XML (métadonnées). Vous allez télécharger le fichier sauvegardé dans Lucid.

Dans Lucide :

Sélectionnez Admin.
Cliquez sur Gestion des identités dans le menu de gauche.
Sélectionnez Configurer à droite de l’option « Autoriser l’authentification SAML » pour accéder à votre page d’activation SAML dans Lucid.
- Vous ne pourrez pas activer SAML tant que vous n’aurez pas rempli votre domaine et téléchargé les métadonnées.
Sous "Lucidchart Sign in URL", entre ton nom de domaine.
Cliquez sur Enregistrer les modifications.
Sdérouler la page d'activation SAML de Lucidchart et cliquer sur Ajouter un fournisseur d'identité.
Téléchargez le fichier XML (métadonnées) que vous avez téléchargé depuis Azure.
Cliquez sur Tester la connexion SAML pour vérifier que Lucid communique correctement avec Azure.
- La connexion ne fonctionnera que si l'application Lucid (All Products) a été attribuée à ton utilisateur test dans Azure. Tu peux attribuer l'appli à des utilisateurs dans la section Affectations de la page de l'appli. Pour ce faire, navigue vers "Utilisateurs et groupes" sur le côté gauche et clique sur Attribuer.
Revenez à la page de gestion des identités.
Cochez la case à côté de "Allow SAML authentication".
Cliquez sur Enregistrer les modifications.

Remarque : Vous pouvez sélectionner la méthode d’authentification par défaut dans Lucid, après avoir vérifié les méthodes que vous souhaitez autoriser comme options de connexion ci-dessus. Les utilisateurs seront invités à se connecter à l’aide de l’authentification par défaut que vous avez configurée dans la page Gestion des identités.

Créer des utilisateurs lors de la connexion avec SAML

Une fois que vous avez configuré SAML avec Azure pour votre compte Lucid, vous pouvez configurer le provisionnement juste-à-temps afin que les utilisateurs à qui l'on a attribué un accès Lucid dans Azure et qui n'ont pas de compte Lucid aient un compte créé pour eux lors de leur première connexion.

Remarque : pour que ce type de provisionnement fonctionne, le contrôle de domaine doit être activé.

Pour permettre la création de nouveaux utilisateurs pour les utilisateurs affectés à l'application :

Va sur l'onglet "Propriétés" de ta page d'application Lucid (Tous les produits) dans Azure.
Faites défiler jusqu'au bas de la page et basculez l'option "User Assignment Required ?" sur "No".
Cliquez sur Enregistrer .
Sélectionne Users and groups dans le menu Manage.
Sélectionnez et affectez des utilisateurs et/ou des groupes pour accéder à l'application Lucid (tous produits) .

Tu peux ensuite configurer le provisionnement Just-In-Time dans la section Paramètres de licence du panneau d'administration de Lucid.

Si tu souhaites que tous les utilisateurs rejoignent ton équipe Lucid avec des licences d'édition complètes, règle le paramètre "Lorsqu'un nouvel utilisateur rejoint une équipe" sur "Accorder automatiquement une licence".
Si tu veux que tous les utilisateurs arrivent en tant qu'utilisateurs à accès limité, règle le paramètre de "Lorsqu'un nouvel utilisateur rejoint une équipe" sur "Ne pas accorder automatiquement". Tes utilisateurs pourront alors demander des licences d'édition complète. Selon le paramètre "Lorsqu'un utilisateur demande une licence", tu peux faire en sorte que les licences soient automatiquement accordées aux utilisateurs à leur demande, ou que les demandes se transforment en demandes en attente dans ta liste d'utilisateurs.

Remarque : Nous vous recommandons vivement d’avoir une boîte de dialogue de demande personnalisée si des utilisateurs demandent des licences à un administrateur.

Configurer SCIM avec l'application Lucid (tous les produits)

Configure l'intégration Lucid SCIM en utilisant l'application Lucid (Tous les produits) à partir de la galerie Azure AD. Tu peux utiliser SCIM pour créer des utilisateurs Lucid avant leur première connexion et pour leur attribuer un type de licence spécifique.

Avant de configurer le SCIM, tu dois faire ce qui suit :

Confirme que tu es sur un compte Entreprise avec un plan tarifaire à jour. Pour effectuer une mise à niveau, contacte notre équipe de vente.
Contacte ton responsable de la réussite client Lucid ou contacte l'assistance pour demander que le SCIM soit activé pour ton compte.

Une fois que tu as terminé les étapes de préconfiguration énumérées ci-dessus, configure SCIM pour Lucid dans Azure en suivant ces étapes :

Connecte-toi à Azure.
Depuis la page d'accueil, clique sur Azure Active Directory dans le menu de navigation sur le côté gauche.
Sélectionne Enterprise Applications dans le menu de navigation sur le côté gauche.
Clique sur +Nouvelle application en haut à gauche de la page.
Recherche "Lucid" et sélectionne la tuile Lucid (All Products) .
Clique sur Créer.

Créer des rôles d'application

Pour créer des rôles d'application :

Sélectionne Azure Active Directory dans le menu de navigation sur le côté gauche de la page d'accueil Azure.
Clique sur App registrations dans le menu de navigation à gauche.
Sélectionne l'onglet All applications .
Clique sur l'application Lucid (All Products) .

Configurer le rôle de l'application "Licensed User"

Sélectionne les rôles de App dans le menu de gauche.
Clique sur User à partir des rôles d'application existants.
Mets à jour les paramètres suivants. Le texte doit être tapé exactement comme indiqué ci-dessous :
- Nom d'affichage : changer de "Utilisateur" à "Licensed User"
- Valeur : Saisis la valeur "true"
- Description : Remplacer "utilisateur" par "Licensed User".
Clique sur Appliquer.

Configurer le rôle de l'application "Limited Access User" (utilisateur à accès limité)

Sélectionne les rôles de App dans le menu de gauche.
Clique sur msiam_access à partir des rôles d'application existants.
Mets à jour les paramètres suivants. Le texte doit être tapé exactement comme indiqué ci-dessous :
- Nom d'affichage : remplacer "msiam_access" par "Limited Access" (accès limité)
- Valeur : Saisis la valeur "false"
- Description : Changer de "msiam_access" à "Accès limité".
Clique sur Appliquer.

Créer des groupes d'utilisateurs

Crée de nouveaux groupes ou des groupes supplémentaires en suivant les étapes suivantes :

Sélectionne Azure Active Directory dans le menu de navigation sur le côté gauche de la page d'accueil Azure.
Clique sur Groups dans le menu de navigation à gauche.

Créer un groupe "Lucid Suite Licensed Users".

Clique sur Nouveau groupe.
Mets à jour les paramètres suivants :
- Nom du groupe : "Lucid Suite Licensed Users" (Utilisateurs licenciés de Lucid Suite)
- Saisis une description du groupe (facultatif)
Clique sur Créer.

Créer un groupe "Lucid Suite Limited Access Users".

Clique sur Nouveau groupe.
Mets à jour les paramètres suivants :
- Nom du groupe : "Lucid Suite Limited Access Users" (Utilisateurs à accès limité de Lucid Suite)
- Saisis une description du groupe (facultatif)
Clique sur Créer.

Attribuer des groupes à l'application Lucid (Tous les produits)

Sélectionne Azure Active Directory dans le menu de navigation sur le côté gauche de la page d'accueil Azure.
Sélectionne Enterprise Applications dans le menu de navigation sur le côté gauche.
Ouvre l'application Lucid (All Products) .
Clique sur Utilisateurs et groupes.

Attribue le groupe "Licensed User".

Clique sur Ajouter un utilisateur/groupe.
Sous "Utilisateurs et groupes", clique sur None Selected.
Recherche le groupe "Lucid Suite Licensed User" (utilisateur licencié de Lucid Suite).
Sélectionne le groupe et clique sur Sélectionne.
Sous "Sélectionner un rôle", clique sur None Selected.
Sélectionne Licensed User.
Clique sur Sélectionne.
Clique sur Attribuer.

Attribue le groupe "Limited Access User".

Clique sur Ajouter un utilisateur/groupe.
Sous "Utilisateurs et groupes", clique sur None Selected.
Recherche le groupe "Lucid Suite Limited Access User".
Sélectionne le groupe et clique sur Sélectionne.
Sous "Sélectionner un rôle", clique sur None Selected.
Sélectionne Limited Access.
Clique sur Sélectionne.
Cliquez sur Affecter.

Créer des correspondances d'attributs d'expression

Obtenir le jeton du porteur auprès de Lucid

Avant de créer des mappages d'attributs d'expression dans Azure, tu dois obtenir un jeton de porteur auprès de Lucid. Pour ce faire :

Connecte-toi à Lucid en tant que propriétaire de compte ou administrateur d'équipe.
Sélectionne Admin dans le menu de navigation sur le côté gauche.
Clique sur App Integration dans le menu de navigation sur le côté gauche.
Sous "SCIM", clique sur Settings.
Si un jeton de porteur n'existe pas encore, clique sur Generate Token.
- Si Generate Token n'est pas cliquable, assure-toi que l'option "Automatically upgrade account when no more licenses are available" est cochée et réessaie.

Créer un mappage d'attributs d'expression

Après avoir obtenu le jeton de porteur auprès de Lucid, suis les étapes suivantes :

Ouvre l'application Lucid (All Products) .
Sélectionne Provisioning dans le menu de navigation sur le côté gauche.
Clique sur pour commencer.
Dans le menu déroulant "Mode de provisionnement", sélectionne Automatic.
Sous "Admin Credentials", entre https://users.lucid.app/scim/v2/azure sous "URL du locataire".
Saisis le jeton porteur dans la rubrique "Jeton secret" en utilisant le jeton que tu as obtenu auprès de Lucid dans les étapes ci-dessus.
Clique sur Test Connection.
Si la connexion est réussie, clique sur Enregistrer.
Sous "Mappings", clique sur Provision Azure Active Directory Users.
Clique sur Add New Mapping en bas de la page.
Saisis les valeurs suivantes dans la boîte de dialogue "Modifier l'attribut" :
- Type de mise en correspondance : "Expression"
- Expression : “Switch(SingleAppRoleAssignment([appRoleAssignments]), , "Licensed User", "True", "Limited Access", "False")”
- Attribut cible : "urn:ietf:params:scim:schemas:extension:lucid:2.0:User:productLicenses:Lucidchart".
Clique sur Ok.
Clique sur Sauvegarder.

Répète les étapes 12 à 15 pour créer une cartographie d'expression supplémentaire. Au lieu de sélectionner l'attribut cible de Lucidchart, sélectionne l'attribut se terminant par "Lucidspark".

Approvisionnement des tests

Une fois que tous les paramètres détaillés ci-dessus sont enregistrés, teste l'application pour t'assurer qu'elle fonctionne correctement. Pour ce faire :

Attribue un utilisateur test au "Lucid Suite Licensed User Group".
Ouvre l'application Lucid (All Products) .
Sélectionne Provisioning dans le menu de navigation sur le côté gauche.
Clique sur Provision on demand dans le menu en haut de la page.
Saisis le nom de l'utilisateur test que tu as affecté au Lucid Suite Licensed User Group.
Clique sur Provision.

Les mêmes étapes peuvent être suivies pour tester le "Limited Access User Group".

Si tout fonctionne comme prévu, tu verras :

Coche en vert toutes les étapes
Les attributs des cibles Lucidchart et Lucidspark = "True"

Si ce n'est pas le cas, revois les étapes de configuration ci-dessus.

FAQ

Quelle est la différence entre Microsoft SSO et Azure SAML Sign-On ?
Microsoft SSO et Azure SAML Sign-On sont tous deux gérés à partir du portail Azure. SAML utilise le protocole SAML2.0 tandis que MS SSO utilise OAuth2.0 OpenID. En général, les configurations SAML sont considérées comme plus sûres car le cryptage se fait sur la couche de transport (SSL).

Qu'advient-il des documents lorsque je retire une licence à un utilisateur via SCIM ?
Lorsque tu délègues ou supprimes un utilisateur via SCIM, tu dois transférer ses documents à un autre utilisateur sur ton compte Entreprise. Cela ne s'applique pas à la désactivation des utilisateurs.

Par défaut, le titulaire du compte sera le destinataire des documents qui sont automatiquement transférés lors de la déchéance ou de la suppression d'un utilisateur. Tu peux changer le destinataire des documents transférés en naviguant vers les paramètres d'intégration SCIM dans le panneau d'administration et en sélectionnant Modifier le propriétaire par défaut à droite de l'adresse e-mail. Vois la capture d'écran ci-dessous à titre de référence.

Cliquer sur Modifier le propriétaire par défaut te redirige vers la page "Document & Folder Settings" du panneau d'administration de Lucid où tu peux changer le propriétaire par défaut du document sur ton compte. Reporte-toi à Panneau d'administration de Lucid : Document et dossiers article pour plus de détails.
changer-de-recevoir-des-documents-lors-de-la-suppression-ou-de-la-délivrance-des-utilisateurs-via-SCIM.png

Articles associés