Importez et gérez les données relatives à l'infrastructure Azure dans Lucid Data Hub

Regardez : Importer l'architecture du nuage Azure

Environnements, ressources et lignes Azure pris en charge

Pour obtenir la liste complète des environnements, ressources et gammes Azure pris en charge et disponibles dans Lucid, veuillez consulter notre article « Environnements, ressources et gammes Azure pris en charge ».

Importer l'infrastructure Azure

Vous pouvez importer vos données d'infrastructure en nuage Azure en utilisant l'une des deux méthodes suivantes :

• Accès sécurisé: Cette méthode utilise une seule application d'entreprise (anciennement Azure AD), qui peut être affectée à un (ou plusieurs) groupe(s) de gestion Azure ou à un (ou plusieurs) abonnement(s) Azure individuel(s). Les autorisations d'importation sont accordées par le biais d'un rôle en lecture seule attribué à cette application.
• Téléchargement de fichiers: Cette méthode utilise un script Python fourni par Lucid dans un terminal Azure CLI configuré pour générer un fichier JSON de vos données d'infrastructure à télécharger manuellement.

Consultez le tableau suivant pour obtenir des précisions sur chaque méthode et déterminer celle qui convient le mieux à votre cas d'utilisation.

*Type de ressources 1 (ressources mappées) : Toutes les ressources énumérées dans la section Ressources prises en charge ci-dessus. Type de ressources 2 (ressources non mappées) : Une grande variété de ressources que vous pouvez placer manuellement dans vos documents ou auxquelles vous pouvez accéder via l'inventaire du nuage dans le hub de données.
**Les rafraîchissements automatiques des sources de données sont disponibles pour les utilisateurs et peuvent être programmés de manière récurrente (quotidiennement, hebdomadairement, mensuellement, annuellement) via le hub de données. Les rafraîchissements manuels sont effectués par un simple clic dans le hub de données.

Lucid enregistre les identifiants d'accès fiables afin que vous puissiez actualiser vos données ou lancer de nouvelles importations sans avoir à saisir à nouveau vos informations. Cette capacité de stockage permet à Lucid de procéder à l'actualisation automatique des données. Les informations d'identification peuvent être supprimées via l'onglet "Azure data hub credentials".

Si vous travaillez avec un environnement de très grande envergure, suivez les conseils fournis dans l'article « Optimiser les performances de la visualisation dans le cloud avec Lucidchart » afin de réduire le volume de données que vous importez ou le nombre d'appels API effectués par Lucidchart vers Azure. Une fois chaque importation terminée, vous pouvez lancer une nouvelle importation.

Importation via un accès sécurisé

Cette méthode permet un accès sécurisé et permanent en enregistrant une application d'entreprise avec des autorisations en lecture seule. Avec l'accès sécurisé, Lucid enregistre vos informations d'identification, ce qui vous permet d'effectuer des actualisations de données manuelles et automatiques programmées.

Étape 1 : Créer et enregistrer une application d'entreprise dans Azure

Tout d'abord, vous allez créer et enregistrer l'application dans votre portail Azure. Cette application servira de principal de service que Lucid utilisera pour s'authentifier.

1. Accédez à la page d’accueil de Lucid.
2. Cliquez sur Concentrateur de données en bas du menu de navigation sur le côté gauche de la page.
3. Dans la liste des fournisseurs du hub de données, cliquez sur Azure. 
4. Sélectionnez Importer des données Azure.
5. Sélectionnez Accès de confiance.
   
    
6. Sous le champ d'application de l'accréditation, choisissez "groupe de gestion" ou "abonnement individuel". Si vous avez déjà enregistré un titre, vous serez d'abord dirigé vers la page de sélection des titres.
7. Cliquez sur Enregistrer un nouveau titre en haut de cette page.
8. Après avoir sélectionné l'étendue des informations d'identification, sélectionnez Enregistrer l'application AD, ce qui vous dirigera vers un nouvel onglet contenant la page d'enregistrement de l'application dans Azure (si vous êtes déjà connecté à Azure). Laissez l'onglet du navigateur Lucid ouvert. 
   • Pour les environnements dans Azure Government, sélectionnez le lien directement en dessous.
     
9. Sur la page d'enregistrement dans Azure, ajoutez un nom pour l'application et conservez les paramètres par défaut pour tous les autres champs.
10. Cliquez sur Enregistrer pour terminer l'enregistrement de votre application d'entreprise.
11. Allez sur App registrations dans Microsoft Entra ID et sélectionnez l'application que vous venez d'enregistrer.
12. Sous Propriétés, copiez l'"ID de l'application (client)" en cliquant sur l'icône de copie vers le tableau de bord.
    • De retour dans votre onglet Lucid, collez cette valeur dans le champ "Application (client) ID".
    • Répétez ce processus pour le "Directory (tenant) ID".
      
13. Dans votre onglet Azure, sélectionnez Gérer dans le menu de navigation de gauche.
14. Sélectionnez Certificats & secrets. 
15. Cliquez sur + Nouveau secret client.
16. Fournissez une description, sélectionnez une période d'expiration et cliquez sur Ajouter. 
17. Copiez immédiatement la valeur du nouveau secret, car cette valeur n'est affichée qu'une seule fois. De retour dans votre onglet Lucid, collez cette valeur dans le champ "Valeur secrète du client" de l'étape 3. 

Étape 2 : Attribuer un rôle à l'application d'entreprise

Après avoir créé l'application, vous devez lui accorder des autorisations pour lire les métadonnées de votre environnement Azure. Vous avez deux options : attribuer un rôle intégré en lecture seule (recommandé) ou créer un rôle personnalisé avec les autorisations minimales requises. Ces deux options sont énumérées à l'étape 2 : "Attribuer un rôle à l'application AD". 

Option A : Utiliser un rôle en lecture seule pour toutes les ressources (Recommandé)

Lucid recommande d'utiliser le rôle intégré d'Azure pour l'accès en lecture seule, car les nouvelles ressources Azure sont automatiquement ajoutées et deviennent disponibles pour les importations Lucid. Cette approche accorde à l'application un accès en lecture seule à toutes les ressources dans le cadre spécifié (soit un groupe de gestion, soit un abonnement spécifique).

1. Dans le portail Azure, accédez à l'abonnement ou au groupe de gestion que vous souhaitez importer.
2. Sélectionnez Contrôle d'accès (IAM) dans le menu de navigation.
3. Cliquez sur + Ajouter.
4. Sélectionnez Ajouter une attribution de rôle.
5. Dans l'onglet Rôle , recherchez et sélectionnez le rôle de lecteur intégré.
6. Naviguez jusqu'à l'onglet Membres .
7. Cliquez sur + Sélectionner les membres et recherchez le nom de l'application d'entreprise que vous avez enregistrée précédemment.
8. Sélectionnez l'application.
9. Cliquez sur Enregistrer.
10. Cliquez sur Réviser + créer pour terminer l'attribution des rôles.

Option B : créer et attribuer un rôle personnalisé

Dans cette approche, vous créez un rôle avec les autorisations minimales exactes requises pour une importation.

1. Dans votre onglet Lucid, allez à l'étape 2 et sélectionnez l'option "Rôle personnalisé".
2. Cliquez sur Télécharger le fichier JSON pour enregistrer le fichier des autorisations de la ligne de base des rôles.
3. Dans le portail Azure, accédez à l'abonnement ou au groupe de gestion que vous souhaitez importer.
4. Allez dans Contrôle d'accès (IAM).
5. Sélectionnez + Ajouter > Ajouter un rôle personnalisé.
6. A côté de l'autorisation de la ligne de base.
7. Choisissez Start from JSON et chargez le fichier que vous avez téléchargé depuis Lucid.
8. Donnez au rôle un nom personnalisé descriptif, tel que Lucid Minimum Read Access.
9. Dans l'onglet Étendues assignables, vérifiez que votre abonnement ou groupe de gestion cible est répertorié. Si ce n'est pas le cas, sélectionnez + Ajouter des champs d'application assignables. 
   • Pour les importations au niveau du groupe de gestion, définissez le type sur "Management Group" et sélectionnez chaque groupe que vous souhaitez importer. 
   • Pour les importations d'abonnements individuels, définissez le type sur "Abonnement" et sélectionnez chaque abonnement que vous souhaitez importer. 
10. Cliquez sur Réviser + créer.
11. Sélectionnez Créer pour finaliser le rôle personnalisé.
12. Dans les paramètres de contrôle d'accès (IAM ) de votre abonnement ou groupe de gestion.
13. Cliquez sur + Ajouter.
14. Sélectionnez Ajouter une attribution de rôle.
    • Pour le rôle, recherchez et sélectionnez le rôle personnalisé que vous venez de créer.
    • Pour Attribuer l'accès à, laissez la valeur par défaut(Utilisateur, groupe ou responsable de service).
    • Pour Select, recherchez et choisissez l'application d'entreprise que vous avez enregistrée.
    • Cliquez sur Enregistrer pour appliquer l'attribution de rôle.

Étape 3 : Ajouter des informations d'identification et importer des abonnements dans le hub de données

Enfin, vous fournirez les identifiants de l'application à Lucid pour valider la connexion.

1. Retournez à l'onglet Lucide que vous aviez laissé ouvert.
   • Si votre application a été créée dans Azure Government, mettez à jour le "Type d'application AD" en "Application Azure Government". 
2. Saisissez un nom d'affichage pour l'identifiant afin de pouvoir l'identifier ultérieurement. Ce nom sera inscrit dans le champ "Nom d'affichage de l'application AD".
3. Cliquez sur Suivant.
4. Cochez les cases correspondant aux abonnements que vous souhaitez importer.
5. Cliquez sur Suivant.
   
6. Sélectionnez les types de ressources que vous souhaitez importer.
   • Lors de l'importation d'abonnements dans Lucid Data Hub, vous avez la possibilité d'exclure certains types de ressources ou certaines métadonnées de l'importation. Cela vous permet de n'afficher que les types de ressources qui vous intéressent et, dans certains cas, peut accélérer l'importation. Les types de ressources et les métadonnées désélectionnés ne seront ni importés ni affichés dans un diagramme. 
   • Pour les abonnements comportant un grand nombre de ressources, voir Optimiser les performances dans Lucidscale pour améliorer votre expérience du produit.
   • Pour les références ayant plus d'un abonnement, la configuration des métadonnées et des types de ressources omises s'appliquera à tous les abonnements énumérés dans la section "Résumé de l'importation".
7. (Facultatif) Personnalisez le nom de chaque abonnement Azure. En outre, vous pouvez ajouter un préfixe à tous les abonnements répertoriés.
   
8. Cliquez sur Importer des abonnements Azure.

Téléchargement de fichier

Pour importer l'infrastructure Azure via le téléchargement d'un fichier JSON, procédez comme suit :

1. Sur la page d'accueil de Lucid, cliquez sur Data hub dans le menu de navigation de gauche.
2. Sélectionnez Importer des données Azure.
3. Choisissez File upload.
4. Sélectionnez Global Azure Application ou Azure Government Application en fonction de l'emplacement de votre instance Azure. Laissez cet onglet ouvert afin de pouvoir y revenir plus tard.
5. Cliquez sur Télécharger les exigences.txt et Télécharger le script. 
6. Configurez votre CLI Azure à l'aide du fichier requirements.txt et des instructions figurant au début du fichier azurecliscript.py.
   • Pour plus d'instructions de configuration, voir la section Description du script de téléchargement de fichiers Azure ci-dessous.
7. Exécutez le script Python dans votre CLI Azure. Un fichier azure.json sera généré. 
8. Dans l'onglet « Lucid Data Hub », sélectionnez « Choisir un fichier » et téléchargez le fichier azure.json. 
9. Cliquez sur Suivant.
10. Indiquez un nom d'alias pour chaque abonnement que vous souhaitez importer.
11. Sélectionnez Importer des abonnements Azure.

Description du script Azure File Upload 

Le script d'importation fourni par Lucid, azurecliscript.py, s'appuie sur Azure CLI et Azure SDK for Python pour collecter la configuration de vos ressources Azure. Il nécessite une authentification correcte et une sélection d'abonnement spécifique.

Le script utilise AzureCliCredential pour l'authentification, en s'appuyant sur votre session active Azure CLI établie avec az login. Vos identifiants de connexion vous permettent d'accéder à votre locataire Microsoft Entra ID (Active Directory).

• Si vous récupérez des données à partir d'Azure Government Cloud, définissez d'abord l'environnement cloud : az cloud set --name AzureUSGovernment.
• Sinon, pour Global Azure, assurez-vous que l'environnement cloud est défini sur AzureCloud: az cloud set --name AzureCloud.

Pour une documentation détaillée sur la gestion des abonnements Azure et l'authentification avec l'interface de commande Azure, reportez-vous à la documentation d'Azure sur la gestion des abonnements Azure avec l'interface de commande Azure et la connexion avec l'interface de commande Azure.

Exigences :

• Python : Versions 3.0-3.9. Assurez-vous que "Add Python to PATH" est sélectionné lors de l'installation.
• Azure CLI : installé et configuré.
• Paquets Azure SDK : Le script nécessite des paquets Azure SDK spécifiques (par exemple, azure.mgmt.compute, azure.mgmt.network, etc.) Ils sont installés en exécutant pip3 install -r requirements.txt après avoir téléchargé requirements.txt depuis le hub de données.

Paramètres :

• -s, --subscriptions [OBLIGATOIRE] 
  • Spécifie un ou plusieurs identifiants de souscription Azure à partir desquels importer des ressources. Cette option peut être répétée pour importer à partir de plusieurs abonnements dans votre session Azure CLI authentifiée.
• -o, --output
  • Spécifie le nom de fichier pour la sortie JSON générée. Si vous ne le spécifiez pas, le fichier par défaut azure.json sera utilisé.
• -c, --count
  • Produit un fichier JSON nommé count.json contenant le nombre de ressources. Lorsque cet indicateur est utilisé, le fichier JSON généré n'est pas adapté aux importations Lucid.

Exemple :

La commande ci-dessus exécute le script et génère un fichier JSON nommé my_azure_data.json pour les ressources résidant dans les abonnements Azure spécifiés.

Utilisez le hub de données pour gérer les données et les identifiants de l'infrastructure Azure.

Abonnements importés

Après avoir importé des données d'abonnement Azure, elles seront répertoriées en tant que source de données avec le nom de l'abonnement que vous avez spécifié dans la section "Azure : Abonnements importés" du hub de données. Dans cette section, vous pouvez également cliquer sur + New Subscription (Nouvel abonnement) pour importer un nouvel abonnement dans lehub de données.

Les abonnements répertoriés dans cette section constituent des sources de données pouvant être utilisées pour créer de nouveaux documents Lucidchart. Les sources de données (« Abonnements ») contiennent les métadonnées des abonnements Azure utilisées pour créer des documents Lucidchart. Le champ « Dernière mise à jour » indique la date à laquelle votre source de données a été actualisée pour la dernière fois afin de prendre en compte les éventuelles mises à jour apportées à votre abonnement Azure connecté.

L'inventaire du nuage de chaque abonnement peut être consulté sur le côté droit après avoir sélectionné un abonnement dans la liste. Cet inventaire vous permet de connaître le nombre total de chaque type de ressource importée avant de créer un document. Vous pouvez également télécharger un fichier CSV pour les importations accréditées, ce fichier contient une liste de ressources et de comptages directement à partir du centre de données en cliquant sur Télécharger CSV.

L'inventaire répertorie toutes les ressources auxquelles les autorisations de rôle attribuées à votre application AD permettent d'accéder. Si vous choisissez d'"Utiliser un rôle de lecture seule pour toutes les ressources", toutes les ressources de votre abonnement qui sont accessibles par le rôle "Lecteur" d'Azure seront affichées dans l'inventaire. Si vous créez un rôle personnalisé, seuls les types de ressources spécifiés dans les autorisations qui vous sont attribuées seront affichés dans l'inventaire.

Cliquez sur le menu à trois points rendu sur un abonnement pour accéder aux options potentielles suivantes :

• Créer un nouveau document lance le rendu de l'infrastructure Azure associée à l'abonnement sous la forme d'un diagramme dans l'espace de travail d'un nouveau document. Un document sera généré en arrière-plan de votre page d'accueil Lucid et nous vous informerons une fois qu'il aura été rendu par le biais de la fenêtre modale d'état qui s'affiche en bas à droite de la page.
• Les fonctionnalités « Mettre à jour l'abonnement depuis Azure » et « Planifier la mise à jour » vous permettent de mettre à jour, manuellement ou automatiquement, les données de l'abonnement Azure que vous avez importées dans le Data Hub afin de refléter toute modification apportée à l'abonnement Azure connecté. Les nouveaux documents créés à partir de cet abonnement après la mise à jour refléteront toute modification apportée à l'abonnement Azure connecté.

• Modifier les ressources vous permet de modifier les ressources incluses dans chaque ensemble de données. En sélectionnant cette option, vous ouvrirez une fenêtre modale dans laquelle vous pourrez ajouter ou supprimer des ressources de vos ensembles de données existants. Lorsque vous avez terminé votre sélection, cliquez sur Enregistrer et mettre à jour l'abonnement. L'ensemble de données sera ainsi actualisé et les documents faisant référence à cet ensemble de données seront mis à jour avec les informations les plus récentes.
  
• Renommer l'abonnement vous permet de modifier le nom de l'ensemble de données sélectionné.
• La fonction « Supprimer l'abonnement» supprime l'abonnement importé du Lucid Data Hub. Tous les documents créés à partir de cet abonnement ne pourront plus être mis à jour à partir d'Azure. Vous pouvez importer le même abonnement Azure plusieurs fois : chaque importation crée une source de données indépendante. Il n'est pas nécessaire de supprimer un abonnement existant avant de le réimporter.

Identifiants enregistrés

La page « Identifiants enregistrés » du hub de données regroupe toutes les applications AD que vous pouvez utiliser pour importer des abonnements Azure dans le hub de données. Sur cette page, cliquez sur « + Nouvelle application AD » pour ajouter un nouvel ensemble d'identifiants pouvant servir à importer un abonnement Azure.  

Pour partager les applications AD que vous avez créées avec d'autres utilisateurs, cliquez sur le menu à trois points rendu sur une application AD. 

À partir de là, deux possibilités s'offrent à vous : 

• La fonction « Partager les informations d'identification » ouvre une fenêtre modale qui vous permet de partager une application AD que vous avez créée avec un autre utilisateur de votre compte Lucid, en indiquant son adresse e-mail. En lui accordant l'accès à l'application AD, vous lui permettez d'importer le ou les abonnements Azure associés dans le hub de données et de créer des documents Lucidchart. Une fois les identifiants partagés avec un autre utilisateur, vous pouvez révoquer son accès à ces identifiants en cliquant sur le « X » situé à côté de son adresse e-mail dans la même fenêtre modale.
• La suppression d'un identifiant entraîne le retrait de votre application AD du hub de données. Une fois l'identifiant supprimé, tous les abonnements précédemment importés à l'aide de cet identifiant, ainsi que les documents créés à partir de ces abonnements, ne pourront plus mettre à jour les données depuis Azure.  

Informations de sécurité

Application Azure AD

L'application Entra ID (anciennement Azure AD) est la méthode préférée d'Azure pour gérer les identités numériques pour les applications externes et sur site. 

Cette méthode permet à Lucid de stocker en toute sécurité les identifiants qui vous permettent d'importer et d'actualiser facilement votre diagramme. 

Consultez ces ressources pour plus d'informations :

• Qu'est-ce que la gestion des applications ? 
• Démarrage rapide : Enregistrer des applications avec la plate-forme d'identité Microsoft

Accès sécurisé et limité 

Lucid demande une autorisation d'accès limitée et en lecture seule pour l'application Azure AD que vous créez. Ces autorisations sont définies au sein du rôle personnalisé que vous associez à votre application. Un rôle personnalisé créé avec ces autorisations ne peut ni modifier les paramètres de votre architecture Azure, ni lire les données de vos bases de données. Lucid utilise uniquement l’application AD pour lire les métadonnées structurelles de votre infrastructure Azure. Lucid n’effectue de lecture qu’à partir des abonnements auxquels vous nous accordez l’accès ; vous pouvez contrôler cela en limitant la portée du rôle personnalisé associé à l’application AD attribuée à Lucid. 

Alternative au script d'interface de ligne de commande

Pour examiner et contrôler les actions effectuées par Lucid lors de notre analyse de l'infrastructure Azure, vous pouvez télécharger et utiliser le script Python que nous mettons à votre disposition, plutôt que de créer une application Azure AD. Dans ce cas de figure, vos identifiants ne seront jamais transmis à Lucid, et vous pourrez examiner à la fois le code qui s'exécutera dans votre environnement et les métadonnées générées avant de les télécharger vers Lucid. Votre fichier JSON importé sera accessible dans le Lucid Data Hub et pourra être utilisé pour créer des documentsLucidchart.

Stockage sécurisé des documents (documents)

Lucid stocke les métadonnées importées depuis Azure ainsi que les documents générés en appliquant les mesures de protection conformes aux normes du secteur en matière de données confidentielles. Les données importées depuis Azure sont intégrées au documentLucidchart; vous pouvez ainsi contrôler l'accès à ces données à l'aide des autorisations de partage standard de Lucid. Pour plus d'informations sur la manière dont Lucid protège vos documents, veuillez consulter notre page « Sécurité du contenu» ou contacter notre équipe commerciale.

FAQ

Comment Lucid accède-t-il à notre environnement Azure ? De quel niveau d'accès dispose Lucid ?

La méthode recommandée par Lucid et Azure consiste à passer par une application Azure AD. Nous mettons en place une politique qui nous accorde un accès de type « décrire et répertorier » à votre environnement afin que nous puissions dresser un inventaire des ressources.

Nous proposons également une méthode utilisant un script Python que vous pouvez exécuter via l'interface de ligne de commande (CLI) et qui génère un fichier JSON. Les utilisateurs peuvent ensuite importer ce fichier JSON dans Lucid sans avoir à saisir d'informations d'identification dans Lucid.

À quelles API Lucid a-t-il accès ?

Nous utilisons principalement les points d'extrémité de l'API "décrire" et "lister".

Puis-je choisir les métadonnées (les champs et les valeurs affichés dans le panneau Données) qui seront importées ? Si ce n'est pas le cas, quelles sont les métadonnées importées ?

Non, vous ne pouvez pas actuellement choisir les métadonnées qui seront importées. Toutefois, nous envisageons de créer une possibilité de le faire à l'avenir. Toutes les métadonnées d'un appel API de description sont importées.

Donnez votre avis sur cet article