Usa Lucidscale per importare i dati dell'infrastruttura cloud da AWS e generare diagrammi in un modello Lucidscale.

Lucidscale è disponibile per Lucid Suite account aziendali come acquisto aggiuntivo con Cloud Accelerator. Per ulteriori informazioni su Cloud Accelerator, consulta il nostro articolo Panoramica su Cloud Accelerator .

Regioni, risorse e linee AWS supportate

Per un elenco completo delle regioni, delle risorse e delle linee supportate da AWS disponibili in Lucidscale, consulta il nostro articolo Regioni, risorse e linee AWS supportate .

Importazione dell'infrastruttura AWS

È possibile importare i dati dell'infrastruttura cloud AWS utilizzando uno dei quattro metodi seguenti:

Accesso attendibile: fornisci un ruolo IAM cross-account con le policy appropriate. Questo ruolo può essere impostato con i seguenti ambiti di autorizzazione:
- Importazione tramite accesso a livello di account per importare un account Individuale
  Importazione tramite accesso a livello organizzativo per importare tutti gli account AWS da un'unità organizzativa o dall'intera organizzazione
Autorizzazione monouso: inserisci le credenziali di un utente IAM a cui sono collegate le policy appropriate
Caricamento di file: esegui uno script Python fornito da Lucid in un profilo AWS CLI configurato, che raccoglie i dati localmente come file JSON, quindi fornisce il file generato

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.

Metodo di importazione	Descrizione	Ambito	Tipi di supporto delle risorse*	Aggiornamento dati**
Livello di organizzazione: accesso attendibile	Registra un ruolo IAM cross-account a livello di organizzazione con Lucid per un riutilizzo sicuro e a lungo termine.	Gestisci centralmente le importazioni per tutti gli account all'interno di un'organizzazione o di un'unità organizzativa AWS tramite la registrazione di un'unica credenziale.	(1) e (2)	Automatico e Manuale
A livello di account: accesso attendibile	Registra un ruolo IAM cross-account a livello di account con Lucid per un riutilizzo sicuro e a lungo termine.	Registra una credenziale per ogni account AWS Individuale.	(1) e (2)	Automatico e Manuale
Autorizzazione monouso	Carica una chiave utente IAM o un file delle credenziali su Lucid.	Accesso una tantum a un account AWS individuale.	(1) e (2)	Manuale
Caricamento file	Esegui uno script Python fornito da Lucid in un profilo AWS CLI configurato, quindi carica il file JSON generato su Lucid.	Fino a 50 account per file JSON.	(1) solo	Manuale Aggiorna i dati caricando un file JSON appena generato.

*Il tipo di risorsa 1 è costituito da tutte le risorse mappate elencate nella sezione Risorsa supportata. Il tipo di risorsa 2 è l'inventario cloud: un'ampia varietà di risorse non mappate che è possibile inserire manualmente nei modelli.
**Gli aggiornamenti automatici delle origini dati sono disponibili per gli utenti da impostare su una pianificazione ricorrente (giornaliera, settimanale, mensile, annuale) tramite il Centro dati. Anche gli aggiornamenti manuali vengono eseguiti con un solo clic tramite il Centro dati.

Con le importazioni con accesso affidabile, Lucid salva queste credenziali in modo da poter aggiornare i dati o avviare nuove importazioni senza reinserire le informazioni. Questa capacità di archiviazione consente a Lucid di eseguire gli aggiornamenti automatici dei dati. Le credenziali possono essere eliminate tramite la scheda delle credenziali dei dati di AWS Centro. Lucid non memorizza le credenziali utente IAM per il riutilizzo futuro, limitando l'autorizzazione monouso al solo aggiornamento manuale.

Se stai lavorando con un ambiente molto grande, utilizza le informazioni nella sezione Configurazione dell'account utilizzando un ruolo multi-account di seguito per ridurre la quantità di dati che stai importando o ridurre il numero di chiamate API che Lucid effettua ad AWS. Lucid supporta fino a 50 importazioni simultanee di account per utente. Al termine di ogni importazione, è possibile avviare una nuova importazione.

Nota: Le importazioni di AWS GovCloud sono consentite solo dai client Lucid GovSuite. L'ambiente commerciale Lucid non può accedere ad AWS GovCloud tramite ruoli cross-account.

Per importare e visualizzare l'infrastruttura AWS in un modello Lucidscale, procedi nel seguente modo:

Vai alla home page di Lucid.
Fare clic su Centro dati nella parte inferiore del menu di navigazione sul lato sinistro della pagina.
Fai clic su Importa dati AWS e scegli un metodo di importazione.
- Dopo aver scelto un metodo di importazione e aver completato l'importazione, l'account verrà elencato come origine dati nella sezione "AWS: Account importati" del Centro dati.
Clicca sul menu a tre puntini accanto all'account da cui vuoi creare un modello.
Seleziona Crea un nuovo modello.
Esamina i dettagli, aggiungi filtri per escludere le risorse non necessarie e seleziona le visualizzazioni iniziali delle risorse in base all'interesse della documentazione.
Seleziona Crea modello AWS.

Il modello Lucidscale verrà generato in background del tuo account Lucid. Ti avviseremo una volta completato tramite la modalità di stato che appare in basso a destra della pagina e via e-mail se abilitata.

Una volta completata la generazione del modello Lucidscale, puoi visualizzare il modello in una nuova scheda selezionando il link "Apri modello" dalla finestra modale di stato. Tutti i modelli Lucidscale generati saranno inoltre archiviati e accessibili nella sezione "Documenti" della tua Home Page Lucid dopo che l'avrai generata.

modal_confirming_successful_creation_of_aws_lucidscale_model.png

Ulteriori informazioni: Leggi il nostro articolo su come lavorare con l'architettura AWS in un modello Lucidscale dopo la generazione del modello.

Accesso attendibile a livello di organizzazione

Per gestire centralmente le importazioni dell'infrastruttura nell'intera organizzazione AWS, procedi nel seguente modo.

Nota: Se ti trovi nell'ambiente Lucid GovSuite, potrai importare gli account AWS GovCloud solo tramite il ruolo cross-account. L'ambiente commerciale Lucid non può accedere agli account AWS GovCloud tramite ruoli cross-account. Per ulteriori dettagli, consulta la sezione FAQ di seguito.

Registra un nuovo ruolo IAM cross-account tramite Lucid Centro dati in Lucid per gestire le importazioni a livello di organizzazione. A tale scopo, selezionare il provider IaC (Infrastructure as Code) preferito per configurare automaticamente gli account all'interno dell'organizzazione per l'importazione:

Vai alla home page di Lucid.
Fare clic su Centro dati nella parte inferiore del menu di navigazione sul lato sinistro della pagina.
Seleziona Importa dati AWS.
Seleziona Accesso attendibile.
Nell'ambito delle credenziali, scegli "Connetti a un'organizzazione AWS".
Scegli tra le opzioni per impostare automaticamente le autorizzazioni:
- Utilizzare un modulo Terraform
- Usa il modello CloudFormation

seleziona-cloudformation-or-terraform-method-for-creating-role

Utilizzo di Terraform per la configurazione automatizzata delle autorizzazioni di AWS Organization

Innanzitutto, assicurati di aver configurato Terraform per gli account a cui aggiungerai i moduli terraform di Lucid.

Ulteriori informazioni: Per istruzioni, consulta questa Guida introduttiva - AWS dalla documentazione di Terraform. Il link fornito ti guida fuori dal centro di assistenza Lucid e non possiamo garantire l'accuratezza del contenuto.

Successivamente, configura e distribuisci il modulo Terraform di Lucid, seguendo questi passaggi:

Accedi al modulo Terraform di Lucid per configurare le autorizzazioni facendo clic su Visualizza nel registro Terraform o accedi direttamente al modulo con questo link.
Nella pagina del registro dei moduli, fare clic su Sottomoduli. Configurerai ciascuno dei tre sottomoduli necessari dall'elenco a discesa (org-read-delegation, bastion-role e import-role) nel tuo main.tf.
Segui le istruzioni "Utilizzo" nella pagina Leggimi di ogni sottomodulo per aggiungere il modulo al codice di configurazione di Terraform.
- Il sottomodulo org-read-delegation: imposta le autorizzazioni per Lucid per scansionare la struttura dell'organizzazione AWS. Questo deve essere distribuito nell'account di gestione o in un account membro a cui è stata delegata la gestione dei criteri per le organizzazioni.
  - Se esiste già un criterio di delega basato sulle risorse, la distribuzione avrà esito negativo. Invece di aggiungere questo sottomodulo, aggiungi manualmente le autorizzazioni della policy JSON fornita da Lucid collegata qui alla policy basata sulle risorse esistente.
- Il sottomodulo bastion-role: crea il ruolo IAM primario nel tuo account bastion che Lucid assumerà.
  - Imposta il parametro external_id utilizzando il valore univoco "ID esterno" copiato dalla pagina di configurazione dell'importazione AWS del tuo account Lucid.
- Il sottomodulo import-role: crea il ruolo IAM da distribuire negli account membro per la lettura dei dati delle risorse.
  - Questo modulo stesso crea una definizione di ruolo nell'account bastion: il modulo non è in grado di automatizzare tale processo per gli account membri. Questo modulo deve essere implementato in ogni account membro da cui si desidera importare i dati, anche ogni volta che si desidera aggiungere nuovi account all'organizzazione in futuro. Segui le procedure standard della tua organizzazione per applicare il codice di questo modulo agli account appena aggiunti.
Distribuisci il tuo codice Terraform e attendi che vengano create le risorse incluse dal modulo di Lucid.
Dalla console AWS IAM nel tuo account bastion, copia l'ARN del lucid-import-bastion-role creato (o il suo nome personalizzato). In alternativa, esporta questo ARN dalla configurazione Terraform.

Quindi, completerai la configurazione nella scheda dati di Lucid Centro:

Nella configurazione dell'importazione AWS di Lucid, fornisci l'ARN del ruolo Bastion copiato.
- Se personalizzato durante l'installazione, aggiorna il nome del ruolo dell'account membro in modo che corrisponda alla tua configurazione (ad esempio, il parametro role_name nel sottomodulo import-role).
- Se lo si desidera, aggiornare il valore precompilato per "Nome visualizzato credenziali". Questo nome visualizzato verrà utilizzato nella sezione "Centro dati > AWS > Credentials" in modo da poter individuare le credenziali per l'uso e la gestione futuri e rappresenterà il ruolo di base utilizzato per coordinare le importazioni.
Fai clic su Avanti per registrare il ruolo cross-account con Lucid.
Selezionare il ruolo e fare clic su Avanti.
Procedi con i passaggi per importare gli account e creare i modelli.

Utilizzo di CloudFormation per la configurazione automatizzata delle autorizzazioni di AWS Organization

Innanzitutto, assicurati che la tua organizzazione AWS e l'account che avvia gli stack abbiano le configurazioni corrette:

L'account AWS deve essere: l'account di gestione dell'organizzazione AWS o un account amministratore delegato per AWS CloudFormation StackSets. Il principio IAM (utente o ruolo) che gestisce lo stack deve essere all'interno del suddetto account e non essere un utente root.
Inoltre, l'account deve essere uno che non è ancora stato utilizzato come account bastion con Lucid.

Per impostare automaticamente le autorizzazioni con CloudFormation, procedi nel seguente modo:

Identifica i seguenti tre parametri nella tua organizzazione AWS. Questi saranno gli input chiave per il primo stack CloudFormation Modello:
- BastionAccountId: questo è l'ID dell'account AWS di 12 cifre che desideri utilizzare per gestire l'accesso attendibile di terze parti. Lucid assumerà un ruolo trasversale in questo "conto bastione" per coordinare le importazioni.
- BastionRootOrOrganizationalUnitId: si tratta dell'ID dell'unità organizzativa (OU) (ad esempio, ou-xxxxxxxxxx) o radice (ad esempio, r-xxxx) che contiene il BastionAccountId scelto.
- MembersRootOrOrganizationalUnitId: questo parametro controlla l'ambito degli account nell'organizzazione AWS da cui Lucid può importare i dati delle risorse.
  - Per consentire l'importazione da tutti gli account della tua organizzazione, utilizza l'ID della root della tua organizzazione (ad esempio, r-xxxx).
  - Se vuoi consentire l'importazione solo per gli account nidificati all'interno di una singola unità organizzativa specifica, utilizza l'ID di tale unità organizzativa specifica (ad es. ou-xxxxxxxxxx).
Dopo aver selezionato l'opzione CloudFormation per le importazioni organizzative, avvia il primo modello CloudFormation fornito nella console AWS e configuralo utilizzando i parametri richiesti descritti sopra.
- I parametri facoltativi includono i nomi per i ruoli da creare (ad esempio, MemberRoleName e BastionRoleName). Prendi nota di tutti i nomi personalizzati che utilizzi.
Fare clic su Crea stack e attendere il completamento della distribuzione.
Torna alla scheda Lucid e avvia il secondo modello CloudFormation fornito. Utilizzerai questo Modello per consentire al ruolo bastion di identificare gli account per l'importazione scansionando la struttura della tua organizzazione tramite le azioni "elenca" e "descrivi".
- Se esiste già un criterio di delega basato sulle risorse, la distribuzione avrà esito negativo. Invece di usare questo stack, aggiungere ResourcePolicy dal criterio JSON qui al criterio di delega esistente.
Nella console AWS del tuo account bastion, vai su IAM e individua il ruolo cross-account creato in Ruoli.
Vai alla pagina di riepilogo dei ruoli su più account e copia la stringa ARN dei ruoli.
Torna alla scheda dati di Lucid Centro e scorri verso il basso fino alla sezione "Aggiungi il ruolo cross-account a Lucid".
- Inserisci l'ARN del ruolo dell'account bastion nel campo "ARN del ruolo bastion".
- Se hai utilizzato un MemberRoleName personalizzato durante la configurazione del primo modello CloudFormation, aggiorna il campo "Nome ruolo account membro" su tale valore.
- (Facoltativo) Aggiornare il valore precompilato per "Nome visualizzato credenziali" in modo che rappresenti il ruolo di base utilizzato per coordinare le importazioni. Questo nome visualizzato verrà utilizzato nei dati del Centro di Lucid in modo da poter identificare le credenziali per l'uso e la gestione futuri.
Fai clic su Avanti per registrare il ruolo cross-account con Lucid.
Selezionare il ruolo e fare clic su Avanti.
Procedi con i passaggi per importare gli account e creare i modelli.

Nota: Questi modelli CloudFormation sono configurati per l'utilizzo di set di stack con autorizzazioni gestite dal servizio. Al momento non supportiamo la configurazione di CloudFormation utilizzando set di stack con autorizzazioni autogestite.

Importa account e crea modelli

Seleziona l'account o gli account che desideri importare nel Centro dati.
Fare clic su Avanti.
- Utilizzando le istruzioni dettagliate alla fine di questa sezione in Configurazione dell'account utilizzando un ruolo multi-account, è possibile specificare le regioni che si desidera importare.
Fai clic su Importa account AWS.

Per visualizzare il tuo account AWS al termine dell'importazione:

Rientro al Centro dati.
Seleziona Crea nuovo modello.
Seleziona l'account che hai importato e fai clic su Scegli account.
Esamina i dettagli e aggiungi filtri per escludere le risorse non necessarie.
Seleziona Crea un modello AWS.

Il modello Lucidscale verrà generato in background del tuo account Lucid. Ti avviseremo una volta che è stato creato tramite una finestra modale di stato che appare in basso a destra della pagina.

È possibile aprire il modello dalla finestra modale di stato che appare subito dopo la creazione di un nuovo modello. Il modello (e i modelli creati in precedenza) saranno anche memorizzati e accessibili nella sezione "Documenti" della tua Home Page Lucid dopo che l'avrai generata.

Configurazione dell'account utilizzando un ruolo tra account

Quando si importano account AWS nei dati di Lucid Centro utilizzando un ruolo multi-account, è 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.

configura-risorse-incluse-nell'importazione

Accesso attendibile a livello di account

Per importare l'infrastruttura AWS per gli account Individuale tramite un ruolo IAM multi-account e creare un modello Lucidscale, procedi nel seguente modo.

Per l'accesso attendibile a livello di account, è necessario creare un ruolo separato per ogni nuovo account AWS che si desidera importare. A tale scopo, selezionare Registra una nuova credenziale nella pagina di importazione "Accesso attendibile".

Registra un nuovo ruolo IAM cross-account in Lucid:

Vai alla home page di Lucid.
Fare clic su Centro dati nella parte inferiore del menu di navigazione sul lato sinistro della pagina.
Seleziona Importa dati AWS.
Seleziona Accesso attendibile.
Nell'ambito delle credenziali, scegli "Connetti agli account AWS individuali".
Scegli tra le opzioni per registrare una nuova credenziale:
- Utilizzare un modello CloudFormation
- Crea manualmente

opzioni-per-creare-un-nuovo-ruolo-per-le-apparenze-in-lucidscale.png

Per creare automaticamente un nuovo ruolo con CloudFormation, segui questi passaggi:

Assicurati che "Includi accesso di sola lettura" sia abilitato.
- Questa impostazione è abilitata per impostazione predefinita e fornisce il miglior supporto per l'importazione di risorse e la loro visualizzazione all'interno dei modelli Lucidscale.
Clicca su Avvia CloudFormation per aprire una nuova scheda del browser e accedi al tuo account AWS. Lascia aperta la scheda del browser Lucid per potervi tornare in seguito.
Clicca su Crea impilamento.
Dopo aver creato lo stack, vai alla scheda Risorse e seleziona "LucidscaleImportRole".
Vai ai passaggi per registrare il tuo ruolo cross-account su Lucidscale.

Per creare manualmente un nuovo ruolo nella Console AWS IAM, segui i seguenti passaggi:

In "Passo 1: Iniziare a creare un ruolo" seleziona Crea ruolo.
- Verrai indirizzato al tuo account AWS. Lascia aperta la scheda del browser Lucid per potervi tornare in seguito.
- Lucidscale genererà automaticamente un ID esterno unico associato al tuo account Lucidscale. Questo è in linea con le raccomandazioni di sicurezza di AWS.
In AWS, clicca su Avanti: Autorizzazioni.
Nella pagina "Aggiungi permessi", cerca e seleziona il criterio ReadOnlyAccess.
- Questa impostazione è abilitata per impostazione predefinita in Lucid ed è necessaria affinché tutte le risorse appaiano correttamente nei modelli Lucidscale creati.
Torna alla scheda Lucid all'indirizzo "Passo 2: Aggiungi permessi personalizzati" e clicca su Copia permessi per copiare il file di testo JSON.
Torna alla pagina "Crea ruolo" di AWS e clicca su Crea criterio. Verrai indirizzato a una nuova scheda del browser per creare il criterio.
Nella pagina "Crea criterio", passa alla scheda JSON e incolla il file copiato nella scheda JSON nella tua console AWS.
Clicca su Avanti: Tag.
Se vuoi, aggiungi dei tag al criterio e clicca su Avanti: Rivedi.
Assegna un nome e una descrizione al criterio.
Clicca su Crea criterio.
Nella precedente scheda AWS in cui stavi creando un nuovo ruolo cross-account, clicca sul pulsante Aggiorna e cerca il nome del criterio appena creato.
Seleziona il criterio e clicca su Avanti: Tag.
Aggiungi i tag IAM al ruolo se lo desideri, quindi clicca su Avanti: Rivedi.
Dai al ruolo un nome e una descrizione e clicca su Crea ruolo.

Registrare un ruolo cross-account nel Centro dati

Clicca sul nome del ruolo per accedere alla sua pagina di riepilogo.
Copia la stringa accanto a "Role ARN".
Torna alla tua scheda Lucid e scorri verso il basso fino alla sezione "Add the Cross-Account Role to Lucidscale" della pagina New AWS Account.
Incolla la stringa nel campo "Role ARN", personalizza il campo "Credential display name" se lo desideri e fai clic su Next (Avanti ) per registrare il ruolo cross-account.
- Il nuovo ruolo verrà quindi visualizzato nella pagina Nuovo account AWS con il "Nome del ruolo" utilizzato.
- Il ruolo di cross-account sarà visualizzato anche nella sezione "AWS: Credenziali salvate" del Data Hub.
Seleziona il ruolo e clicca su Avanti.

Importazionedi conti e creazione di modelli

Seleziona il conto(s) che vuoi importare nel Data Hub per generare un modello Lucidscale.
Clicca su Avanti.
- Utilizzando le istruzioni dettagliate in Configurazione dell'account utilizzando un ruolo tra account, è possibile specificare le aree che si desidera importare e omettere i tipi di risorse o i metadati selezionati dall'importazione deselezionandoli. I tipi di risorse e i metadati deselezionati non verranno importati o sottoposti a rendering in un modello creato dall'account.
Clicca su Importa Account AWS.

Per trovare il tuo account AWS al termine dell'importazione:

Clicca + Nuovo
Passa il cursore su Lucidscale e seleziona AWS.
Seleziona Crea un nuovo modello.
Esamina i dettagli e aggiungi dei filtri per escludere le risorse non necessarie.
Seleziona Crea modello AWS.

Il modello Lucidscale verrà generato in background del tuo account Lucid. Ti avviseremo una volta che è stato creato tramite la finestra modale di stato che appare in basso a destra della pagina.

Puoi aprire il modello dalla maschera di stato che viene visualizzata direttamente dopo la creazione di un nuovo modello. Il modello (e i modelli precedentemente creati) e saranno memorizzati e accessibili nella sezione "Documenti" della tua Home Page Lucid dopo averlo generato.

Ulteriori informazioni: Per scoprire come lavorare con l'architettura AWS in un modello Lucidscale una volta creato, leggi il nostro articolo.

Autorizzazione monouso

Per importare l'infrastruttura AWS tramite le credenziali utente IAM, segui i seguenti passaggi:

Vai alla home page di Lucid.
Fare clic su Centro dati nella parte inferiore del menu di navigazione sul lato sinistro della pagina.
Seleziona Importa dati AWS.
Seleziona Autorizzazione monouso.
Nella console AWS IAM, crea una policy personalizzata utilizzando le autorizzazioni incluse.
Accedi a un utente IAM esistente o appena creato, quindi fai clic su "Aggiungi autorizzazioni" e "Allega direttamente policy esistenti" per aggiungere la policy personalizzata che hai creato.
Per ottenere il miglior supporto delle risorse, puoi anche collegare la policy ReadOnlyAccess gestita da AWS all'utente IAM selezionato. A tale scopo, cercare e selezionare ReadOnlyAccess nella pagina "Aggiungi autorizzazioni".
Nella scheda "Credenziali di sicurezza" dell'utente IAM, fai clic su "Crea chiave di accesso" per generare credenziali o un file CSV.
Torna alla scheda Lucid e scegli di caricare il file CSV o inserisci le credenziali generate.
Fare clic su Avanti.
È possibile specificare le regioni che si desidera importare e omettere i tipi di risorse o i metadati scelti dall'importazione deselezionandoli. I tipi di risorse e i metadati deselezionati non verranno importati o inclusi in un modello creato dall'account.
Fare clic su Fine.

Ulteriori informazioni: Per scoprire come lavorare con l'architettura AWS in un modello Lucidscale una volta creato, leggi il nostro articolo.

Nota di sicurezza: Lucid non memorizzerà le tue credenziali AWS IAM dopo aver eseguito la scansione iniziale della tua infrastruttura AWS. Le tue credenziali saranno trasferite ai nostri server utilizzando metodi di crittografia standard. I client possono negoziare protocolli di crittografia fino a AES-256. Se preferisci evitare di inserire le credenziali ogni volta che desideri aggiornare i tuoi dati, Lucid può memorizzare un ruolo cross-account che ci dà solo l'accesso "descrivi ed elenca" al tuo ambiente (dettagliato nella sezione precedente).

Creare un utente IAM

Affinché Lucidscale possa accedere alla tua infrastruttura AWS, devi fornire a Lucidscale le credenziali di un nuovo utente IAM. Per le istruzioni su come crearli nella tua console AWS, vedi sotto.

Per creare un utente IAM con un criterio in linea per l'importazione AWS di Lucidscale, segui i seguenti passaggi:

Apri la console AWS.
Vai alla sezione Utenti di Identity Access and Management (IAM).
Clicca su Aggiungi utenti e inserisci un nome per l'utente.
- Seleziona la casella accanto a "Chiave di accesso - Accesso programmatico" in modo che Lucidscale possa utilizzare la chiave di accesso per recuperare le informazioni sulla tua infrastruttura.
Clicca su Avanti: Permessi.
Seleziona Allega direttamente le politiche esistenti.
Clicca su Crea un criterio e passa alla finestra JSON nella scheda del browser appena aperta.
Nella sezione Conti importati di Lucid Data Hub, clicca su + Nuovo conto.
Seleziona Utente IAM dall'elenco dei metodi di importazione.
Clicca su Avanti.
Copia il file json dei criteri dalla modale.
Incolla il file json del criterio nella finestra JSON nella pagina "Crea criterio" di AWS.
Clicca su Avanti: Tag.
Aggiungi i tag IAM al ruolo se lo desideri, quindi clicca su Avanti: Recensione.
Assegna un nome e una descrizione al criterio.
Clicca su Crea criterio.
Nella precedente scheda del browser della console IAM in cui hai iniziato a creare un nuovo utente, clicca sul pulsante di aggiornamento e poi cerca il nome del criterio che hai appena creato.
Seleziona il criterio e clicca su Avanti: Tag.
Aggiungi i tag IAM al tuo utente se lo desideri, quindi clicca su Avanti: Recensione.
Controlla i dettagli dell'utente e clicca su Crea utente.
Clicca su Download .csv per memorizzare l'ID della chiave d'accesso e la chiave d'accesso segreta, e copia/incolla questi dati o carica il csv in Lucidscale.
Clicca su Avanti.
- È possibile specificare le regioni che si desidera importare e omettere i tipi di risorse o i metadati scelti dall'importazione deselezionandoli. I tipi dirisorse e i metadati deselezionati non verranno importati o inclusi nel modello creato dall'account.
Specifica un nome alias per il tuo account e clicca su Importa account AWS.
- Al termine dell'importazione, l'account sarà elencato come account AWS "importato" nella maschera dopo aver fatto clic su + New > Lucidscale > AWS.
- L'account verrà visualizzato anche nella sezione "AWS: Account importati" sezione dell'hub dati.
Seleziona Crea un nuovo modello.
Esamina i dettagli del tuo modello e aggiungi dei Filtri per escludere le risorse non necessarie.
Seleziona Crea un modello AWS.

Il modello Lucidscale verrà generato in background del tuo account Lucid. Ti avviseremo una volta completata la questione tramite la finestra modale di stato che appare in basso a destra della pagina.

Ulteriori informazioni: Per scoprire come lavorare con l'architettura AWS in un modello Lucidscale una volta completato, leggi il nostro articolo.

Caricamento file

Per importare l'infrastruttura AWS tramite CLI, segui i seguenti passaggi:

Vai alla home page di Lucid.
Fare clic su Centro dati nella parte inferiore del menu di navigazione sul lato sinistro della pagina.
Seleziona Importa dati AWS.
Seleziona Caricamento file.
Copia ed esegui lo script fornito utilizzando l'interfaccia della riga di comando del terminale per generare un file JSON.
- Per istruzioni dettagliate, fare riferimento alle istruzioni per lo script CLI riportate di seguito.
Carica il JSON risultante su Lucidscale, quindi fai clic su Avanti.
Assegna un nome all'account che stai importando, quindi fai clic su Avanti.
- L'account verrà elencato come account AWS importato nella finestra modale dopo aver fatto clic su + Nuovo > Lucidscale > AWS.
- L'account verrà visualizzato anche nella sezione "AWS: Account importati" del Centro dati.
Seleziona Crea un nuovo modello.
Rivedi i dettagli e aggiungi ifiltri da escludere risorse inutili.
Seleziona Crea modello AWS.

Il modello Lucidscale verrà generato in background del tuo account Lucid. Ti avviseremo una volta che è stato creato tramite la finestra modale di stato che appare in basso a destra della pagina.

È possibile aprire il modello dalla finestra modale di stato che appare subito dopo la creazione di un nuovo modello. Il modello (e i modelli creati in precedenza) saranno anche memorizzati e accessibili nella sezione Documenti della tua Home Page Lucid dopo averlo generato.

Ulteriori informazioni: Per scoprire come lavorare con l'architettura AWS in un modello Lucidscale una volta creato, leggi il nostro articolo.

Istruzioni per lo script CLI

Installare Python 3.0-3.9.
Installa la CLI di AWS.
Esegui pip3 install botocore==1.27.77.
Configura l'interfaccia a riga di comando di AWS (le istruzioni di AWS sono disponibili qui).
Esegui python3 awscliscript.py --profile "nome profilo" --regions us-east-1 us-west-1 che produrrà un file aws.json.
Clicca su + Nuovo.
Passa il cursore su Lucidscale e seleziona AWS.
Scegli di importare un account esistente
- È inoltre possibile fare clic su Apri Centro dati, Importa dati AWS e selezionare AWS CLI Script.
Carica il file aws.json in Lucidscale e clicca su Next.
Dai un nome all'account che stai importando, quindi clicca su Avanti.
- L'account sarà elencato come account importato AWS nel modale dopo aver fatto clic su + New > Lucidscale > AWS.
- L'account verrà visualizzato anche nella sezione "AWS: Account importati" sezione del Data Hub.
Seleziona Crea un nuovo modello.

Il modello Lucidscale verrà generato in background del tuo account Lucid. Ti avviseremo una volta completato tramite la finestra modale di stato che appare in basso a destra della pagina.

Istruzioni dettagliate per lo script CLI

Installa Python 3.0-3.9 (le istruzioni sono disponibili qui). Assicurati di selezionare l'opzione Aggiungi Python al PATH nel programma di installazione.
Installa l'interfaccia a riga di comando di AWS (le istruzioni di AWS sono disponibili qui).
- Usa il pannello di sinistra per fare clic su istruzioni come Installare l'AWS CLI e Configurare l'AWS CLI.
Installa botocore versione 1.27.77 con pip3 eseguendo pip3 install botocore==1.27.77.
- Lucidscale - AWS è stato sviluppato a partire dalla versione 1.27.77 di botocore, tuttavia, se hai già installato una versione diversa, l'importazione dovrebbe comunque funzionare. In caso contrario, prendi in considerazione l'esecuzione dello script in un ambiente virtuale python che ti consente di gestire installazioni di pacchetti separate per progetti diversi. Dopo aver eseguito lo script, è possibile eliminare l'ambiente virtuale. Le istruzioni per la creazione di un ambiente virtuale Python sono disponibili qui.
Configura l'interfaccia a riga di comando di AWS (le istruzioni di AWS sono disponibili qui).
- Un profilo denominato è una raccolta di impostazioni e credenziali che puoi applicare a un comando AWS CLI.
- L'esecuzione di aws configure memorizzerà le credenziali inserite nel profilo denominato default. Se hai più account, ti consigliamo di creare dei profili denominati per ciascuno di essi. Ad esempio, se ho due account, preprod e prod e memorizzo le loro credenziali come due profili separati, allora posso facilmente descrivere le istanze ec2 in preprod facendo aws ec2 describe-instances -- profile preprod. Tpoi, per descrivere le istanze in prod posso cambiare l'argomento profilo in 54 aws ec2 describe-instances -- profile prod.
- Le istruzioni per la configurazione dei profili nominativi da AWS sono disponibili qui.
- Lo script Lucidscale - AWS ti chiederà di fornire il nome del profilo o dei profili che vuoi importare.
Esegui lo script Lucidscale - AWS
1. -c o --count
  - Emette un file JSON con i dettagli sul numero di risorse. L'esecuzione dello script con questo flag comporta un percorso diverso per lo script di importazione e non produce un file JSON che può essere caricato su Lucidscale - AWS.
2. -a o --anon
  - Anonimizzare i dati (hashish di tutte le stringhe)
3. -o o --output
  - Invia i dati al nome del file fornito
4. -p o --profilo
  - Il nome del profilo da utilizzare
5. -r o --regioni
  - Le regioni da importare
    - (esempio) python3 awscliscript.py --profile preprod --regions us-east-1 us-west-1
    - Il comando precedente esegue lo script e genera i dati per le risorse del profilo preprod che vivono nelle regioni us-east-1 e us-west-1
    - Lo script Lucidscale - AWS dispone di ulteriori flag che possono essere utilizzati
6. Verrà generato un aws.json come output. Carica questo file in Lucidscale per importare la tua infrastruttura in Lucid Data Hub.
  - L'account sarà elencato come account importato AWS nel modale dopo aver fatto clic su + New > Lucidscale > AWS.
  - L'account verrà visualizzato anche nella sezione "AWS: Account importati" sezione del Data Hub.
7. Seleziona Crea modello.

Il modello Lucidscale verrà generato in background del tuo account Lucid. Ti avviseremo una volta completata l'operazione tramite una finestra modale di stato che appare in basso a destra della pagina.

È possibile aprire il modello dalla finestra modale di stato che appare subito dopo la creazione di un nuovo modello. Il modello (e i modelli creati in precedenza) saranno anche memorizzati e accessibili nella sezione Documenti della tua Home Page Lucid dopo averlo generato.

Ulteriori informazioni: Per scoprire come lavorare con l'architettura AWS in un modello Lucidscale una volta completato, leggi il nostro articolo.

Nota:

Utenti Windows: utilizzare "Windows CMD" per eseguire i comandi dello script.
Utenti MacOS: utilizzare il terminale

Usa Data Hub per gestire i dati e le credenziali dell'infrastruttura AWS.

Accesso agli account importati

Dopo aver importato l'account AWS, sarà elencato come origine dati con il nome dell'account specificato nella sezione " AWS: Account importati" sezione di Data Hub. Da questa sezione puoi anche cliccare su + Nuovo account per importare un nuovo account nel Data Hub .

I conti elencati in questa sezione sono fonti di dati che possono essere utilizzate per creare nuovi modelli Lucidscale. Le fonti di dati ("Account") contengono i metadati dell'account AWS utilizzati per creare i modelli Lucidscale. Il campo "Ultimo aggiornamento" indica quando l'origine dati è stata aggiornata l'ultima volta per tenere conto di eventuali aggiornamenti nell'account AWS collegato.

L'Inventario Cloud di ogni account può essere visualizzato sul lato destro dopo aver selezionato un account dall'elenco. Questo inventario ti permette di vedere il conteggio completo di ogni tipo di risorsa importata prima di creare un modello. Puoi anche scaricare un CSV con l'elenco delle risorse e il conteggio direttamente dal Data Hub cliccando su Download CSV.

L'inventario elenca tutte le risorse a cui è possibile accedere tramite la policy di autorizzazione collegata al ruolo tra account. Se scegli di utilizzare l'opzione "Crea un nuovo ruolo automaticamente" con il nostro modello CloudFormation Stack, tutte le risorse del tuo account accessibili tramite la policy ReadOnlyAccess di AWS verranno visualizzate nell'inventario. Se si crea manualmente un ruolo con una policy personalizzata, nell'inventario verrà eseguito il rendering solo dei tipi di risorse specificati nella policy di autorizzazione collegata.

Clicca sul menua tre puntinireso su un account per vedere sei opzioni potenziali: Crea nuovo modello, Aggiorna account da AWS, Pianifica aggiornamento, Modifica risorse, Rinomina account ed Elimina account.

Crea nuovo modello inizierà il rendering dell'infrastruttura AWS associata all'account come diagramma nell'area di lavoro di un nuovo modello. Il modello verrà generato sullo sfondo della tua Home Page Lucid e ti avviseremo una volta terminato il rendering attraverso il modale di stato che appare in basso a destra della pagina.

Aggiorna account da AWS e Aggiornamento programmato ti permette di aggiornare manualmente o automaticamentei dati dell'account AWS che hai importato nel Data Hub per riflettere le modifiche dell'account AWS collegato. I nuovi modelli creati dall'account dopo l'aggiornamento rifletteranno le modifiche dell'account AWS collegato.

Per saperne di più: Per maggiori informazioni sull'aggiornamento degli account da AWS, consulta il nostro articolo Aggiornare e sincronizzare i dati in Lucidscale .

Modifica risorse ti permette di modificare le risorse incluse in ogni set di dati. Seleziona questa opzione per aprire una modale in cui potrai aggiungere o rimuovere qualsiasi risorsa dai tuoi set di dati esistenti. Una volta terminata la selezione, clicca su Salva e aggiorna l'account. In questo modo il set di dati si aggiorna e i modelli che fanno riferimento a quel set di dati vengono aggiornati con le informazioni più recenti.

Rinomina Account ti permette di cambiare il nome del dataset selezionato.

Delete Account rimuove l'account importato da Lucid Data Hub e tutti i modelli creati da quell'account perderanno la capacità di aggiornare i dati da AWS.

Nota: Le opzioni visualizzate sopra variano a seconda del metodo di importazione utilizzato per un account. L'opzione update è disponibile solo con l'importazione di ruoli AWS cross-account. Le importazioni IAM e CLI non supportano questa opzione.

Condividi e cancella le credenziali salvate

La sezione Credenziali salvate in "Data Hub > AWS" lè un elenco dei ruoli di cross-account che puoi utilizzare per importare i tuoi account AWS in Data Hub. Da questa sezione, clicca su + Nuovo ruolo cross-account per aggiungere un nuovo set di credenziali da utilizzare per importare un account AWS.

Puoi anche condividere con altri utenti i ruoli di account incrociati che hai creato. Se fai clic sul menu a tre puntini reso su un account, vedrai due potenziali opzioni: Condividi la credenziale e Elimina la credenziale.

esempio_di_pagina_aws_saved_credenziali_nel_lucidscale_data_hub.png

Condividi la credenziale apre una maschera in cui puoi condividere un ruolo di cross-account con un altro utente del tuo account Lucid specificando il suo indirizzo e-mail. Concedendo loro l'accesso alla credenziale, potranno importare l'account AWS associato nel Data Hub e creare modelli Lucidscale. Dopo che una credenziale è stata condivisa con un altro utente, puoi revocargli l'accesso alla credenziale facendo clic su X accanto al suo indirizzo e-mail nella stessa maschera.

Elimina la credenziale rimuove il ruolo cross-account dal Data Hub . Dopo aver eliminato una credenziale, tutti gli account precedentemente importati con quella credenziale e i modelli creati da quegli account perderanno la possibilità di aggiornare i dati da AWS.

Per saperne di più: Puoi condividere le credenziali solo nel Data Hub di cui sei proprietario. Solo gli utenti di Lucidscale a cui è stata assegnata una licenza Creator possono importare account e creare modelli. Per maggiori dettagli consulta il nostro articolo Gestione, utilizzo e sicurezza delle credenziali in Lucidscale .

Informazioni sulla sicurezza

Ruoli trasversali

I ruoli cross-account sono il metodo preferito da AWS per concedere a terzi l'accesso al tuo account. Questo metodo consente a Lucidscale di memorizzare in modo sicuro le credenziali che ti permettono di aggiornare facilmente un diagramma. Per maggiori informazioni, consulta queste risorse:

ID esterno forzato

Seguendo le migliori pratiche di sicurezza fornite da AWS, Lucid fa in modo che gli ID esterni rimangano unici nel database di Lucid. Pertanto, Lucid fornisce all'utente un ID esterno univoco e impedisce all'utente di inserire il proprio ID esterno.

Accesso sicuro e limitato per gli utenti IAM

Richiediamo un'autorizzazione limitata, di livello "descrittivo", per l'utente IAM creato. Un utente IAM creato con queste autorizzazioni non può modificare le impostazioni della tua infrastruttura AWS o leggere i dati nei tuoi database. Utilizziamo l'utente IAM solo per leggere i metadati strutturali della tua infrastruttura AWS.

Alternativa di script CLI

Se desideri rivedere e controllare le azioni che compiamo durante la scansione dell'infrastruttura AWS, puoi scaricare e utilizzare il nostro script Python fornito invece di creare un utente IAM. In questo scenario, le tue credenziali IAM non verranno mai passate a Lucidscale e potrai esaminare sia il codice che verrà eseguito nel tuo ambiente sia i metadati risultanti prima di caricarli su Lucidscale. Il JSON importato sarà accessibile nel Lucid Data Hub e potrà essere utilizzato per creare modelli Lucidscale.

Archiviazione sicura dei documenti (modelli)

Lucidscale archivia i metadati importati da AWS e i modelli generati utilizzando le protezioni standard del settore per i dati riservati. I dati AWS importati sono incorporati come parte del modello Lucidscale, in modo da poter controllare l'accesso ai dati utilizzando le autorizzazioni di condivisione standard di Lucid. Per ulteriori informazioni su come proteggiamo i tuoi documenti, consulta la nostra pagina sulla sicurezza dei contenuti o contatta il nostro team di vendita.

Nessuna memorizzazione delle chiavi di accesso

Lucidscale non memorizzerà le tue credenziali AWS IAM dopo aver eseguito la scansione iniziale della tua infrastruttura AWS. Le tue credenziali saranno trasferite ai nostri server utilizzando metodi di crittografia standard. I client possono negoziare protocolli di crittografia fino a AES-256. Possiamo memorizzare un Ruolo Cross-Account che ci permette di accedere solo a "descrivere ed elencare" il tuo ambiente.

FAQ

Una volta acquistato Lucidscale, tutti gli utenti dell'account avranno accesso?

Se sei un cliente Lucid esistente (hai un abbonamento a Lucidchart o Lucidspark), a seconda delle impostazioni delle licenze è possibile che non tutti gli utenti dell'account abbiano accesso a Lucidscale per impostazione predefinita. L'amministratore dell'account potrebbe dover assegnare le licenze Lucidscale acquistate a singoli utenti o gruppi attraverso la sezione Utenti del pannello di amministrazione, come avviene per Lucidchart e Lucidspark. Agli utenti aggiunti a un account che ha solo un abbonamento Lucidscale Team (senza abbonamenti Lucidchart o Lucidspark) verrà assegnata automaticamente una licenza Creator o Explorer, a seconda delle licenze acquistate. Per istruzioni su come assegnare le licenze, consulta l'articolo Lucid admin panel: Impostazioni delle licenze .

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

Il metodo raccomandato da Lucidscale e AWS è quello di utilizzare un Ruolo Cross-Account. Ti forniamo un criterio che ci consente di accedere al tuo ambiente "descrivendo ed elencando" in modo da ottenere un inventario delle risorse. Le credenziali memorizzate in Lucid possono essere accessibili solo dal tuo account Lucid. Questo metodo di importazione ti permetterà di aggiornare i dati dell'account con un'unica azione. I criteri di autorizzazione che forniamo ti permettono di determinare esattamente quali dati il ruolo Cross-Account avrà accesso per richiedere ad AWS.

Se utilizzi il nostro metodo IAM, le credenziali non vengono memorizzate, ma vengono utilizzate una volta e poi scartate. Generalmente i nostri utenti utilizzano questo metodo di importazione insieme alle credenziali temporanee di AWS, in quanto questo metodo non consente di aggiornare ulteriormente i dati.

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. Dopo aver generato il file JSON, gli utenti possono rivederne il contenuto e rimuovere i dati prima dell'importazione. Gli utenti possono quindi caricare questo file JSON su Lucidscale e non inserire alcuna informazione sulle credenziali in Lucidscale.

Come interagiscono Lucidscale commercial e Lucidscale for Gov quando si importa tramite ruoli incrociati?

Sebbene le funzionalità del prodotto siano le stesse, AWS imposta la sicurezza in modo diverso per questi due ambienti. I ruoli IAM di AWS e le policy basate sulle risorse delegano l'accesso agli account solo all'interno di una singola partizione. Lucid GovSuite si trova in una partizione AWS separata e quindi non può importare i dati AWS tramite il ruolo cross-account da account AWS non GovCloud. I ruoli di cross-account, il nostro metodo di importazione consigliato, consentono l'accesso solo agli account dello stesso tipo: se sei nell'ambiente commerciale Lucid puoi accedere e importare gli account commerciali del cloud AWS tramite il ruolo di cross-account, mentre se sei nell'ambiente Lucid GovSuite puoi accedere e importare gli account AWS GovCloud tramite il ruolo di cross-account.

Supportiamo la possibilità di importare account AWS commerciali in Lucidscale for Gov tramite utente IAM o un JSON creato dal nostro script CLI.

A quali API accede Lucidscale?

Utilizziamo principalmente gli endpoint API describe e list.

Puoi 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 descrittiva vengono importati.

Lascia un feedback su questo articolo

Hai commenti su questo articolo? Raccontaci la tua esperienza qui.

Articoli correlati