L'intégration de Lucid à Okta permet à vos utilisateurs de s'authentifier à l'aide de l'authentification unique SAML via Okta. De plus, notre intégration SCIM permet aux administrateurs de créer des utilisateurs, de les approvisionner et de les déprovisionner au sein même d'Okta, sans avoir à se connecter à Lucid. Le tutoriel suivant décrit le processus d'intégration d'Okta à Lucid. Vous aurez besoin de privilèges d'administrateur dans Okta et Lucid pour réaliser cette intégration.

Gratuit	Individuel	Équipe	Entreprise	FedRAMP
				*

*Pour configurer l'intégration SAML ou SCIM pour Okta sur un compte Lucid GovSuite, vous devez configurer une application personnalisée. Pour obtenir des instructions, consultez notre guide SAML et SCIM : Enable custom app in Okta for Lucid's FedRAMP environment community post.

Consultez l’article Changer d’abonnement pour votre compte Lucid pour découvrir comment passer au forfait supérieur.

Configurez l'intégration SAML pour Lucid

Suivez exactement les instructions ci-dessous, que vous utilisiez Lucidchart, Lucidspark ou les deux.

Dans Okta :

Parcourez le réseau d'intégrations Okta et recherchez "Lucid".
- Après avoir ajouté l'application Lucid à Okta, vous pouvez configurer l'intégration SAML afin que les utilisateurs finaux de votre instance Okta puissent s'authentifier à l'aide de SAML via Okta.
Dans la section General Settings de l'application Lucid dans Okta, sélectionnez les applications Lucid que vous souhaitez afficher (Lucidchart et/ou Lucidspark). Chacune d'entre elles apparaîtra dans la galerie d'applications de vos utilisateurs pour faciliter la connexion initiée par l'IdP.
Dans l'onglet Sign On d'Okta, cliquez sur Edit dans le coin supérieur droit.
Sélectionnez SAML 2.0 comme méthode de connexion.
Saisissez votre nom de domaine SAML sous Paramètres de connexion avancés.
- Le nom de domaine SAML est un domaine propre à votre entreprise, qui sera utilisé pour les URL de connexion/ACS de votre compte.
- Veillez à ne saisir que votre domaine (plutôt qu'une URL complète). Par exemple, si votre URL de connexion est https://lucid.app/saml/sso/helpcenterdemo.com, vous pouvez entrer dans le site helpcenterdemo.com.
Pour accéder aux métadonnées Okta, naviguez jusqu'à SAML Signing Certificates.
Cliquez sur Actions.
Sélectionnez View IdP metadata.
Téléchargez les métadonnées en cliquant avec le bouton droit de la souris sur l'onglet qui s'ouvre et sélectionnez Enregistrer sous, puis enregistrez sous un fichier XML.
- Ce fichier XML (métadonnées) contient les instructions dont Lucid aura besoin pour communiquer avec Okta. Vous téléchargerez le fichier sauvegardé vers Lucid.

Dans Lucide :

Sélectionnez Admin.
Cliquez sur Sécurité dans le menu de gauche.
Dans la liste déroulante, sélectionnez Authentification.
Sélectionnez Configure à droite de l'option "Allow SAML authentication" pour accéder à votre page d'activation SAML dans Lucid. Vous ne pourrez pas activer SAML tant que vous n'aurez pas renseigné votre domaine et téléchargé les métadonnées.
Sous "Lucidchart Sign in URL," entrez votre nom de domaine.
- Cela doit correspondre à ce que vous avez saisi dans la section Sign On d'Okta. Assurez-vous que le domaine que vous utilisez n'est pas déjà utilisé, ce qui empêcherait le fichier XML d'être téléchargé correctement.
Cliquez sur Enregistrer les modifications.
Faites défiler la page SAML Activation de Lucid et cliquez sur Add Identity Provider pour charger le fichier XML que vous avez téléchargé depuis Okta.
- Les métadonnées rempliront les champs suivants :
Cliquez sur Test SAML Connection pour vérifier que Lucid communique correctement avec Okta.
- La connexion ne fonctionnera que si l'application Lucid a été attribuée à votre utilisateur test dans Okta. Vous pouvez attribuer l'application à des utilisateurs dans la section Affectations de la page de l'application.
Retournez à la page Authentification.
Cochez la case située à côté de "Autoriser l'authentification SAML".
Cliquez sur Enregistrer les modifications.

Vous avez la possibilité d'utiliser des assertions chiffrées pour les fournisseurs d'identité que vous ajoutez à votre compte Lucid pour SAML. Pour en savoir plus, consultez notre article de présentation de SAML.

Remarque : vous pouvez sélectionner la méthode d'authentification par défaut dans Lucid, après avoir coché les méthodes que vous souhaitez autoriser comme options de connexion ci-dessus. Les utilisateurs seront invités à se connecter en utilisant la méthode d'authentification par défaut que vous avez définie dans la page Authentification.

Créer des utilisateurs lors de la connexion avec SAML

Une fois que vous avez configuré SAML avec Okta pour votre compte Lucidchart, vous pouvez configurer le provisionnement juste à temps (JIT) de sorte que les utilisateurs auxquels l'accès à Lucidchart est attribué dans Okta et qui n'ont pas de compte Lucidchart auront un compte créé pour eux lors de leur première connexion.

Note : Pour que ce provisionnement fonctionne, le contrôle de domaine doit être activé.

Vous pouvez configurer le provisionnement Just-In-Time dans la section Paramètres de licence de votre panneau d'administration Lucid.

Si vous souhaitez que tous les utilisateurs accèdent à votre compte Lucidchart avec des licences d'édition complètes, choisissez les paramètres suivants :
- Dans la section "Éligibilité à l'accès", sélectionnez Éligiblepour un accès complet.
- Sous "Critères d'éligibilité personnalisés", sélectionnez Instant access.
Si vous souhaitez que tous les utilisateurs se connectent en tant qu'utilisateursà accès limité , dans la section "Éligibilité à l'accès", sélectionnez Uniquement éligibles à l'accès limité.
- Vos utilisateurs pourront toujours demander des licences d'édition intégrale. En fonction du paramètre "Lorsqu'un utilisateur demande une licence", vous pouvez faire en sorte que les licences soient automatiquement accordées aux utilisateurs à leur demande, ou que les demandes deviennent des demandes en attente dans votre liste d'utilisateurs.

Note : Nous vous recommandons fortement d'avoir une boîte de dialogue de demande personnalisée si vous avez des utilisateurs qui demandent des licences à un administrateur.

Ajouter des attributs d'utilisateur par le biais d'un approvisionnement juste à temps (JIT)

Le provisionnement JIT utilise le protocole SAML pour créer un utilisateur Lucid lorsqu'une personne à qui vous avez attribué un accès Lucidchart dans votre instance Okta se connecte à Lucid pour la première fois. Vous pouvez également configurer SAML pour qu'il envoie des attributs supplémentaires à Lucid pour ces utilisateurs, tels que le prénom, le nom de famille et l'adresse électronique de l'utilisateur.

Note : Les valeurs de licence ne peuvent pas être envoyées à Lucid via le provisionnement JIT. Cela signifie que vous ne pouvez pas mettre à jour, supprimer ou désactiver un utilisateur en utilisant le provisionnement JIT dans Lucid, car il ne fonctionne que lors de la première connexion de l'utilisateur. Toute mise à jour, suppression ou désactivation doit être effectuée manuellement à partir de la page de gestion des utilisateurs du panneau d'administration de Lucid.

Procédez comme suit pour configurer les attributs du prénom, du nom et de l'adresse électronique :

Connectez-vous à votre compte Okta.
Naviguez vers l'application Lucid dans Okta
Sélectionnez l'onglet Sign on.
Dans le coin supérieur droit de la section Sign On, sélectionnez Edit.
Cliquez sur la flèche à gauche de "Attributs (facultatif)" pour développer le menu.
Configurez le prénom d'un utilisateur :
- Ajoutez un titre au champ nom. Cette valeur ne doit pas nécessairement correspondre à la section déroulante Valeur.
- Dans le champ Format du nom, sélectionnez Non spécifié dans la liste déroulante.
- Cliquez sur le menu déroulant situé sous "Valeur".
- Sélectionnez user.firstName dans la liste déroulante.
Pour ajouter un autre champ, cliquez sur Ajouter un autre.
Répétez les instructions des étapes 8 à 9 pour le nom de famille et l'adresse électronique avec les champs nom et valeur spécifiés ci-dessous :
- Pour ajouter le nom de famille d'un utilisateur :
  - Ajoutez un titre au champ nom.
  - Sélectionnez user.lastName dans la liste déroulante du champ Value.
- Pour ajouter l'adresse électronique d'un utilisateur :
  - Ajoutez un titre au champ Nom de l'email.
  - Sélectionnez user.email dans la liste déroulante du champ Valeur
Après avoir ajouté les attributs d'utilisateur décrits dans ces étapes, vous pouvez vous attendre à ce que votre page Okta ressemble à ceci :
Faites défiler jusqu'au bas de cette fenêtre intérieure.
Cliquez sur Enregistrer.

Désormais, lorsqu'un utilisateur se connectera pour la première fois et créera son compte Lucid, son prénom, son nom de famille et son adresse électronique seront correctement configurés.

Configurer le SCIM pour la Lucid Suite dans Okta

Pour créer des utilisateurs avant leur première connexion via Okta, configurez l'intégration Lucid SCIM en suivant les étapes ci-dessous.

Remarque : Les instructions de cet article concernant la configuration du SCIM s'appliquent si vous configurez le SCIM pour la première fois sur votre compte Lucid Enterprise. Si vous utilisiez déjà le SCIM avant le 22 octobre 2024, vous devez migrer vers les nouveaux groupes organisationnels. Consultez notre article sur la migration vers Okta pour obtenir des instructions.

Avant de configurer le SCIM, veuillez effectuer les opérations suivantes dans votre compte Lucid :

Confirmez que vous êtes sur un compte Entreprise avec un plan tarifaire à jour. Pour effectuer une mise à niveau, contactez le service des ventes.
Contactez votre responsable de la réussite des clients Lucid ou l'assistance pour demander que le SCIM soit activé pour votre compte.
Assurez-vous que la mise à niveau automatique est activée dans vos paramètres de licence. Si ce paramètre n'est pas activé, vous ne pourrez pas générer de jeton de support pour configurer le SCIM. Vous pouvez désactiver la mise à niveau automatique après avoir généré un jeton de support afin d'éviter l'octroi de licences non désirées pendant le processus de configuration.

Une fois que vous avez suivi les étapes de préconfiguration énumérées ci-dessus, vous pouvez configurer SCIM pour la Lucid Suite dans Okta en générant un jeton de support dans Lucid et en l'utilisant ensuite dans Okta.

Générer un jeton de porteur dans Lucid

Connectez-vous à Lucid en tant que propriétaire ou administrateur de compte.
Sélectionnez Admin dans le menu de gauche.
Sélectionnez App integration dans le menu de navigation de gauche.
Sur la tuile SCIM, sélectionnez Paramètres.
Cliquez sur Générer un jeton.
- Si vous ne pouvez pas cliquer sur Générer un jeton , assurez-vous que l'option "Mettre automatiquement à niveau le compte lorsqu'il n'y a plus de licences disponibles" est cochée dans vos paramètres de licence et réessayez.
Copiez le jeton porteur.

Configurer l'intégration et utiliser le bearer token dans Okta

Connectez-vous à Okta en tant qu'administrateur.
Ouvrez l'interface d'administration.
Allez dans l'onglet Provisioning.
Cliquez sur Configurer l'intégration API.
Cochez la case située à côté de "Activer l'intégration API".
- Un champ de texte apparaît dans lequel vous pouvez ajouter le code généré par Lucid.
Collez le jeton de porteur généré par Lucid dans le champ du jeton API.
Cliquez sur Enregistrer.

Une fois la connexion Lucid et Okta établie, vous pouvez sélectionner les points d'intégration que vous souhaitez activer pour SCIM et commencer à utiliser la connexion SCIM pour créer des utilisateurs et leur attribuer des licences. Voir les sections ci-dessous pour plus d'informations.

En savoir plus : Améliorez la collaboration au sein de l'équipe et les recommandations d'outils dans Lucid en configurant des correspondances de champs facultatifs pour le titre et le département. Pour voir les étapes, lisez notre article de la communauté Okta SCIM field mappings.

Créer un groupe Tous les utilisateurs

Suivez ces étapes pour configurer un groupe Tous les utilisateurs dans Okta.

Accédez à l'onglet "Assignments" de l'application Lucid dans Okta.
Cliquez sur Affecter en haut à gauche de la page Affectations.
Dans la liste déroulante, sélectionnez Assigner à des groupes.
Dans le menu "Filtres" sur le côté gauche, cliquez sur Groupes.
Recherchez votre groupe "Tous les utilisateurs".
- Il est important d'avoir un groupe Tous les utilisateurs (qui aura probablement un nom différent pour votre entreprise) car il est généralement utilisé pour affecter tous les utilisateurs de votre entreprise à cette application Okta. C'est ce qui leur permet de se connecter et de voir les chiclets sur la page principale des applications Okta.
Cliquez sur Affecter.

Note : Chaque utilisateur de votre compte doit appartenir au groupe "Tous les utilisateurs", quel que soit le groupe de push auquel il appartient suite à la création de groupes de push avec ou sans licence effectuée dans la section suivante.

Attribuer des licences et retirer des licences à des groupes par poussée de groupe

Group Push in Okta permet aux administrateurs de pousser les groupes d'Okta vers Lucid et de gérer les groupes organisationnels de Lucid par le biais d'Okta. Ces groupes de poussée Okta sont également utilisés pour accorder et retirer des licences aux utilisateurs dans Lucid.

Pour créer de nouveaux groupes de poussée qui fonctionnent avec les groupes d'organisation Lucid, procédez comme suit :

Sélectionnez l'onglet Push Groups dans le menu situé en haut de la page de l'application Lucid dans Okta.
Cliquez sur + Pousser les groupes.
Dans la liste déroulante, sélectionnez Rechercher des groupes par nom.
Nous vous recommandons de personnaliser les groupes suivants :
- Un groupe "Lucid Suite Licensed User": Ce groupe sera utilisé pour attribuer à un utilisateur une licence dans Lucid en fonction de son appartenance au groupe.
  - Les utilisateurs affectés à ce groupe ne peuvent pas être affectés à un autre groupe à accès limité, en lecture seule ou sans licence puisqu'il est utilisé pour octroyer une licence à un utilisateur.
- Un groupe "Lucid Suite Limited Access": Ce groupe sera utilisé pour retirer des utilisateurs du groupe des utilisateurs licenciés afin de libérer des licences pour d'autres utilisateurs.
  - Les utilisateurs assignés à ce groupe ne peuvent pas être également assignés au groupe "Licensed User" puisqu'il est utilisé pour retirer une licence à un utilisateur.
Cliquez sur Enregistrer & Ajouter un autre si vous devez ajouter un autre groupe.
Cliquez sur Enregistrer lorsque vous avez ajouté votre dernier groupe.

Remarque : Un utilisateur ne peut appartenir qu'à un seul groupe d'organisation et, par conséquent, qu'à un seul groupe de poussée à la fois. Mais vous pouvez avoir autant de groupes d'utilisateurs avec licence et sans licence que vous le souhaitez.

Afficher les groupes push Okta en tant que groupes organisationnels dans Lucid

À ce stade du processus, nous vous recommandons de vérifier que les groupes push Okta attendus apparaissent comme groupes d'organisation dans Lucid, ce qui confirme que la migration s'est déroulée avec succès. Pour accéder à la page des groupes d'organisation dans Lucid, procédez comme suit :

Accédez au panneau d'administration de Lucid.
Sélectionnez Groupes dans le menu de navigation de gauche.
Dans le menu déroulant, cliquez sur Groupes d'organisation.

Sur cette page du panneau d'administration de Lucid, vous pouvez vous attendre à ce que vos groupes Okta push soient considérés comme des groupes organisationnels.

lucid-suite-scim-user-groups-visible-as-organizational-groups-in-lucid.png

Attribuer des rôles aux utilisateurs avec le SCIM

Pour définir le rôle d'un utilisateur, vous utiliserez les chaînes "Team Admin" et "Billing Admin." Pour appliquer les deux rôles d'administrateur à un utilisateur, vous devrez attribuer plusieurs rôles aux utilisateurs ou aux groupes plutôt qu'un seul rôle avec une chaîne concaténée.

Note : Les chaînes ci-dessus doivent correspondre à la capitalisation exprimée pour ces rôles d'utilisateur. N'oubliez pas que dans le panneau d'administration de Lucid, le rôle d'administrateur d'équipe a été renommé en administrateur de compte.

FAQ

Qu'advient-il des documents lorsque je retire une licence à un utilisateur via le SCIM ?

Lorsque vous retirez une licence à un utilisateur ou que vous le supprimez via le SCIM, vous devez transférer ses documents à un autre utilisateur sur votre compte Enterprise.
Par défaut, le propriétaire du compte sera le destinataire des documents qui sont automatiquement transférés lors de la suppression d'une licence ou d'un utilisateur. Vous pouvez modifier le destinataire des documents transférés en accédant aux paramètres d'intégration SCIM dans le panneau d'administration de Lucid et en sélectionnant Modifier le propriétaire par défaut à droite de l'adresse e-mail. Voir la capture d'écran ci-dessous à titre de référence.

En cliquant sur Modifier le propriétaire par défaut, vous êtes redirigé vers la page "Paramètres de conformité" du panneau d'administration, où vous pouvez modifier le propriétaire par défaut des documents de votre compte. Reportez-vous à l'article du panneau d'administration de Lucid : Paramètres de conformité pour plus de détails.

change-recipient-of-documents-when-deleting-or-delicensing-users-via-SCIM.png (en anglais)

Le provisionnement JIT gère-t-il les mises à jour, les suppressions et les désactivations d'utilisateurs dans Lucid ?

Non. Le provisionnement JIT ne peut pas mettre à jour, supprimer ou désactiver un utilisateur dans Lucid puisqu'il ne fonctionne que lors de la première connexion d'un utilisateur. Cela signifie que toute mise à jour, suppression ou désactivation doit être effectuée manuellement dans le panneau d'administration de Lucid.

Si vous souhaitez mettre à jour les utilisateurs et permettre l'automatisation de la suppression ou de la désactivation d'utilisateurs, vous devez utiliser SCIM au lieu de Just-In-Time Provisioning.

Ressources

Pour en savoir plus sur cette fonctionnalité ou pour poser des questions supplémentaires, consultez les ressources complémentaires ci-dessous. Ces ressources sont disponibles en anglais uniquement.

Publication de la communauté

Instructions pour la mise à jour du certificat de métadonnées de l'IdP (renouvellement du certificat SSO)

Donnez votre avis sur cet article

Vous avez des commentaires sur cet article ? Racontez-nous votre expérience ici.

Articles associés