Azure-infrastructuurgegevens importeren en beheren in Lucidscale

Bekijk: Microsoft Azure cloudarchitectuur importeren

Ondersteunde Azure-omgevingen, -resources en -lijnen

Voor een uitgebreide lijst van de ondersteunde omgevingen, resources en regels van Azure die beschikbaar zijn in Lucidscale, verwijzen we je naar ons artikel Ondersteunde Azure-omgevingen, -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 het artikel 'Optimaliseer prestaties in Lucidscale ' om de hoeveelheid data die je importeert te verminderen, of het aantal API-aanroepen dat Lucid naar Azure maakt 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 bepaalde types bronnen of metadata weg te laten bij het importeren. Dit geeft je de mogelijkheid om alleen de brontypes waarin je geïnteresseerd bent te visualiseren en kan in sommige gevallen de snelheid van het importeren verhogen. Gedeselecteerde resource types en metadata worden niet geïmporteerd of gevisualiseerd 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.
   1. 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 Kies bestand en upload het 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.

abonnement vermeld in deze sectie zijn databronnen die gebruikt kunnen worden om een nieuw Lucidscale-document te maken. Gegevensbronnen ("abonnement") bevatten de Azure-abonnementmetadata die wordt gebruikt om een Lucidscale-document te maken. Het veld "Laatst bijgewerkt" geeft aan wanneer uw gegevensbron voor het laatst is ververst om rekening te houden met eventuele updates in jouw connected 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.
• Het update-abonnement van Azure en Schedule update stellen je in staat om handmatig of automatisch de Azure-abonnementgegevens die ik in de datahub heb geïmporteerd bij te werken om eventuele wijzigingen in het verbonden Azure-abonnement weer te geven. Een nieuw document dat na de update vanuit het abonnement wordt aangemaakt, zal eventuele wijzigingen in het verbonden Azure-abonnement weerspiegelen. 

• 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 uit Azure bij te werken. je kan hetzelfde Azure-abonnement meer dan eens importeren — elk 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 Data Hub is waar ik alle AD-applicaties kan vinden die ik kan gebruiken om een 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 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 Azure-abonnement(en) importeren in de datahub en een Lucidscale-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 waren geïmporteerd, samen met documenten die uit dat abonnement zijn gemaakt, de mogelijkheid om gegevens van Azure bij 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. 

Met deze methode kan Lucidscale inloggegevens veilig opslaan, zodat u uw diagram eenvoudig kunt importeren en vernieuwen. 

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 beperkte, alleen-lezen toegangsrechten aan voor de Azure AD-toepassing die u maakt. De machtigingen worden gedefinieerd binnen de aangepaste rol die u koppelt aan uw toepassing. Een aangepaste rol die met deze machtigingen is gemaakt, kan geen instellingen in uw Azure-architectuur wijzigen of gegevens in uw databases lezen. Lucid gebruikt de AD-applicatie alleen om de structurele metadata van uw Azure-infrastructuur uit te lezen. Lucid leest alleen uit abonnementen waartoe u ons toegang verleent; u kunt dat controleren door het bereik te beperken van de aangepaste rol die is gekoppeld aan de AD-toepassing die is toegewezen aan Lucidscale. 

Alternatief CLI Script

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

Veilige opslag van document (document)

Lucidscale slaat Azure-geïmporteerde metadata en gegenereerde documenten op met industriestandaard beveiligingen voor vertrouwelijke gegevens. Geïmporteerde Azure-data is ingebed als onderdeel van de Lucidscale 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 met Content Securityraadplegen of contact opnemen met ons verkoopteam.

Veelgestelde vragen

Hoe krijgt Lucidscale toegang tot onze Azure-omgeving? Welk toegangsniveau heeft Lucidscale?

De aanbevolen methode van Lucidscale en Azure is via een Azure AD-toepassing. We bieden een beleid dat ons "beschrijf en lijst" toegang geeft tot uw omgeving, zodat we een inventaris van bronnen kunnen krijgen.

We hebben ook een methode die een python-script gebruikt dat u door de opdrachtregelinterface (CLI) kunt laten lopen die een JSON-bestand genereert. Gebruikers kunnen dit JSON-bestand vervolgens uploaden naar Lucidscale en geen referentiegegevens in Lucidscale invullen.

Tot welke API's heeft Lucidscale toegang?

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