Importeer en beheer Microsoft Azure infrastructuurgegevens in de Lucid Data Hub

Bekijk: Microsoft Azure cloudarchitectuur importeren

Ondersteunde Azure-omgevingen, -resources en -lijnen

Voor een uitgebreide lijst van de ondersteunde omgevingen, bronnen en lijnen uit Microsoft Azure die beschikbaar zijn in Lucid, raadpleeg ons artikel Supported Microsoft Azure environments, resources en lijnen .

Azure-infrastructuur importeren

Je kunt jouw Azure cloud infrastructuur gegevens importeren met een van de volgende twee methoden:

• Vertrouwde toegang: Deze methode maakt gebruik van één Enterprise applicatie (voorheen Azure AD), die kan worden toegewezen aan één (of meer) Azure beheergroepen of aan één (of meer) individuele Azure abonnementen. Import Toestemmingen worden toegekend via een alleen-lezen rol die is toegewezen aan deze applicatie.
• Bestand uploaden: Deze methode gebruikt een door Lucid geleverd Python script in een geconfigureerde Azure CLI terminal om een JSON bestand van jouw infrastructuur gegevens te genereren voor handmatige upload.

Bekijk de volgende tabel voor specifieke informatie over elke methode en om te bepalen welke het beste is voor jouw toepassing.

*Resource type 1 (toegewezen resources): Alle resources die hierboven in de sectie Ondersteunde bron zijn vermeld. Resource type 2 (niet-toegewezen resources): Een breed scala aan resources die je handmatig in jouw document kunt plaatsen of via cloud Inventory in de datahub kunt gebruiken.
**Automatische gegevensbronverversingen zijn beschikbaar voor Gebruiker om in te stellen op een terugkerend schema (dagelijks, wekelijks, maandelijks, jaarlijks) via de datahub. Handmatige verversingen worden uitgevoerd met één klik in de datahub.

Lucid slaat vertrouwde toegangsgegevens op zodat ik jouw gegevens kan verversen of nieuwe importen kan starten zonder jouw gegevens opnieuw in te voeren. Deze opslagmogelijkheid stelt Lucid in staat om automatisch gegevensvernieuwing uit te voeren. Inloggegevens kunnen worden verwijderd via het tabblad Azure Data Hub-inloggegevens.

Als je met een zeer grote omgeving werkt, gebruik dan de informatie in de Optimaliseer cloud visualisatieprestaties in Lucidchart artikel om de hoeveelheid data die je importeert te verminderen, of het aantal API-aanroepen dat Lucid naar Microsoft Azuredoet te verminderen. Na elke import kun je een nieuwe import starten.

Importeren via vertrouwde toegang

Deze methode biedt veilige, doorlopende toegang door een Enterprise applicatie te registreren met alleen-lezen Toestemmingen. Met vertrouwde toegang slaat Lucid jouw gegevens op, zodat je zowel handmatig als automatisch gegevensvernieuwing kunt uitvoeren.

Stap 1: Maak en registreer een bedrijfsapplicatie in Azure

Eerst maak je de applicatie aan en registreer je deze binnen jouw Azure portal. Deze applicatie zal fungeren als de service principal die Lucid gebruikt om te authenticeren.

1. Ga naar de Lucid startpagina.
2. Klik op Datahub onder aan het navigatiemenu aan de linkerkant van de pagina.
3. Klik in de lijst met providers in de gegevenshub op Azure. 
4. Selecteer Azure-gegevens importeren.
5. Selecteer Vertrouwde toegang.
   
    
6. Kies onder credential scope "beheergroep" of "individueel abonnement". Als je al eerder een referentie hebt geregistreerd, word je eerst doorgestuurd naar de selectiepagina voor de referentie.
7. Klik op Registreer een nieuwe referentie boven aan deze pagina.
8. Nadat je de credential scope hebt geselecteerd, selecteer je Register AD application. Dit leidt je naar een nieuw tabblad met de applicatie registratiepagina in Azure (als je al bent aangemeld bij Azure). Laat het tabblad van de Lucid browser open. 
   • Voor omgevingen in Azure Government selecteert u in plaats daarvan de koppeling direct eronder.
     
9. Voeg op de registratiepagina in Azure een naam toe voor de applicatie en behoud de standaardinstellingen voor alle overige velden.
10. Klik op Registreren om de registratie van jouw Enterprise applicatie te voltooien.
11. Ga naar App-registraties in Microsoft Entra ID en selecteer de applicatie die je zojuist hebt geregistreerd.
12. Kopieer onder Eigenschappen de "applicatie (client) ID" door op het kopieer-naar-klembord pictogram te klikken.
    • Plak deze waarde terug in jouw Lucid tabblad in het veld "applicatie (client) ID".
    • Herhaal dit proces voor de "Directory (tenant) ID".
      
13. Selecteer in jouw Azure tabblad Beheer in het linker navigatiemenu.
14. Selecteer Certificaten en geheimen. 
15. Klik op + Nieuw clientgeheim.
16. Geef een beschrijving op, selecteer een verloopperiode en klik op Toevoegen. 
17. Kopieer de waarde van het nieuwe geheim onmiddellijk, aangezien deze waarde slechts één keer wordt weergegeven. Plak deze waarde terug in jouw Lucid tabblad in het veld "Client secret value" van stap 3. 

Stap 2: Wijs een rol toe aan de bedrijfsapplicatie

Nadat je de applicatie hebt gemaakt, moet je deze Toestemmingen geven om de metadata van jouw Azure omgeving te lezen. Je hebt twee opties: een ingebouwde, alleen-lezen rol toewijzen (aanbevolen) of een aangepaste rol maken met minimaal vereiste Toestemmingen. Deze twee opties staan onder Stap 2: "Een rol toewijzen aan de AD applicatie". 

Optie A: Een alleen-lezen rol gebruiken voor alle resources (aanbevolen)

Lucid raadt aan om de ingebouwde rol van Azure te gebruiken voor alleen-lezen toegang, omdat nieuwe Azure-resources automatisch worden toegevoegd en beschikbaar komen voor Lucid-imports. Deze benadering geeft de applicatie alleen-lezen toegang tot alle bronnen binnen het gespecificeerde bereik (een beheergroep of een specifiek abonnement).

1. Navigeer in de Azure portal naar het abonnement of de Management Group die je wilt importeren.
2. Selecteer Toegangsbeheer (IAM) in het navigatiemenu.
3. Klik op + Toevoegen.
4. Kies Roltoewijzing toevoegen.
5. Zoek en selecteer op het tabblad Rol de ingebouwde Reader rol.
6. Navigeer naar het tabblad Leden .
7. Klik op + Selecteer leden en zoek naar de naam van de Enterprise applicatie die je eerder hebt geregistreerd.
8. Selecteer de applicatie.
9. Klik op Opslaan.
10. Klik op Controleren + maken om de roltoewijzing te voltooien.

Optie B: Een aangepaste rol maken en toewijzen

Bij deze aanpak maak je een rol aan met precies de minimale Toestemmingen die nodig zijn voor een import.

1. Ga in jouw Lucid tabblad naar stap 2 en selecteer de optie "Aangepaste rol".
2. Klik op Download JSON-bestand om het bestand met de rol baseline Toestemmingen op te slaan.
3. Navigeer in de Azure portal naar het abonnement of de Management Group die je wilt importeren.
4. Ga naar Toegangsbeheer (IAM).
5. Selecteer + Toevoegen > Aangepaste rol toevoegen.
6. Naast Baseline Toestemmingen.
7. Kies Start vanuit JSON en upload het bestand dat je hebt gedownload van Lucid.
8. Geef de rol een beschrijvende aangepaste rolnaam, zoals Lucid Minimum Read Access.
9. Controleer in het tabblad Toewijsbare scopes of jouw doelabonnement of Beheergroep wordt weergegeven. Als dit niet het geval is, selecteert u + Toewijsbare bereiken toevoegen. 
   • Voor imports van Managementgroepen, stel het type in op "Management Group" en selecteer elke groep die je wilt importeren. 
   • Voor individuele abonnementsniveau-importen, stel het type in op "abonnement" en selecteer elk abonnement dat je wilt importeren. 
10. Klik op Controleren + maken.
11. Selecteer Maken om de aangepaste rol te voltooien.
12. In de instellingen voor Toegangsbeheer (IAM) van jouw abonnement of Beheergroep.
13. Klik op + Toevoegen.
14. Selecteer Roltoewijzing toevoegen.
    • Zoek en selecteer voor de rol de aangepaste rol die je zojuist hebt gemaakt.
    • Laat bij Toegang toewijzen aan de standaardwaarde(Gebruiker, groep of service principal) staan.
    • Zoek en kies bij Select de Enterprise applicatie die je hebt geregistreerd.
    • Klik op Opslaan om de roltoewijzing toe te passen.

Stap 3: Voeg inloggegevens toe en importeer abonnementen naar de datahub

Tot slot geef je de applicatiegegevens aan Lucid om de verbinding te valideren.

1. Ga terug naar het tabblad Lucid dat je eerder open hebt gelaten.
   • Als jouw applicatie is gemaakt in Azure Government, werk dan het "AD applicatie Type" bij naar "Azure Government applicatie". 
2. Voer een weergavenaam in voor de credential zodat je deze later kunt identificeren. Dit komt in het veld "AD applicatie display name".
3. Klik op Volgende.
4. Controleer het vak voor het abonnement dat je wilt importeren.
5. Klik op Volgende.
   
6. Selecteer de types bronnen die je wilt importeren.
   • Bij het importeren van een abonnement naar de Lucid Data Hub heb je de optie om geselecteerde resourcetypes of metadata uit de import weg te laten. Dit geeft je de mogelijkheid om alleen de grondstoftypes te visualiseren waarin je geïnteresseerd bent en kan in sommige gevallen de snelheid van de import verhogen. Geselecteerde resourcetypes en metadata worden niet geïmporteerd of weergegeven in een diagram. 
   • Voor een abonnement met een groot aantal bronnen, zie Prestaties optimaliseren in Lucidscale om jouw productervaring te verbeteren.
   • Voor referenties met meer dan 1 abonnement geldt de configuratie voor metadata en brontypes die worden weggelaten voor alle abonnementen die worden vermeld in het gedeelte "Overzicht importeren".
7. (Optioneel) Pas de naam van elk Azure abonnement aan. Daarnaast kun je een prefixtekst toevoegen aan alle vermelde abonnementen.
   
8. Klik op Import Azure abonnement.

Bestand uploaden

Volg deze stappen om Azure infrastructuur te importeren via een JSON bestandsupload:

1. Klik op de Lucid startpagina op Data hub in het linker navigatiemenu.
2. Selecteer Azure-gegevens importeren.
3. Kies Bestand uploaden.
4. Selecteer Global Azure applicatie of Azure Government applicatie, afhankelijk van waar jouw Azure instance zich bevindt. Laat dit tabblad open zodat je er later naar terug kunt keren.
5. Klik op requirements.txt downloaden en script downloaden. 
6. Configureer jouw Azure CLI met behulp van het bestand requirements.txt en de instructies aan het begin van het bestand azurecliscript.py.
   • Zie de sectie Beschrijving van het Azure File Upload-script hieronder voor meer configuratie-instructies.
7. Voer het Python script uit in jouw Azure CLI. Er wordt een azure.json bestand gegenereerd. 
8. Selecteer in het tabblad Lucid Data Hub 'Bestand kiezen' en upload het Microsoft Azure.json bestand. 
9. Klik op Volgende.
10. Geef een aliasnaam op voor elk abonnement dat je wilt importeren.
11. Selecteer Azure abonnement importeren.

Beschrijving van het Azure File Upload-script 

Het door Lucid geleverde importscript, azurecliscript.py, maakt gebruik van de Azure CLI en Azure SDK voor Python om jouw Azure resource configuration te verzamelen. Het vereist een juiste authenticatie en specifieke abonnementskeuze.

Het script gebruikt AzureCliCredential voor verificatie en vertrouwt op jouw actieve Azure CLI sessie die is gemaakt met az login. Jouw gegevens van az login geven toegang tot jouw Microsoft Entra ID (Active Directory) tenant.

• Als je gegevens ophaalt van Azure Government cloud, stel dan eerst de cloud omgeving in: az cloud set --name AzureUSGovernment.
• Zorg er anders voor dat voor Global Azure de cloud omgeving is ingesteld op AzureCloud: az cloud set --name AzureCloud.

Raadpleeg voor gedetailleerde documentatie over het beheren van Azure abonnement en authenticatie met de Azure CLI de documentatie over Azure abonnement beheren met de Azure CLI en Aanmelden met Azure CLI.

Eisen:

• Python: Versies 3.0-3.9. Zorg ervoor dat "Add Python to PATH" is geselecteerd tijdens de installatie.
• Azure CLI: Geïnstalleerd en geconfigureerd.
• Azure SDK-pakketten: Voor het script zijn specifieke Azure SDK-pakketten vereist (bijvoorbeeld azure.mgmt.compute, azure.mgmt.network, enz.). Deze worden geïnstalleerd door pip3 install -r uit te voeren requirements.txt na het downloaden van requirements.txt van de datahub.

Parameters:

• -s, abonnement [VERPLICHT]. 
  • Geeft een of meer Azure abonnement-ID's op waarvan bronnen moeten worden geïmporteerd. Deze optie kan herhaald worden om te importeren vanuit meerdere abonnementen binnen jouw geauthenticeerde Azure CLI sessie.
• -o, --uitgang
  • Hiermee geeft u de bestandsnaam op voor de gegenereerde uitvoer-JSON. Als dit niet is opgegeven, wordt de standaard bestandsnaam azure.json gebruikt.
• -c, --aantal
  • Hiermee wordt een JSON-bestand met de naam count.json met een telling van resources uitgevoerd. Wanneer deze vlag wordt gebruikt, is het gegenereerde JSON-bestand niet geschikt voor Lucid-imports.

Voorbeeld:

De bovenstaande opdracht voert het script uit en genereert een JSON-bestand met de naam my_azure_data.json voor bronnen die zich in het opgegeven Azure abonnement bevinden.

Gebruik de data hub om Azure-infrastructuurgegevens en inloggegevens te beheren

Geïmporteerde abonnementen

Na het importeren van Azure-abonnementgegevens wordt deze weergegeven als een databron met de abonnementsnaam je gespecificeerd in de sectie "Azure: Imported abonnement" van de datahub. Vanuit deze sectie kun je ook klikken op + Nieuw abonnement om een nieuw abonnement te importeren naar de data-hub.

Abonnementen die in deze sectie worden vermeld, zijn databronnen die gebruikt kunnen worden om nieuwe Lucidchart documenten te maken. Gegevensbronnen ("abonnement") bevatten de Microsoft Azure abonnementsmetadata die wordt gebruikt om Lucidchart document te maken. Het veld "Laatst bijgewerkt" geeft aan wanneer jouw gegevensbron voor het laatst is ververst om rekening te houden met eventuele updates in jouw connected Microsoft Azure abonnement.

De cloud Inventory van elk abonnement is aan de rechterkant te zien nadat een abonnement uit de lijst is geselecteerd. Deze inventaris stelt je in staat om een volledige telling te zien van elk type resource dat is geïmporteerd voordat je een document maakt. je kan ook een CSV downloaden voor gecredentialeerde imports; dit bestand bevat een lijst met bronnen en tellen direct vanuit de datahub door te klikken op Download CSV.

De inventaris bevat alle resources die toegankelijk zijn via de rolmachtigingen die zijn toegewezen aan uw AD-toepassing. Als je kiest voor "Gebruik een alleen-lezen rol voor alle bronnen", dan worden alle bronnen in je abonnement die toegankelijk zijn met Microsoft Azure's "Reader" rol weergegeven in de inventaris. Als u een aangepaste rol maakt, worden alleen de resourcetypen die zijn opgegeven in de machtigingen voor uw toegewezen rollen weergegeven in de inventaris.

Klik op het menu met drie stippen dat op een abonnement wordt weergegeven om toegang te krijgen tot de volgende mogelijke opties: 

• Nieuwe document begint met het renderen van de Azure-infrastructuur die bij het abonnement hoort als een diagram in de werkruimte van een nieuw document. Een document wordt gegenereerd op de achtergrond van jouw Lucid startpagina en we zullen je informeren zodra deze is weergegeven via de statusmodal die rechtsonder op de pagina verschijnt.
• Abonnement updaten vanaf Microsoft Azure en Schedule update stellen me in staat om handmatig of automatisch de Microsoft Azure abonnementsgegevens die ik in de datahub heb geïmporteerd bij te werken om wijzigingen in het verbonden Microsoft Azure abonnement weer te geven. Een nieuw document dat na de update uit het abonnement wordt gemaakt, weerspiegelt eventuele wijzigingen in het verbonden Microsoft Azure abonnement. 

• Bewerken Resources stelt JE in staat om de bronnen in elke dataset te bewerken. Door deze optie te selecteren opent je een modal waarin je alle bronnen uit bestaande datasets van jouw data kan toevoegen of verwijderen. Als je klaar bent met de selectie, klik dan op Sla op en werk het abonnement bij. Dit zorgt ervoor dat de dataset ververst en documenten die naar die dataset verwijzen worden bijgewerkt met de nieuwste informatie.
  
• Rename Subscription stelt u in staat de naam van de geselecteerde dataset te wijzigen.
• Verwijder abonnement verwijdert het geïmporteerde abonnement uit de Lucid Data Hub. Elk document dat uit dat abonnement wordt gemaakt, verliest de mogelijkheid om gegevens van Microsoft Azurebij te werken. JE kan hetzelfde Microsoft Azure abonnement meer dan eens importeren — elk apparaat creëert een onafhankelijke databron. Het verwijderen van een bestaand abonnement is niet nodig voordat je het opnieuw importeert.

Opgeslagen verificatiegegevens

De paginaOpgeslagen inloggegevens in de datahub is waar ik alle AD-applicaties kan vinden die ik kan gebruiken om Microsoft Azure abonnement naar de datahub te importeren. Klik vanaf deze pagina op + Nieuwe AD-applicatie om een nieuwe set inloggegevens toe te voegen die gebruikt kunnen worden om een Microsoft Azure abonnement te importeren.  

Om de AD-applicaties die u hebt gemaakt met andere gebruikers te delen, klikt u op het menu met drie stippen dat wordt weergegeven op een AD-applicatie. 

Vanaf hier heb je twee mogelijke opties: 

• Delen credential opent een modal waarmee je een AD-applicatie kan delen die je hebt aangemaakt met een andere gebruiker op jouw Lucid-account door hun e-mailadres op te geven. Door hen toegang te geven tot de AD-applicatie kunnen ze de bijbehorende Microsoft Azure abonnement(en) importeren naar de datahub en Lucidchart document aanmaken. Nadat een inloggegevens zijn gedeeld met een andere Gebruiker, kan je hun toegang tot het inlogement intrekken door op het X naast hun e-mailadres in dezelfde moduste klikken.
• Verwijder de credential verwijdert jouw AD-applicatie van de datahub. Na het verwijderen van een inloggegevens verliezen alle abonnementen die eerder met dat inloggegevens zijn geïmporteerd, samen met documenten die van die abonnementen zijn gemaakt, de mogelijkheid om gegevens van Microsoft Azurebij te werken.  

Beveiligingsinformatie

Azure AD-toepassing

De Entra ID-toepassing (voorheen Azure AD) is de voorkeursmethode van Azure voor het beheren van digitale identiteiten voor zowel externe als on-premises toepassingen. 

Deze methode stelt Lucid in staat om inloggegevens veilig op te slaan, waarmee je eenvoudig jouw diagramkunt importeren en verversen. 

Zie deze bronnen voor meer informatie:

• Wat is applicatiebeheer? 
• Snel aan de slag: apps registreren bij het micro soft-identiteits platform

Veilige, beperkte toegang 

Lucid vraagt om beperkte, alleen-lezen toegang Toestemmen voor de Microsoft Azure AD-applicatie die je create. De Toestemmingen worden gedefinieerd binnen de custom role je tie to jouw applicatie. Een aangepaste rol die met deze Toestemmingen is aangemaakt, kan geen instellingen wijzigen in jouw Microsoft Azure architectuur of data lezen in jouw database. Lucid gebruikt alleen de AD-applicatie om de structurele metadata van jouw Microsoft Azure infrastructuur te lezen. Lucide leest alleen van abonnementen waar je ons toegang toe geeft; je kan dat controleren door de scope van de aangepaste rol die aan de AD-applicatie is toegewezen aan Lucid te beperken .

Alternatief CLI Script

Om de acties die Lucid uitvoert tijdens onze Microsoft Azure infrastructuurscan te beoordelen en te controleren, kan ik ons meegeleverde Python-script downloaden en gebruiken in plaats van een Microsoft Azure AD-applicatie te maken. In dit scenario worden jouw credentials nooit aan Luciddoorgegeven, en je kunt zowel de code die in jouw omgeving draait als de resulterende metadata bekijken voordat je de metadata uploadt naar Lucid. jouw geïmporteerde JSON zal toegankelijk zijn in de Lucid Data Hub om te gebruiken voor het maken vanLucidchart document.

Veilige opslag van document (document)

Lucid slaat Microsoft Azure geïmporteerde metadata en gegenereerde documenten op met industriestandaard beveiliging voor vertrouwelijke gegevens. Geïmporteerde Microsoft Azure data is ingebed als onderdeel van de Lucidchart document, zodat je de toegang tot de data kan beheren via Lucid's standaard gedeelde Toestemmen. Voor meer informatie over hoe Lucid jouw document beschermt, kunt u onze pagina voor Content Security raadplegen of contact opnemen met ons verkoopteam.

Veelgestelde vragen

Hoe krijgt Lucid toegang tot onze Microsoft Azure omgeving? Welk niveau van toegang heeft Lucid?

De aanbevolen methode van Lucid en Microsoft Azure is via een Microsoft Azure AD-applicatie. Wij bieden een beleid dat ons toegang geeft tot jouw omgeving met "beschrijven en lijsten", zodat we een inventaris van bronnen kunnen opmaken.

We hebben ook een methode die een python-script gebruikt die ik via de Command lijnen Interface (CLI) kan uitvoeren, wat een JSON-bestand genereert. Gebruiker kan dit JSON-bestand vervolgens uploaden naar Lucid zonder enige inloggegevens in Lucidte vullen.

Welke API's heeft Lucid toegang toe?

We gebruiken voornamelijk beschrijvende en lijst-API-eindpunten.

Kan ik kiezen welke metadata (de velden en waarden getoond in het paneel Gegevens) worden geïmporteerd? Zo niet, welke metadata worden geïmporteerd?

Nee, u kunt momenteel niet kiezen welke metadata worden geïmporteerd. We zijn echter op zoek naar mogelijkheden om dat in de toekomst te doen. Alle metagegevens van een beschrijvende API-aanroep worden geïmporteerd.

Feedback geven over dit artikel