Importer et gérer des données d’infrastructure Azure dans Lucidscale

Regardez : Importer l'architecture du nuage Azure

Environnements, ressources et lignes Azure pris en charge

Pour obtenir une liste complète des environnements, ressources et lignes Azure pris en charge et disponibles dans Lucidscale, reportez-vous à notre article sur les environnements, ressources et lignes 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 très vaste, utilisez les informations de l'article Optimiser les performances de Lucidscale pour réduire la quantité de données importées ou le nombre d'appels d'API que Lucid envoie à 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.
   • Lorsque vous importez des abonnements vers le hub de données Lucid, vous avez la possibilité d'omettre certains types de ressources ou de métadonnées de l'importation. Cela vous permet de ne visualiser que les types de ressources qui vous intéressent et, dans certains cas, d'accélérer l'importation. Les types de ressources et les métadonnées désélectionnés ne seront pas importés ou visualisé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.
   1. 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 Choose file 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 listés dans cette section sont des sources de données qui peuvent être utilisées pour créer de nouveaux documents Lucidscale. Les sources de données ("Abonnements") contiennent les métadonnées d'abonnement Azure utilisées pour créer les documents Lucidscale. Le champ "Dernière mise à jour" indique quand votre source de données a été actualisée pour la dernière fois afin de prendre en compte les éventuelles mises à jour de 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 options Mettre à jour l'abonnement à partir d'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 hub de données afin de refléter toute modification apportée à l'abonnement Azure connecté. Les nouveaux documents créés à partir de l'abonnement après la mise à jour refléteront les modifications apportées à 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é.
• Supprimer l' abonnement supprime l'abonnement importé du hub de données Lucid. Tous les documents créés à partir de cet abonnement ne pourront plus être mis à jour à partir des données 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 pageSaved Credentials dans le hub de données est l'endroit où vous pouvez trouver toutes les applications AD que vous pouvez utiliser pour importer des abonnements Azure dans le hub de données. Sur cette page, cliquez sur+ New AD application (Nouvelle application AD) pour ajouter un nouvel ensemble d'informations d'identification qui peuvent être utilisées pour 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 : 

• Share credential 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 spécifiant son adresse e-mail. En lui donnant accès à l'application AD, vous lui permettez d'importer le(s) abonnement(s) Azure associé(s) dans le hub de données et de créer des documents Lucidscale. Une fois qu'un identifiant a été partagé avec un autre utilisateur, vous pouvez révoquer son accès à l'identifiant en cliquant sur leX à côté de son adresse e-mail dans la même fenêtre.
• Supprimer l'identifiant supprime votre application AD du hub de données. Après la suppression d'un identifiant, tous les abonnements précédemment importés avec cet identifiant, ainsi que les documents créés à partir de ces abonnements, perdent la possibilité de mettre à jour les données à partir d'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 à Lucidscale de stocker en toute sécurité les informations d'identification 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 un accès limité, en lecture seule, à l'application Azure AD que vous créez. Les autorisations sont définies dans le rôle personnalisé que vous associez à votre application. Un rôle personnalisé créé avec ces autorisations ne peut pas modifier les paramètres de votre architecture Azure ni lire les données de vos bases de données. Lucid n'utilise l'application AD que pour lire les métadonnées structurelles de votre infrastructure Azure. Lucid ne lit que les abonnements auxquels vous lui donnez accès ; vous pouvez contrôler cela en limitant la portée du rôle personnalisé attaché à l'application AD attribuée à Lucidscale. 

Alternative au script d'interface de ligne de commande

Pour examiner et contrôler les actions entreprises par Lucid lors de l'analyse de l'infrastructure Azure, vous pouvez télécharger et utiliser le script Python que nous vous fournissons au lieu de créer une application Azure AD. Dans ce scénario, vos informations d'identification ne seront jamais transmises à Lucidscale, et vous pouvez vérifier le code qui s'exécutera dans votre environnement et les métadonnées qui en résulteront avant de les télécharger sur Lucidscale. Votre JSON importé sera accessible dans le hub de données Lucid et pourra être utilisé pour créer des documents Lucidscale.

Stockage sécurisé des documents (documents)

Lucidscale stocke les métadonnées importées d'Azure et les documents générés en utilisant les protections standard de l'industrie pour les données confidentielles. Les données Azure importées sont intégrées au document Lucidscale, ce qui vous permet de contrôler l'accès aux données à l'aide des autorisations de partage standard de Lucid. Pour plus d'informations sur la façon dont Lucid protège vos documents, consultez notre page Sécurité du contenu ou contactez notre équipe commerciale.

FAQ

Comment Lucidscale accède-t-il à notre environnement Azure ? Quel est le niveau d'accès à Lucidscale ?

La méthode recommandée par Lucidscale et Azure est l'utilisation d'une application Azure AD. Nous proposons une politique qui nous donne un accès "description et liste" à votre environnement afin que nous puissions dresser un inventaire des ressources.

Nous disposons également d'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 alors télécharger ce fichier JSON vers Lucidscale et ne pas saisir d'informations d'identification dans Lucidscale.

Quelles sont les API auxquelles Lucidscale a 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