Importa e gestisci i dati dell'infrastruttura Azure in Lucidscale

Guarda: Importazione Microsoft Azure architettura cloud

Ambienti, risorse e linee di Azure supportati

Per un elenco completo degli ambienti, delle risorse e delle linee supportate da Azure disponibili in Lucidscale, consulta il nostro articolo Ambienti, risorse e linee Azure supportati .

Importazione dell'infrastruttura Azure

È possibile importare i dati dell'infrastruttura cloud di Azure usando uno dei due metodi seguenti:

• Accesso attendibile: questo metodo utilizza una singola applicazione aziendale (in precedenza Azure AD), che può essere assegnata a uno (o più) gruppi di gestione di Azure o a una (o più) sottoscrizioni di Azure individuale. Le autorizzazioni di importazione vengono concesse tramite un ruolo di sola lettura assegnato a questa applicazione.
• Caricamento file: questo metodo usa uno script Python fornito da Lucid in un terminale dell'interfaccia della riga di comando di Azure configurato per generare un file JSON dei dati dell'infrastruttura per il caricamento manuale.

Dai un'occhiata alla tabella seguente per le specifiche su ciascun metodo e per determinare quale sia il migliore per il tuo caso d'uso.

*Tipo di risorsa 1 (risorse mappate): Tutte le risorse elencate nella sezione Risorse supportate sopra. Tipo di risorsa 2 (risorse non mappate): Una vasta gamma di risorse che puoi inserire manualmente nei tuoi documenti o accederle tramite Cloud Inventory nel Centro dati.
**Aggiornamenti automatici delle fonti dati sono disponibili per gli utenti da impostare su un programma ricorrente (giornaliero, settimanale, mensile, annuale) tramite Centro dati. Gli aggiornamenti manuali si effettuano con un solo clic nel Centro dati.

Lucid salva le credenziali di accesso affidabile così puoi aggiornare i dati o iniziare nuove importazioni senza dover reinserire le tue informazioni. Questa capacità di archiviazione consente a Lucid di effettuare aggiornamenti automatici dei dati. Le credenziali possono essere eliminate tramite la scheda credenziali dati di Azure Centro.

Se lavori con un ambiente molto ampio, usa le informazioni nell'articolo Ottimizza le prestazioni in Lucidscale per ridurre la quantità di dati che importi, oppure diminuire il numero di chiamate API che Lucid effettua ad Azure. Dopo che ogni importazione è terminata, puoi iniziare una nuova importazione.

Importazione tramite accesso di fiducia

Questo metodo fornisce un accesso sicuro e continuo registrando un'applicazione aziendale con autorizzazioni di sola lettura. Con l'accesso fidato, Lucid salva le tue credenziali, consentendoti di eseguire aggiornamenti automatici dei dati sia manuali che programmati.

Passaggio 1: Creare e registrare un'applicazione aziendale in Azure

Prima di tutto, si creerà e registrerà l'applicazione all'interno del portale di Azure. Questa applicazione fungerà da entità del servizio che Lucid utilizza per l'autenticazione.

1. Vai alla home page di Lucid.
2. Fare clic su Centro dati nella parte inferiore del menu di navigazione sul lato sinistro della pagina.
3. Nell'elenco dei provider nel Centro dati fare clic su Azure. 
4. Selezionare Importa dati di Azure.
5. Seleziona Accesso Affidabile.
   
    
6. In ambito credenziali scegliere "gruppo di gestione" o "sottoscrizione individuale". Se in precedenza hai registrato una credenziale, verrai indirizzato prima alla pagina di selezione delle credenziali.
7. Fai clic su Registra una nuova credenziale nella parte superiore di questa pagina.
8. Dopo aver selezionato l'ambito delle credenziali, selezionare Registra applicazione AD. In questo modo verrà visualizzata una nuova scheda con la pagina di registrazione dell'applicazione in Azure (se è già stato effettuato l'accesso ad Azure). Lascia aperta la scheda del browser Lucid. 
   • Per gli ambienti in Azure per enti pubblici, selezionare il collegamento direttamente sotto di esso.
     
9. Nella pagina di registrazione in Azure aggiungere un nome per l'applicazione e mantenere le impostazioni predefinite per tutti i campi rimanenti.
10. Fai clic su Registrati per completare la registrazione della tua Candidatura Aziendale.
11. Vai a Registrazioni app in Microsoft Entra ID e seleziona l'applicazione che hai appena registrato.
12. In Proprietà, copiare l'"ID applicazione (client)" facendo clic sull'icona di copia negli appunti.
    • Torna alla scheda Lucid, incolla questo valore nel campo "ID applicazione (client)".
    • Ripetere questa procedura per l'"ID directory (tenant)".
      
13. Nella scheda Azure selezionare Gestisci nel menu di spostamento a sinistra.
14. Seleziona Certificati e segreti. 
15. Fare clic su + Nuovo segreto client.
16. Fornisci una descrizione, seleziona un periodo di scadenza e fai clic su Aggiungi. 
17. Copiare immediatamente il valore del nuovo segreto poiché questo valore viene visualizzato una sola volta. Torna alla scheda Lucid, incolla questo valore nel campo "Valore segreto client" del passaggio 3. 

Passaggio 2: Assegnare un ruolo all'applicazione Aziendale

Dopo aver creato l'applicazione, è necessario concederle le autorizzazioni per leggere i metadati dell'ambiente Azure. Sono disponibili due opzioni: l'assegnazione di un ruolo predefinito di sola lettura (scelta consigliata) o la creazione di un ruolo personalizzato con le autorizzazioni minime necessarie. Queste due opzioni sono elencate nel passaggio 2: "Assegnare un ruolo all'applicazione AD". 

Opzione A: Usare un ruolo di sola lettura per tutte le risorse (scelta consigliata)

Lucid consiglia di utilizzare il ruolo integrato di Azure per l'accesso in sola lettura, poiché le nuove risorse di Azure vengono aggiunte automaticamente e diventano disponibili per le importazioni Lucid. Questo approccio concede all'applicazione l'accesso in sola lettura a tutte le risorse all'interno dell'ambito specificato (un gruppo di gestione o una sottoscrizione specifica).

1. Nel portale di Azure passare alla sottoscrizione o al gruppo di gestione che si vuole importare.
2. Selezionare Controllo accessi (IAM) dal menu di navigazione.
3. Fare clic su + Aggiungi.
4. Scegliere Aggiungi assegnazione di ruolo.
5. Nella scheda Ruolo , cerca e seleziona il ruolo Lettore predefinito.
6. Passare alla scheda Membri .
7. Fai clic su + Seleziona membri e cerca il nome dell'applicazione Aziendale che hai registrato in precedenza.
8. Seleziona l'applicazione.
9. Fai clic su Salva.
10. Fare clic su Rivedi + crea per completare l'assegnazione del ruolo.

Opzione B: creare e assegnare un ruolo personalizzato

In questo approccio, si crea un ruolo con le autorizzazioni minime esatte necessarie per un'importazione.

1. Nella scheda Lucid, vai al passaggio 2 e seleziona l'opzione "Ruolo personalizzato".
2. Fare clic su Scarica file JSON per salvare il file delle autorizzazioni di base del ruolo.
3. Nel portale di Azure passare alla sottoscrizione o al gruppo di gestione che si vuole importare.
4. Vai a Controllo degli accessi (IAM).
5. Seleziona + Aggiungi > Aggiungi ruolo personalizzato.
6. Accanto a Autorizzazione di base.
7. Scegli Start from JSON e carica il file che hai scaricato da Lucid.
8. Assegna al ruolo un nome descrittivo del ruolo personalizzato, ad esempio Accesso minimo in lettura Lucid.
9. Nella scheda Ambiti assegnabili verificare che la sottoscrizione o il gruppo di gestione di destinazione sia elencato. In caso contrario, selezionare + Aggiungi ambiti assegnabili. 
   • Per le importazioni a livello di gruppo di gestione, imposta il tipo su "Gruppo di gestione" e seleziona ogni gruppo che vuoi importare. 
   • Per le importazioni a livello di abbonamento Individuale, imposta il tipo su "Abbonamento" e seleziona ogni abbonamento che desideri importare. 
10. Fai clic su Rivedi + crea.
11. Selezionare Crea per finalizzare il ruolo personalizzato.
12. Nelle impostazioni di controllo di accesso (IAM) della sottoscrizione o del gruppo di gestione.
13. Fare clic su + Aggiungi.
14. Selezionare Aggiungi assegnazione di ruolo.
    • Per il ruolo, cerca e seleziona il ruolo personalizzato appena creato.
    • Per Assegna accesso a, lasciare il valore predefinito (Utente, gruppo o entità servizio).
    • Per Seleziona, trova e scegli l'applicazione aziendale che hai registrato.
    • Fare clic su Salva per applicare l'assegnazione di ruolo.

Passo 3: Aggiungi credenziali e importa abbonamenti a Centro dati

Infine, fornirai le credenziali dell'applicazione a Lucid per convalidare la connessione.

1. Torna alla scheda Lucid che hai precedentemente lasciato aperta.
   • Se l'applicazione è stata creata in Azure per enti pubblici, aggiornare il "Tipo di applicazione AD" in "Applicazione Azure per enti pubblici". 
2. Immettere un nome visualizzato per la credenziale in modo da poterla identificare in un secondo momento. Questo andrà nel campo "Nome visualizzato dell'applicazione AD".
3. Fare clic su Avanti.
4. Seleziona le caselle relative all'abbonamento o agli abbonamenti che desideri importare.
5. Clicca su Next.
   
6. Selezionare i tipi di risorse che si desidera importare.
   • Quando si importano gli abbonamenti ai dati di Lucid Centro, è possibile omettere i tipi di risorse o i metadati scelti dall'importazione. In questo modo è possibile visualizzare solo i tipi di risorse che interessano e, in alcuni casi, è possibile aumentare la velocità di importazione. I tipi di risorse e i metadati deselezionati non verranno importati o visualizzati in un diagramma. 
   • Per gli abbonamenti con un numero elevato di risorse, consulta Ottimizzare le prestazioni in Lucidscale per migliorare l'esperienza del prodotto.
   • Per le credenziali con più di 1 sottoscrizione, la configurazione per i metadati e i tipi di risorse omessi si applicherà a tutte le sottoscrizioni elencate nella sezione "Riepilogo importazione".
7. (Facoltativo) Personalizzare il nome di ogni sottoscrizione di Azure. Inoltre, è possibile aggiungere il testo del prefisso a tutte le sottoscrizioni elencate.
   
8. Clicca su Importa abbonamenti Azure.

Caricamento file

Per importare l'infrastruttura di Azure tramite il caricamento di un file JSON, seguire questa procedura:

1. Nella home page di Lucid, fai clic su Centro dati nel menu di navigazione a sinistra.
2. Selezionare Importa dati di Azure.
3. Scegli Caricamento file.
4. Selezionare Applicazione Azure globale o Applicazione Azure per enti pubblici a seconda della posizione in cui risiede l'istanza di Azure. Lascia aperta questa scheda in modo da poterci tornare in un secondo momento.
5. Fare clic su Scarica requirements.txt e Scarica script. 
6. Configurare l'interfaccia della riga di comando di Azure usando il file di requirements.txt e le istruzioni elencate all'inizio del file di azurecliscript.py .
   1. Per altre istruzioni sulla configurazione, vedere la sezione Descrizione dello script di caricamento file di Azure riportata di seguito.
7. Eseguire lo script Python nell'interfaccia della riga di comando di Azure. Verrà generato un file azure.json . 
8. Nella scheda dati di Lucid Centro, seleziona Scegli file e carica il file azure.json . 
9. Fare clic su Avanti.
10. Specificare un nome alias per ogni abbonamento che si desidera importare.
11. Selezionare Importa sottoscrizioni di Azure.

Descrizione dello script di caricamento file di Azure 

Lo script di importazione fornito da Lucid, azurecliscript.py, sfrutta la CLI di Azure e l'Azure SDK per Python per raccogliere la configurazione delle risorse Azure. Richiede una corretta autenticazione e una selezione specifica di abbonamento.

Lo script usa AzureCliCredential per l'autenticazione, basandosi sulla sessione dell'interfaccia della riga di comando di Azure attiva stabilita con az login. Le credenziali di az login concedono l'accesso al tenant Microsoft Entra ID (Active Directory).

• Se si recuperano dati da Azure Government Cloud, impostare prima l'ambiente cloud: az cloud set --name AzureUSGovernment.
• In caso contrario, per Azure globale, assicurarsi che l'ambiente cloud sia impostato su AzureCloud: az cloud set --name AzureCloud.

Per una documentazione dettagliata sulla gestione delle sottoscrizioni di Azure e sull'autenticazione con l'interfaccia della riga di comando di Azure, vedere la documentazione di Azure su Gestire le sottoscrizioni di Azure con l'interfaccia della riga di comando di Azure e Accedere con l'interfaccia della riga di comando di Azure.

Fabbisogno:

• Pitone: Versioni 3.0-3.9. Assicurarsi che l'opzione "Aggiungi Python a PATH" sia selezionata durante l'installazione.
• Interfaccia della riga di comando di Azure: Installato e configurato.
• Pacchetti di Azure SDK: Lo script richiede pacchetti specifici di Azure SDK (ad esempio, azure.mgmt.compute, azure.mgmt.network, ecc.). Questi si installano eseguendo pip3 install -r requirements.txt dopo aver scaricato requirements.txt dal Centro dati.

Parametri:

• -s, --subscriptions [OBBLIGATORIO] 
  • Specifica uno o più ID sottoscrizione di Azure da cui importare le risorse. Questa opzione può essere ripetuta per eseguire l'importazione da più sottoscrizioni all'interno della sessione autenticata dell'interfaccia della riga di comando di Azure.
• -o, --output
  • Specifica il nome del file per il codice JSON di output generato. Se non specificato, verrà utilizzato il nome file predefinito azure.json .
• -c, --conteggio
  • Genera un file JSON denominato count.json contenente un conteggio delle risorse. Quando si utilizza questo flag, il file JSON generato non è adatto per le importazioni Lucid.

Esempio:

Il comando precedente esegue lo script e genera un file JSON denominato my_azure_data.json per le risorse che risiedono nelle sottoscrizioni di Azure specificate.

Usa Centro dati per gestire i dati e le credenziali dell'infrastruttura Azure

Abbonamenti importati

Dopo aver importato i dati di abbonamento Azure, verranno elencati come sorgente dati con il nome dell'abbonamento specificato nella sezione "Azure: Abbonamenti importati" del Centro dati. Da questa sezione puoi anche cliccare + Nuovo Abbonamento per importare un nuovo abbonamento nell'hub data.

Gli abbonamenti elencati in questa sezione sono fonti di dati che possono essere utilizzate per creare nuovi documenti Lucidscale. Le fonti dati ("Abbonamenti") contengono i metadati Azure per abbonamento utilizzati per creare documenti Lucidscale. Il campo "Ultimo aggiornamento" indica quando la tua fonte dati è stata aggiornata l'ultima volta per tenere conto di eventuali aggiornamenti nel tuo abbonamento Azure connesso.

L'Inventario Cloud di ogni abbonamento può essere visualizzato sul lato destro dopo aver selezionato un abbonamento dalla lista. Questo inventario ti permette di vedere il conteggio completo di ogni tipo di risorsa importata prima di creare un documento. Puoi anche scaricare un CSV per le importazioni con credenziali; questo file contiene un elenco di risorse e conteggio direttamente dai dati del Centro cliccando su Download CSV.

L'inventario elenca tutte le risorse a cui è possibile accedere tramite le autorizzazioni del ruolo assegnate all'applicazione AD. Se si sceglie di utilizzare un ruolo di sola lettura per tutte le risorse, tutte le risorse dell'abbonamento accessibili dal Microsoft Azure ruolo "Lettore" di verranno visualizzate nell'inventario. Se si crea un ruolo personalizzato, nell'inventario verrà eseguito il rendering solo dei tipi di risorse specificati nelle autorizzazioni del ruolo assegnate.

Clicca sul menu a tre punti reso su un abbonamento per accedere alle seguenti opzioni potenziali: 

• Creare un nuovo documento inizia a renderizzare l'infrastruttura Azure associata all'abbonamento come diagramma nello spazio di lavoro del nuovo documento. Un documento verrà generato in background della tua Home Page di Lucid e ti avviseremo una volta che sarà stato visualizzato tramite il modale di stato che appare in basso a destra della pagina.
• Aggiornare l'abbonamento da Azure e Schedule Update ti permettono di aggiornare manualmente o automaticamente i dati Azure importati nel Centro dati per riflettere eventuali modifiche nell'abbonamento Azure connesso. I nuovi documenti creati dall'abbonamento dopo l'aggiornamento rifletteranno eventuali cambiamenti nell'abbonamento Azure collegato. 

• Modifica risorse ti permetterà di modificare le risorse incluse in ogni dataset. Selezionando questa opzione si aprirà un modale in cui puoi aggiungere o rimuovere risorse dai tuoi dataset esistenti. Quando hai finito la selezione, clicca su Salva e aggiorna Abbonamento. Questo garantirà che il dataset venga aggiornato e che i documenti che fanno riferimento a quel dataset vengano aggiornati con le informazioni più recenti.
  
• Rinomina Sottoscrizione ti permette di cambiare il nome del dataset selezionato.
• Elimina l'abbonamento rimuove l'abbonamento importato dal dati di Lucid Centro. Qualsiasi documento creato da quell'abbonamento perderà la possibilità di aggiornare i dati da Azure. Puoi importare lo stesso abbonamento Azure più di una volta — ognuno crea una fonte dati indipendente. Non è necessario eliminare un abbonamento esistente prima di riimportarlo.

Credenziali salvate

La pagina Credenziali salvate in Centro dati è dove puoi trovare tutte le applicazioni AD che puoi usare per importare abbonamenti Azure al Centro dati. Da questa pagina, clicca + Nuova applicazione AD per aggiungere un nuovo set di credenziali che possono essere utilizzate per importare un abbonamento Azure.  

Per condividere le applicazioni AD che hai creato con altri utenti, clicca sul menu a tre punti reso su un'applicazione AD. 

Da qui, hai due potenziali opzioni: 

• Condividi la credenziale apre un modale che ti permette di condividere un'applicazione AD che hai creato con un altro utente sul tuo account Lucid specificando il suo indirizzo email. Concedendo loro l'accesso all'applicazione AD consente loro di importare l'abbonamento Azure associato ai dati del Centro e creare documenti Lucidscale. Dopo che una credenziale è stata condivisa con un altro utente, puoi revocare il suo accesso cliccando sulla X accanto al suo indirizzo email nello stesso modo modale.
• Eliminare la credenziale rimuove la tua domanda AD dal Centro dati. Dopo aver eliminato una credenziale, tutti gli abbonamenti precedentemente importati con quella credenziale, insieme ai documenti creati da tali abbonamenti, perdono la possibilità di aggiornare i dati da Azure.  

Informazioni sulla sicurezza

Applicazione Azure AD

L'applicazione Entra ID (ex Azure AD) è il metodo preferito da Azure per la gestione delle identità digitali sia per le applicazioni esterne che per quelle on-premise. 

Questo metodo consente a Lucidscale di memorizzare in modo sicuro le credenziali che ti permettono di importare e aggiornare facilmente il tuo diagramma. 

Per maggiori informazioni, consulta queste risorse:

• Che cos'è la gestione delle applicazioni? 
• Avvio rapido: Registra le app con la piattaforma di identità Microsoft

Accesso sicuro e limitato 

Lucid richiede un permesso di accesso limitato e di sola lettura per l'applicazione Azure AD creata. I permessi sono definiti all'interno del ruolo personalizzato che hai associato alla tua applicazione. Un ruolo personalizzato creato con queste autorizzazioni non può modificare le impostazioni della tua architettura Azure o leggere i dati nei tuoi database. Lucid utilizza l'applicazione AD solo per leggere i metadati strutturali della tua infrastruttura Azure. Lucid legge solo le sottoscrizioni a cui ci hai concesso l'accesso; puoi controllare questo aspetto limitando l'ambito del ruolo personalizzato collegato all'applicazione AD assegnata a Lucidscale. 

Alternativa di script CLI

Per rivedere e controllare le azioni che Lucid intraprende durante la scansione dell'infrastruttura Azure, puoi scaricare e utilizzare il nostro script Python fornito invece di creare un'applicazione Azure AD. In questo scenario, le tue credenziali non verranno mai passate a Lucidscale e puoi rivedere sia il codice che verrà eseguito nel tuo ambiente sia i metadati risultanti prima di caricare i metadati su Lucidscale. Il tuo JSON importato sarà accessibile nei dati di Lucid Centro per creare documenti Lucidscale.

Conservazione sicura di documenti (documenti)

Lucidscale memorizza i metadati importati di Azure e i documenti generati utilizzando le protezioni standard del settore per i dati riservati. I dati Azure importati sono incorporati come parte del documento Lucidscale, così puoi controllare l'accesso ai dati utilizzando i permessi standard di condivisione di Lucid. Per ulteriori informazioni su come Lucid protegge i tuoi documenti, consulta la nostra pagina Content Security o contatta il nostro team vendita.

FAQ

Come fa Lucidscale ad accedere al nostro ambiente Azure? Che livello di accesso ha Lucidscale?

Il metodo consigliato da Lucidscale e Azure è quello di utilizzare un'applicazione Azure AD. Forniamo una politica che ci permette di accedere al tuo ambiente "descrivendo ed elencando" in modo da ottenere un inventario delle risorse.

Abbiamo anche un metodo che utilizza uno script python che puoi eseguire attraverso l'interfaccia a riga di comando (CLI) e che genera un file JSON. Gli utenti possono quindi caricare questo file JSON su Lucidscale e non inserire alcuna informazione sulle credenziali in Lucidscale.

A quali API accede Lucidscale?

Utilizziamo principalmente gli endpoint API describe e list.

Posso scegliere quali metadati (i campi e i valori mostrati nel pannello Dati) vengono importati? In caso contrario, quali metadati vengono importati?

No, attualmente non è possibile scegliere quali metadati importare. Tuttavia, stiamo cercando di creare la possibilità di farlo in futuro. Tutti i metadati di una chiamata API di descrizione vengono importati.

Lascia un feedback su questo articolo