L'intégration de Lucid avec Okta permet à vos utilisateurs de s'authentifier en utilisant la signature unique SAML via Okta. En outre, notre intégration SCIM permet aux administrateurs de créer des utilisateurs et de fournir et de déprovisionner des utilisateurs au sein même d'Okta, sans avoir à se connecter à Lucid. Le tutoriel suivant présente le processus d'intégration d'Okta avec Lucid. Vous aurez besoin de privilèges d'administrateur dans Okta et Lucid pour réaliser 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

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, tu peux configurer l'intégration SAML pour que les utilisateurs finaux de ton instance Okta puissent s'authentifier à l'aide de l'ouverture de session SAML par l'intermédiaire d'Okta. Utilise l'appli Lucid présentée ci-dessous pour toutes les nouvelles fonctionnalités et mises à jour.
Dans la section Paramètres généraux 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 l'ouverture de session initiée par le PDN.
Dans l'onglet Sign On d'Okta, cliquez sur Edit dans le coin supérieur droit.
Sélectionne SAML 2.0 comme méthode de connexion.
Saisissez votre nom de domaine SAML sous Paramètres avancés d'ouverture de session.
- Veille à ne saisir que ton domaine (plutôt qu'une URL complète). Par exemple, si ton URL de connexion est https://lucid.app/saml/sso/helpcenterdemo.com, tu peux saisir helpcenterdemo.com.
Pour accéder aux métadonnées Okta, accédez à Certificats de signature SAML.
Cliquez sur Actions.
Sélectionne Voir les métadonnées IDP.
Téléchargez les métadonnées en faisant un clic droit sur l'onglet qui s'ouvre et sélectionnez Enregistrer sous , et enregistrez sous un fichier XML.
- Ce fichier XML (métadonnées) contient des instructions dont Lucid aura besoin pour communiquer avec Okta. Vous allez télécharger le fichier enregistré dans Lucid.

Dans Lucide :

Sélectionnez Admin.
Clique sur Security dans le menu de gauche.
Dans le menu déroulant, sélectionne Authentication.
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," entrez votre nom de domaine.
- Cela doit correspondre à ce que tu as saisi dans la section d'ouverture de session dans Okta. Assure-toi que le domaine que tu utilises n'est pas déjà utilisé, ce qui empêcherait le fichier XML de se télécharger correctement.
Cliquez sur Enregistrer les modifications.
Fais défiler la page d'activation SAML de Lucid et clique sur Add Identity Provider pour télécharger le fichier XML que tu as téléchargé d'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é affectée à votre utilisateur de test dans Okta. Vous pouvez affecter l’application aux utilisateurs dans la section Affectations de la page de l’application.
Retourne à la page d'authentification.
Cochez la case en regard de "Autoriser l'authentification SAML".
Clique sur Sauvegarder les changements.

Remarque : Tu peux sélectionner la méthode d'authentification par défaut dans Lucid, après avoir coché les méthodes que tu souhaites autoriser comme options de connexion ci-dessus. Les utilisateurs seront invités à se connecter à l'aide de la méthode d'authentification par défaut que tu as 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 afin que les utilisateurs auxquels un accès Lucidchart a été attribué dans Okta et qui n'ont pas de compte Lucidchart aient 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é.

Tu peux configurer le provisionnement Just-In-Time dans la section License settings du panneau d'administration de Lucid.

Si vous souhaitez que tous les utilisateurs se joignent à votre équipe Lucidchart avec des licences complètes, définissez le paramètre "Lorsqu'un nouvel utilisateur se joint à une équipe" sur ". Accorder automatiquement la licence."
Si tu veux que tous les utilisateurs arrivent en tant qu'utilisateurs à accès limité , règle le paramètre pour " 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 tu peux faire en sorte que les demandes deviennent des demandes en attente dans ta liste d'utilisateurs.

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

Configurer les paramètres de licence pour attribuer des licences à partir d'Okta.

Si tu veux attribuer des licences depuis Okta plutôt que dans Lucid, tu devras configurer tes paramètres Lucidchart, Lucidspark et Lucidscale d'une manière spécifique. Va sur ton site Paramètres de licence et configure tes paramètres comme suit :

Lorsqu'un nouvel utilisateur rejoint une équipe = Ne pas accorder automatiquement de licence
Lorsqu'un utilisateur demande une licence = Ne pas accorder automatiquement de licence

Configurer SCIM pour la suite Lucid dans Okta

Si vous souhaitez créer les utilisateurs de Lucidchart, Lucidspark et Lucidscale avant leur première connexion (et déterminer leur type de licence) via Okta, vous pouvez configurer l'intégration SCIM de Lucid.

Avant de configurer SCIM, veuillez effectuer les opérations suivantes :

Confirmez que vous êtes sur un compte Entreprise avec un plan tarifaire à jour. Pour vous mettre à jour, veuillez consulter notre page de tarification.
Contacter le Customer Success Manager de Lucid ou contact support pour demander l'activation du SCIM pour son compte.
Assurez-vous que la mise à jour automatique est activée dans vos paramètres de licence. Vous ne pourrez pas générer un jeton au porteur pour configurer SCIM si ce paramètre n'est pas activé. Vous pouvez désactiver la mise à jour automatique après avoir généré un jeton au porteur afin d'éviter des licences non souhaité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 suite Lucid dans Okta en suivant ces étapes :

Dans Okta, va dans ton onglet Provisioning et clique sur Configure API Integration, et coche la case à côté de "Enable API Integration". Un champ de texte apparaît que tu rempliras avec un code généré par Lucidchart (voir l'étape suivante).
Ouvrez Lucid dans une nouvelle fenêtre et sélectionnez Admin.
Sélectionnez Intégration d'applications dans le menu de gauche.
Sélectionnez la tuile SCIM .
Cliquer Générer un jeton .
- Lucid remplit le champ de texte "Bearer Token" avec un code unique que tu dois partager avec Okta.
  
  Après cette étape, tu peux désactiver le paramètre de croissance automatique dans ta page de paramètres de licence Lucid afin d'éviter que des licences non désirées ne soient accordées pendant le reste du processus de configuration. Une fois que tu as confirmé que tes points de connexion SCIM sont correctement configurés, tu peux réactiver la croissance automatique pour que le provisionnement des utilisateurs et l'attribution des licences aient lieu.
De retour dans Okta, collez le jeton de porteur généré par Lucid dans le champ jeton API.
Cliquez sur Enregistrer.

Une fois la connexion Lucid-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. Pour plus d'informations, consultez les sections ci-dessous.

Attribuer des licences Lucid Suite à partir d’Okta

Les étapes suivantes s’appliquent uniquement si vous avez été migré vers un compte Lucid Suite Enterprise.

Pour qu’Okta SCIM puisse correctement mettre à jour, ajouter ou supprimer des licences, nous vous recommandons de ne disposer que d’un seul groupe Lucid Licensed qui détermine les licences pour Lucidchart et Lucidspark. Si vous utilisez des groupes distincts pour les utilisateurs sous licence Lucidchart et Lucidspark, combinez-les en un seul groupe sous licence Lucid Suite.

Une fois que cela est terminé et que votre connexion SCIM a été établie, configurez l’approvisionnement de la licence Okta en procédant comme suit :

Dans l’onglet « Affectations » de l’application Lucid dans Okta, cliquez sur Attribuer.
Sélectionne Assigner aux groupes.
Recherche le groupe nouvellement créé pour tous les utilisateurs licenciés et clique sur Assign.
Sélectionnez Modifier pour personnaliser les paramètres d’attribut d’approvisionnement pour ce groupe et définissez les valeurs Lucidchart_Licensed et Lucidspark_Licensed sur « true » pour les deux.
Clique sur Sauvegarder.
Veille à ce que le groupe Lucid Suite Licensed soit listé en premier dans la liste des priorités. Une fois le nouveau groupe Lucid Suite Licensed en première priorité et tous les utilisateurs licenciés ajoutés au groupe, tous les autres groupes d'utilisateurs licenciés peuvent être désassignés. Si tu as un groupe à accès limité, il doit rester assigné dans la deuxième priorité.

Attribuer des rôles aux utilisateurs avec SCIM

Pour définir le rôle d'un utilisateur, vous utiliserez les chaînes de caractères "Team Admin" et "Billing Admin." Pour spécifier les utilisateurs comme Team & Billing Admins, vous devrez attribuer plusieurs rôles aux utilisateurs ou aux groupes plutôt qu'un seul rôle avec une chaîne de caractères concaténée.

Gérer les groupes avec Group Push

Lucid prend désormais en charge Group Push avec Okta, ce qui permet aux administrateurs de pousser des groupes d’Okta vers Lucid ainsi que de gérer des groupes créés dans Lucid via Okta.

Pour en savoir plus: Pour plus d’informations sur Group Push, consultez la documentation d’Okta sur l’utilisation de Group Push et Enhanced Group Push.

Si vous souhaitez activer Group Push et que votre application Lucid est déjà configurée avec SCIM, vous devrez vous authentifier à nouveau auprès de l’API Lucid SCIM. Pour ce faire, procédez comme suit :

Connectez-vous à votre org Okta en tant qu'administrateur.
Ouvrez l'interface d'administration.
Ouvrez votre instance de l'application Lucidchart.
Allez dans l'onglet Provisionnement.
Dans la section Paramètres, cliquez sur Intégration .
Cliquez sur Editer .
Select Test API Credentials .
Cliquez sur Enregistrer .

Les nouvelles fonctionnalités SCIM devraient maintenant être activées pour votre application Lucid.

Migrer vers la nouvelle application Lucid

Comme nous avons à la fois une application Lucidchart et Lucid, vous devrez savoir comment migrer vers la nouvelle application Lucid. Pour accéder aux nouveaux attributs SCIM, même si vous utilisez actuellement l'application Lucid, vous devez ajouter une nouvelle instance de l'application Lucid dans votre organisation Okta. Si vous avez déjà une instance existante de l'application Lucidchart ou de l'application Lucid, suivez les étapes ci-dessous pour migrer de cette ancienne instance vers une instance nouvellement mise à jour de l'application Lucid.

Connectez-vous à votre organisation Okta en tant qu'administrateur.
Open the Admin UI.
Cliquez sur Ajouter des applications .
Ajouter une nouvelle instance de Lucid.
Désactivez tout le provisionnement dans votre ancienne application en désactivant "Create Users," " Update User Attributes," et "Deactivate Users."
Configurez la nouvelle application, y compris le provisionnement - comme "Créer des utilisateurs", "Mettre à jour les attributs des utilisateurs" et "Désactiver les utilisateurs".
- Le provisionnement devrait se dérouler sans problème. S'il y a un "Not Found" sur l'aspect de la découverte, ces utilisateurs devront être supprimés de l'application Okta et ré-additionnés pour forcer un remappage de l'ID externe.
Une fois le provisionnement SCIM activé, accédez à l'onglet Importation de votre nouvelle instance d'application.
Cliquez sur Importer maintenant .
Après avoir téléchargé les utilisateurs de Lucid, sélectionnez les utilisateurs que vous voulez créer ou lier dans Okta.
Cliquer Confirmer les affectations .
Une fenêtre pop-up apparaîtra pour vous demander si vous souhaitez procéder à la confirmation de l'affectation.
Cliquez sur Confirmez .
Retournez à votre tableau de bord d'administration.
Ouvrez votre ancienne instance d'application.
- Il s'agit de la précédente application Lucidchart ou Lucid que vous avez ajoutée avant d'en ajouter une nouvelle à l'étape 4.
Allez dans l'onglet Provisionnement.
Sélectionne Intégration.
Cliquez sur Editer .
Décochez la case "Activer l'intégration API".
Cliquez sur Enregistrer .
Vous devez maintenant désactiver et supprimer votre ancienne instance d'application et commencer à utiliser la nouvelle application que vous avez ajoutée.

Remarque : Si vous utilisiez SAML comme mode de connexion pour votre ancienne instance d’application Lucidchart ou Lucid, vous devez configurer SAML sur votre nouvelle instance dans Okta.

FAQ

Qu'arrive-t-il aux documents lorsque je retire une licence à un utilisateur via SCIM ?

Lorsque tu retires ou supprimes un utilisateur via SCIM, tu dois transférer ses documents à un autre utilisateur sur ton compte Enterprise. Cela ne s'applique pas à la désactivation des utilisateurs.
Par défaut, le propriétaire du compte sera le destinataire des documents qui sont automatiquement transférés lors de la suppression 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 et en sélectionnant Modifier le propriétaire par défaut sur le côté droit de l’adresse e-mail. Voir la capture d’écran ci-dessous pour référence.

Cliquer sur Modifier le propriétaire par défaut te redirige vers la page "Document & Folder Settings" du panneau d'administration où tu peux changer le propriétaire par défaut des documents de ton compte. Reporte-toi à Panneau d'administration de Lucid : Documents et dossiers 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