Activer Okta SAML et SCIM dans Lucid

Fonctionnalités prises en charge

Fonctionnalités SAML SSO :

• Authentification unique (SSO) initiée par SP
• Authentification unique (SSO) initiée par le fournisseur d'identité (IdP)
• Approvisionnement JIT (Just-In-Time)

Fonctionnalités de provisionnement SCIM :

• Créer des utilisateurs
• Mettre à jour les attributs de l'utilisateur
• Désactiver des utilisateurs 
• Groupes de diffusion

Configurez l'intégration SAML pour Lucid

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

Dans Lucide :

1. Sélectionnez Admin.
2. Cliquez sur Sécurité dans le menu de gauche.
3. Dans la liste déroulante, sélectionnez Authentification.

4. Cliquez sur « Configurer » à droite de l'option « Autoriser l'authentification SAML » pour accéder à la page d'activation SAML dans Lucid. Vous ne pourrez pas utiliser SAML tant que vous n'aurez pas renseigné votre domaine et téléchargé les métadonnées.

   

5. À l'adresse ", dans le champ « URL de connexion à Lucid »,", saisissez votre nom de domaine.
   • Assurez-vous que le domaine que vous utilisez n'est pas déjà pris, car il sert à identifier de manière unique votre compte lors de la connexion unique (SSO).
     
6. Cliquez sur Enregistrer les modifications.
7. Copiez l'URL ACS depuis Lucid (vous en aurez besoin dans Okta).

Dans Okta :

1. 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. 
2. Dans la section « Paramètres généraux » de l'application Lucid for admin management dans Okta :
   • Collez l'URL ACS fournie par Lucid dans le champ « URL SAML »
   • "Indiquez si vous souhaitez afficher l'" de création de diagrammes "et/ou l' de tableau blanc ". Chacune de ces applications apparaîtra dans la galerie d'applications de vos utilisateurs afin de faciliter la connexion initiée par le fournisseur d'identité (IdP).
     
3. Dans l'onglet « "» (Connexion) d'Okta, sous «" » (Configuration de l'authentification), accédez à « SAML Signing Certificates » (Certificats de signature SAML).
4. Cliquez sur Actions.
5. Sélectionnez View IdP metadata.
   
6. Pour télécharger les métadonnées, cliquez avec le bouton droit de la souris n'importe où sur la page XML, sélectionnez « Enregistrer sous », puis enregistrez-les sous forme de fichier XML (par exemple, « metadata.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 :

1. Ouvrez le panneau d'administration de Lucid.
2. Cliquez sur « Intégration d'applications » dans le menu de navigation situé à gauche.
3. Sélectionnez « Général » dans les options de navigation.
4. Sous « Intégrations activées » ( ")", cliquez sur « Paramètres » (Settings ) dans la vignette « SAML "»".
5. Faites défiler la page « Activation SAML » vers le bas, puis cliquez sur « + Ajouter un fournisseur d'identité » pour importer le fichier XML que vous avez téléchargé depuis Okta.
   • Les métadonnées rempliront les champs suivants :
     
6. Cliquez sur «Tester la connexion SAML» pour vérifier que Lucid communique correctement avec Okta. 
   • La connexion ne fonctionnera que si l'application Lucid for admin management 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.
   • Le test peut échouer si vous n'avez pas activé SAML comme méthode d'authentification. Si tel est le cas, accédez à la page « Authentification » dans les paramètres de sécurité de votre panneau d'administration Lucid, puis vérifiez que la case « Autoriser l'authentification SAML » est cochée.
     

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 deprésentation de SAML.

Créer des utilisateurs lors de la connexion avec SAML

Une fois que vous avez configuré SAML avec Okta pour votre compte Lucid, vous pouvez mettre en place la création de compte « juste à temps » (JIT) afin que les utilisateurs auxquels un accès à Lucid a été attribué dans Okta, mais qui ne possèdent pas encore de compte Lucid, se voient créer un compte lors de leur première connexion.

Note : Pour que le provisionnement JIT fonctionne comme prévu, vous devez activer le contrôle de domaine et définir la méthode de vérification de l'utilisateur sur SAML.

Vous pouvez personnaliser l'attribution de licences « juste à temps » dans la section des paramètres de licence de votre panneau d'administration Lucid, en fonction des droits d'accès que vous souhaitez accorder aux utilisateurs. Voici les options :

• Si vous souhaitez que tous les utilisateurs aient accès à votre compte Lucid avec des licences d'édition complètes, sélectionnez les paramètres suivants :
  • Dans la section "Éligibilité à l'accès", sélectionnez Éligible à l'accès complet.
  • Sous "Critères d'éligibilité personnalisés", sélectionnez Accès instantané.
• 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 complète. En fonction du paramètre «Lorsqu'un utilisateur demande une licence », vous pouvez attribuer automatiquement des licences aux utilisateurs dès qu'ils en font la demande, ou bien transformer ces demandes en demandes en attente dans votre liste d'utilisateurs.

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

La configuration JIT utilise le protocole SAML pour créer un utilisateur Lucid lorsqu'une personne à qui un accès à Lucid a été attribué dans votre instance Okta se connecte à Lucid pour la première fois. Vous pouvez également configurer SAML pour envoyer des attributs supplémentaires à Lucid pour ces utilisateurs, tels que leur prénom, leur nom et leur adresse e-mail.

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

1. Connectez-vous à votre compte Okta.
2. Naviguez vers l'application de gestion Lucid for admin dans Okta
3. Sélectionnez l'onglet « Connexion ».
4. Dans le coin supérieur droit de la section Sign On, sélectionnez Edit.
5. Cliquez sur la flèche à gauche de "Attributs (facultatif)" pour développer le menu.
6. 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.
7. Pour ajouter un autre champ, cliquez sur Ajouter un autre.
8. Répétez les instructions pour le nom de famille et l'adresse e-mail en utilisant les champs « nom » et « valeur » indiqués ci-dessous :
   • Pour ajouter le nom de famille d'un utilisateur :
     • Ajoutez un titre au champ nom.
     • Sélectionnez « user.lastName » dans le menu déroulant des champs de valeur
   • 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
9. Après avoir ajouté les attributs d'utilisateur décrits dans ces étapes, vous pouvez vous attendre à ce que votre page Okta ressemble à ceci :
10. Faites défiler jusqu'au bas de cette fenêtre intérieure.
11. 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 SCIM de Lucid en suivant les étapes ci-dessous.

Avant de configurer SCIM, assurez-vous que vous disposez d'un compte Entreprise avec une formule tarifaire à jour. Pour effectuer une mise à niveau, veuillez contacter le service commercial.

Une fois que vous avez suivi les étapes de préconfiguration énumérées ci-dessus, vous pouvez configurer à la fois le SCIM pour la gestion des administrateurs et le SCIM pour les applications d'accès au contenu de la Lucid Suite dans Okta en générant des jetons de porteur distincts dans Lucid et en les utilisant ensuite dans Okta. Pour en savoir plus sur les différences et la valeur de chaque application, consultez notre article SCIM overview for Lucid.

Activez le SCIM et générez un jeton de support dans Lucid

1. Connectez-vous à Lucid en tant que propriétaire ou administrateur de compte.
2. Sélectionnez Admin dans le menu de gauche.
3. Sélectionnez App integration dans le menu de navigation de gauche.
4. Sur la tuile SCIM concernée, sélectionnez Paramètres (ou Installer).
   • Pour configurer les deux applications, vous devrez suivre séparément les étapes restantes pour le SCIM pour la gestion administrative et le SCIM pour l'accès au contenu. Vous générerez un jeton porteur distinct pour chaque application.
5. Dans la section relative au jeton porteur, cliquez sur Générer un jeton.
   • L'URL de base Lucid et le jeton Bearer seront nécessaires pour les étapes suivantes dans Okta.

Configurer l'intégration et utiliser le(s) jeton(s) porteur(s) dans Okta

Selon que vous souhaitez utiliser le SCIM pour la gestion administrative, le SCIM pour l'accès au contenu ou les deux, les étapes à suivre seront légèrement différentes.

Configuration du SCIM pour la gestion administrative

1. Connectez-vous à Okta en tant qu'administrateur.
2. Ouvrez la console d'administration Okta et accédez à votre application Lucid.
3. "" Dans l'onglet « Général » (General) de l'", dans la section « Paramètres de l'application » (App Settings) de l'", ajoutez l'URL de base SCIM.
   
   • Cette URL peut être copiée directement depuis la page de gestion SCIM pour administrateurs dans Lucid.
     
4. Dans l'onglet « Provisioning » (Provisionnement) de l'", sous «" » ( Intégration de l'API), cliquez sur « Configure API Integration » (Configur er l'intégration de l'API).
5. Cochez la case située à côté de "Activer l'intégration API". 
   • Un champ de saisie s'affichera, dans lequel vous pourrez saisir votre jeton porteur généré par Lucid.
     
6. Collez le jeton de porteur généré par Lucid à partir du SCIM pour la gestion administrative dans le champ du jeton API.
   • Gardez à l'esprit que si vous configurez les deux applications Lucid SCIM, il s'agit d'un jeton porteur distinct du jeton d'accès au contenu SCIM. Veillez à utiliser la bonne pour chaque application.
7. Assurez-vous que la case « Importer les groupes » n'est pas cochée (à moins que vous ne souhaitiez importer vos groupes d'organisation Lucid existants dans Okta).
8. Cliquez sur Enregistrer.

Une fois la connexion entre Lucid et Okta établie, vous pouvez commencer à utiliser la connexion SCIM pour créer des utilisateurs et des groupes et gérer les licences. Pour plus d'informations, veuillez consulter les sections ci-dessous.

Configuration du SCIM pour l'accès au contenu

1. Connectez-vous à Okta en tant qu'administrateur.
2. Parcourez le réseau d'intégrations Okta et recherchez "Lucid".
3. Créez une nouvelle application Lucid.
   • Si vous utilisez également SCIM pour la gestion administrative, nous vous recommandons de nommer cette application « Lucid pour l'accès au contenu » afin de distinguer les deux.
4. Dans la section « Paramètres généraux » de l'application Lucid for content access dans Okta, indiquez si vous souhaitez afficher "(outils de création de diagrammes)" et/ou "(tableau blanc)".
   • Si vous utilisez également SCIM pour la gestion administrative, nous vous recommandons de décocher les options « Diagramming » et « Whiteboarding » dans cette application afin d'éviter la duplication des vignettes Lucid pour les utilisateurs finaux.
5. Dans l'onglet « Provisioning » (Provisionnement) de l'", sous «" » ( Intégration de l'API), cliquez sur « Configure API Integration » (Configur er l'intégration de l'API).
6. Cochez la case située à côté de "Activer l'intégration API". 
   • Un champ de saisie s'affichera, dans lequel vous pourrez saisir votre jeton porteur généré par Lucid.
7. Collez le jeton de porteur généré par Lucid à partir du SCIM pour la tuile d'accès au contenu dans le champ du jeton API.
   • Gardez à l'esprit que si vous configurez les deux applications Lucid SCIM, il s'agit d'un jeton porteur distinct du jeton SCIM pour la gestion administrative. Veillez à utiliser la bonne pour chaque application.
8. Assurez-vous que la case « Importer les groupes » n'est pas cochée (à moins que vous ne souhaitiez importer vos équipes Lucid existantes dans Okta).
9. Cliquez sur Enregistrer.

Configurer le SCIM pour la gestion administrative

Les groupes que vous configurez pour SCIM pour la gestion administrative seront utilisés pour gérer les licences et les contrôles administratifs granulaires à l'échelle, y compris la gestion des attributs (par ex. centre de coûts, région, etc.) Ces groupes peuvent également être utilisés pour provisionner automatiquement les utilisateurs et les groupes Lucid org afin de refléter la hiérarchie de l'entreprise.

Créer un groupe Tous les utilisateurs

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

1. Accédez à l'onglet "Assignments" de l'application Lucid dans Okta.
2. Cliquez sur « Attribuer » en haut à gauche de la page « Attributions » de l'"" .
3. Dans la liste déroulante, sélectionnez Assigner à des groupes.
4. Recherchez votre groupe "Tous les utilisateurs".
   • Il est important de disposer d'un groupe « Tous les utilisateurs » (qui portera très probablement un autre nom dans votre entreprise), car il sert généralement à affecter tous les utilisateurs de votre entreprise à cette application Okta. C'est ce qui leur permet de se connecter et de voir les vignettes Lucid sur la page principale des applications Okta.
5. Cliquez sur Affecter.

Attribution de groupes de licences par poussée de groupe

La fonctionnalité « Group Push » dans Okta permet aux administrateurs de créer des groupes à partir d'Okta en tant que groupes organisationnels dans Lucid. Ces groupes de notification Okta servent à attribuer et à retirer des autorisations 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 :

1. Sélectionnez l'onglet Push Groups dans le menu situé en haut de la page de l'application Lucid dans Okta.
2. Cliquez sur + Pousser les groupes.
3. Dans la liste déroulante, sélectionnez Rechercher des groupes par nom.
4. Nous vous recommandons de personnaliser les groupes de licences.
   • Ces groupes seront utilisés pour attribuer à un utilisateur une licence dans Lucid en fonction de son appartenance au groupe.
   • En supprimant des utilisateurs d'un groupe de licences, vous leur retirez leur licence, ce qui libère des licences pour d'autres utilisateurs.
5. Cliquez sur Enregistrer & Ajouter un autre si vous devez ajouter un autre groupe.
6. Cliquez sur Enregistrer lorsque vous avez ajouté votre dernier groupe.

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 Okta attendus apparaissent bien en tant que groupes organisationnels dans Lucid, ce qui confirme que la configuration des groupes SCIM s'est déroulée avec succès. Pour accéder à la page des groupes organisationnels dans Lucid, procédez comme suit :

1. Accédez au panneau d'administration de Lucid.
2. Sélectionnez Groupes dans le menu de navigation de gauche.
3. 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.

Configurer les paramètres de licence pour chaque groupe

Vous êtes maintenant prêt à configurer les paramètres de licence pour chacun de vos groupes d'organisation. Cela permet de s'assurer que les utilisateurs obtiennent une licence ou un retrait de licence lorsqu'ils sont ajoutés à l'un de ces groupes ou en sont retirés. 

Pour accéder aux paramètres de licence, procédez comme suit :

1. Accédez au panneau d'administration de Lucid.
2. Sélectionnez Paramètres de licence dans le menu de navigation de gauche.
3. Dans le menu déroulant, cliquez sur Paramètres de Lucid Suite.
4. Passez à la série d'étapes appropriée ci-dessous pour personnaliser les paramètres de licence pour chaque groupe d'organisation.

Configurez les paramètres de licence pour le groupe d'utilisateurs de licence :

1. Sélectionnez le groupe de licences de votre choix dans la liste des groupes d'organisation sur le côté gauche de la page de licences.
2. Dans la section "Éligibilité à l'accès", sélectionnez Éligible à l'accès complet.
3. Sous "Critères d'éligibilité personnalisés", sélectionnez Accès instantané.
4. Cliquez sur Enregistrer les modifications.
5. Répétez ces étapes pour tous les groupes de licences supplémentaires.

Vous avez maintenant terminé toutes les étapes de reconfiguration de l'application Lucid. Les paramètres de licence seront désormais gérés par les groupes organisationnels créés via SCIM.

Attribuer des rôles aux utilisateurs avec le SCIM

Pour définir le rôle d'un utilisateur, vous utiliserez les chaînes "AccountAdmin" et "BillingAdmin." Pour attribuer ces deux rôles d'administrateur à un utilisateur, vous devrez attribuer plusieurs rôles aux utilisateurs ou aux groupes, plutôt que de leur attribuer un seul rôle sous la forme d'une chaîne concaténée.

Configurer le SCIM pour l'accès au contenu

Le SCIM pour l'accès au contenu est la solution idéale pour gérer la collaboration et le partage de documents. Cela vous permet de créer et de supprimer des utilisateurs et des équipes directement depuis votre fournisseur d'identité, mais ne gère pas les licences. Pour configurer une application d'accès au contenu via SCIM dans Okta, suivez les étapes décrites dans la section « Configurer SCIM pour Lucid Suite dans Okta », puis revenez ici pour poursuivre la procédure de personnalisation de vos groupes d'utilisateurs.

Nous vous recommandons de créer ces groupes pour le partage par département, par site, etc. en fonction des besoins de votre compte.

Affecter des utilisateurs sous l'onglet Affectations dans Okta

1. Accédez à l'onglet "Assignments" de l'application Lucid SCIM for content access que vous avez créée dans Okta.
2. Cliquez sur Affecter en haut à gauche de la page Affectations.
3. Dans la liste déroulante, sélectionnez Assigner à des groupes.
4. Recherchez les groupes pertinents que vous utiliserez pour le partage.
   • Il peut s'agir de groupes spécifiques à vos départements, à vos sites, etc. Ces groupes peuvent s'aligner sur les groupes de pression que vous utiliserez dans la section suivante.
   • Vous pouvez également utiliser le groupe "Tous les utilisateurs" que vous utilisez peut-être pour l'application SCIM for admin management. Reportez-vous à la section Configurer un groupe Tous les utilisateurs si vous souhaitez l'utiliser.
5. Cliquez sur Affecter.

Ajouter des utilisateurs aux groupes push dans Okta

La fonctionnalité « Group Push » dans Okta permet aux administrateurs d'exporter des groupes depuis Okta vers Lucid et de gérer les équipes Lucid en vue d'un partage via Okta. 

Pour créer de nouveaux groupes de poussée pour l'accès au contenu, procédez comme suit :

1. Sélectionnez l'onglet Push Groups dans le menu situé en haut de la page de l'application Lucid dans Okta.
2. Cliquez sur + Pousser les groupes.
3. Dans la liste déroulante, sélectionnez Rechercher des groupes par nom.
4. Ajoutez et personnalisez les groupes que vous souhaitez pour le partage de documents, qui peuvent ressembler à des groupes par département, par lieu, etc.
5. Cliquez sur Enregistrer & Ajouter un autre si vous devez ajouter un autre groupe.
6. Cliquez sur Enregistrer lorsque vous avez ajouté votre dernier groupe.

Accédez aux équipes depuis le panneau d'administration de Lucid

Les groupes que vous créez seront visibles dans le panneau d'administration de Lucid en suivant ces étapes :

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

FAQ

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

Lorsque vous retirez l'accès à un utilisateur via SCIM, ses documents seront transférés à un autre utilisateur de votre compte Entreprise. Le transfert des documents aura lieu 24 heures après la révocation de la licence via SCIM.

Par défaut, le propriétaire du compte sera le destinataire des documents qui sont automatiquement transférés lors de la suppression de la licence 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 accédez à 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. Pour plus d'informations, veuillez consulter  notre article « Paramètres de conformité » dans le panneau d'administration Lucid.

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

Non. La fonctionnalité JIT ne permet pas de mettre à jour, de supprimer ou de désactiver un utilisateur dans Lucid, car elle ne fonctionne que lors de la première connexion de l'utilisateur. Cela signifie que toute mise à jour, suppression ou désactivation devra être effectuée via le panneau d'administration Lucid si vous n'utilisez pas SCIM.

Si vous souhaitez mettre à jour les utilisateurs et permettre l'automatisation de la désactivation des 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