Use Lucidscale para importar dados de infraestrutura de nuvem da AWS e gerar diagramas em um modelo Lucidscale.

Para saber mais sobre a funcionalidade disponível com o Lucidscale, consulte nosso artigoPlanos do Lucidscale.

Regiões, recursos e linhas com suporte

Você pode importar contas da AWS hospedadas em qualquer uma das seguintes regiões da AWS:

ap-northeast-1
ap-northeast-2
ap-northeast-3
ap-south-1
ap-southeast-1
ap-southeast-2
ca-central-1
eu-central-1
eu-north-1
eu-west-1
eu-west-2
eu-west-3
sa-east-1
us-east-1
us-east-2
us-west-1
us-west-2

Lucidscale oferece suporte aos seguintes recursos da AWS:

ALB (Load Balancers v2, Target Groups, Target Health Description)
API Gateway (v1, v2)
AWS Managed Streaming for Kafka
Autoscaling (Groups, Launch Configurations)
CloudFront (Distributions)
CloudTrail
Curated data for Transit Gateway Routes and NACLS
Customer Gateway
DocumentDB
DynamoDB (Tables)
EC2 (Instances, NAT Gateways, Network ACLs, Route Tables, Security Groups, Subnets, Transit Gateway, Volumes, VPC Endpoints, VPC Peering Connections, VPCs, VPN Gateways)
ECS: This is located in a designated view called “ECS View”. The current functionality will provide a view of the clusters, services and tasks running in your environment. It also splits clusters into EC2 and Fargate containers.
EFS File System
EKS clusters
Elasticache
Elastic Network Interface
Elastisearch
ELBs (Load Balancers)
EMR
Glacier
Kinesis Data Streams
Kinesis Firehose
Lambda (Functions)
Network Firewalls
RDS (Clusters, Instances)
Redshift (Clusters)
Route 53
S3 (Buckets - Additional Metadata: roles, groups, etc.)
SNS (Topics, met)
SQS (Queues)
Step Functions
Transit Gateway Routes Metadata

O Lucidscale pode traçar linhas entre os recursos que fazem referência explícita a outro nos metadados:

Elastic Load Balancers (ELBs) to Auto Scaling Groups (ASGs) [ELB→ ASG]
ELBs to EC2 instances [ELB → EC2]
CloudFront Distributions to S3 Buckets [CloudFront → S3]
Application Load Balancers (ALBs) to EC2 [ALB → EC2]
VPC Peering Connections
Route 53 Hosted Zones to ELBs, S3 Buckets and CloudFront Distributions [Route 53 Hosted Zones → ELBs, S3, CloudFront]
SNS Topic to SQS Queue [SNS → SQS]
SQS Queue to Lambda Function [SQS → Lamba]
Transit Gateway to Peered Transit Gateway and Virtual Private Cloud (VPC) attachments [Transit Gateways → Transit Gateways, VPCs]
Route Table to Internet Gateways and NAT Gateways [Route table → Internet Gateways, NAT Gateways]
API Gateway to Lambda [API Gateway → Lambda]
VPN Connections via Transit gateway [Transit Gateway → VPN Connection → Customer Gateway]
VPN Connections via VPN gateway [VPN Gateway → VPN Connection → Customer Gateway]
HostedZones → ALBs

Nota: Se você optou por resumir os recursos dentro de uma visualização Lucidscale, você precisa desresumi-los para que as linhas sejam renderizadas no modelo.

Importar infraestrutura da AWS

Você pode importar seus dados de infraestrutura de nuvem da AWS usando um dos quatro métodos a seguir:

Acesso confiável: forneça uma função de IAM entre contas com as políticas adequadas. Isto é composto por duas opções:
- Importar dados de contas individuais
- Gerencie centralmente as importações de todas as contas da sua organização
Autorização de uso único: insira credenciais para um usuário do IAM com políticas adequadas anexadas
Upload de arquivo: execute um script CLI na sua máquina AWS, que extrai os dados localmente e, em seguida, fornece o arquivo JSON gerado

Confira a tabela a seguir para obter detalhes sobre cada método e determinar qual é o melhor para seu caso de uso.

Tipos de importação	Descrição	Escopo	Suporte de recursos	Atualização de dados
Acesso confiável em nível de organização	Registre uma função de IAM entre contas em nível de organização com o Lucid para reutilização segura e de longo prazo.	Gerencie centralmente as importações de todas as contas dentro de uma organização da AWS registrando uma única credencial.	(1) Todos os recursos suportados listados neste artigo. (2) Inventário de Nuvem: uma ampla variedade de recursos não mapeados que você pode colocar manualmente em seus modelos.	Atualize automaticamente de acordo com uma programação personalizada OU atualize manualmente com um único clique. Lucid salva essas credenciais para que você possa atualizar seus dados ou iniciar novas importações sem precisar inserir suas informações novamente.
Acesso confiável em nível de conta	Registre uma função de IAM entre contas no nível da conta com o Lucid para reutilização segura e de longo prazo.	Registre uma credencial para cada conta individual da AWS.	(1) Todos os recursos suportados listados neste artigo. (2) Inventário de Nuvem: uma ampla variedade de recursos não mapeados que você pode colocar manualmente em seus modelos.	Atualize automaticamente de acordo com uma programação personalizada OU atualize manualmente com um único clique. Lucid salva essas credenciais para que você possa atualizar seus dados ou iniciar novas importações sem precisar inserir suas informações novamente.
Autorização de uso único	Carregue uma chave de usuário do IAM ou um arquivo de credenciais para o Lucid.	Acesso único a uma conta individual da AWS.	(1) Todos os recursos suportados listados neste artigo. (2) Inventário de Nuvem: uma ampla variedade de recursos não mapeados que você pode colocar manualmente em seus modelos.	Atualize os dados inserindo novamente os detalhes das credenciais. O Lucid não armazena credenciais de usuário do IAM para reutilização futura.
Carregamento de arquivo	Execute um script CLI na sua máquina AWS para extrair dados localmente e, em seguida, carregue o arquivo JSON gerado no Lucid.	Até 5 contas por arquivo JSON.	Limitado aos recursos suportados listados neste artigo.	Substitua os dados carregando um arquivo JSON recém-gerado.

Se você estiver trabalhando com um ambiente muito grande, use as informações na seção Configuração da conta deste artigo ao usar funções entre contas para ajudar a reduzir a quantidade de dados que você está importando ou reduzir o número de chamadas de API que o Lucid faz para a AWS. O Lucid suporta até 50 importações simultâneas. Após a conclusão de cada importação, você pode iniciar uma nova importação.

Para importar e visualizar a infraestrutura da AWS em um modelo Lucidscale, siga estas etapas:

Navegue até a página inicial da Lucid.
Clique em Central de dados na parte inferior do menu de navegação no lado esquerdo da página.
Clique em Importar dados da AWS e escolha um método de importação.
- Após escolher um método de importação e concluir a importação, a conta será listada como uma fonte de dados na seção "AWS: Contas importadas" do Data Central.
Clique no menu de três pontos ao lado da conta da qual você deseja criar um modelo.
Selecione Criar novo modelo.
Revise os detalhes e adicionefiltros para excluir recursos desnecessários.
Selecione Criar modelo da AWS.

O modelo Lucidscale será gerado em segundo plano na sua conta do Lucid. Nós o notificaremos assim que o processo for concluído por meio do modal de status que aparece no canto inferior direito da página.

Você pode abrir o modelo a partir do modal de status que aparece logo após a criação de um novo modelo. O modelo(e os modelos criados anteriormente)também serão armazenados e acessíveis na seção "documento" da sua página inicial do Lucid após a geração.

modal_confirming_successful_creation_of_aws_lucidscale_model.png

Saiba mais: para saber como trabalhar com a arquitetura da AWS em um modelo Lucidscale depois que ele for criado, leia nosso artigo.

Acesso confiável em nível de organização

Para gerenciar centralmente as importações de infraestrutura em toda a sua organização da AWS, siga as etapas abaixo.

Observação: se você estiver no ambiente Lucid GovSuite, só poderá importar contas do AWS GovCloud por meio da função entre contas. O ambiente comercial do Lucid não pode acessar contas AWS GovCloud por meio de funções entre contas. Consulte a seção de perguntas frequentes abaixo para obter mais detalhes.

Registre uma nova função de IAM entre contas no Lucid para gerenciar importações no nível da organização:

Navegue até a página inicial da Lucid.
Clique em Central de dados na parte inferior do menu de navegação no lado esquerdo da página.
Selecione Importar dados da AWS.
Selecione Acesso confiável.
No escopo da credencial, escolha “Conectar a uma organização da AWS”.
Escolha entre as opções para configurar permissões automaticamente:
- Use um módulo Terraform
- Use modelos do CloudFormation

selecione-CloudFormation-ou-terraform-método-para-criar-função

Para configurar permissões automaticamente com o Terraform, siga estas etapas:

Acesse o módulo Terraform do Lucid para configurar permissões clicando em Exibir no Registro do Terraform ou acesse o módulo diretamente com este link.
Na página de registro do módulo, clique em Submódulos para acessar cada um dos três submódulos necessários em sequência.
Siga as instruções de “Uso” na página Leia-me de cada submódulo para adicionar o módulo ao seu código de configuração do Terraform.
- Os submódulos bastion-role e import-role exigem um valor external_id. Obtenha o valor para este ID externo retornando à sua guia Lucid e clicando em Copiar ao lado do ID externo fornecido.
- O submódulo org-read-delegation inclui um parâmetro account_id opcional. Se nenhum valor for fornecido para este parâmetro, o módulo Terraform criará uma nova “conta bastião” para coordenar as importações com o Lucid.
- Conforme escrito, o submódulo org-read-delegation implanta uma ResourcePolicy que delega permissões à função bastion para escanear a estrutura da sua organização. Se você já tiver criado uma ResourcePolicy para sua organização, a implantação falhará. Em vez disso, adicione a política JSON vinculada aqui à sua ResourcePolicy existente.
Implante seu código Terraform e aguarde a criação dos recursos incluídos no módulo do Lucid.
Acesse a seção IAM do seu console da AWS para a conta Bastion escolhida e localize a função entre contas que foi criada.
Clique no nome da função para navegar até a página de resumo da função.
Copie a string ao lado de “Role ARN”.
Retorne à sua guia Lucid e role para baixo até a seção “Adicionar a função de conta cruzada ao Lucid”. Insira o ARN da função no campo “Bastion role ARN” do formulário fornecido.
Se você personalizou o parâmetro MemberRoleName ao configurar seu código Terraform, atualize esse valor no formulário também.
Se desejar, atualize o valor pré-preenchido para “Nome de exibição da credencial” para a função bastião usada para coordenar as importações. Este nome de exibição será usado no Data Central do Lucidpara que você possa localizar a credencial para uso e gerenciamento futuros.
Clique em Avançar para registrar a função entre contas com o Lucid.
Selecione a função e clique em Avançar.
Prossiga com as etapas para importar contas e criar modelos.

Para configurar permissões automaticamente com o CloudFormation, siga estas etapas:

Identifique a conta na sua organização que você gostaria de usar para gerenciar o acesso confiável de terceiros. A Lucid assumirá uma função de várias contas nesta “conta bastião” para coordenar as importações.
Inicie os primeiros Modelos CloudFormation fornecidos no seu console da AWS. Você usará esses Modelos para configurar permissões de importação para a conta Bastion e para cada uma das suas contas de membro.
Na página “Criar pilha” no seu console da AWS, insira valores para cada um dos parâmetros necessários.
- O parâmetro MembersRootOrOrganizationalUnitId controla o escopo de contas na sua organização que Lucid poderá importar. Para permitir a importação de dados de recursos para todas as contas da sua organização, insira o ID da raiz da sua organização. Se você deseja permitir importações apenas para contas aninhadas em uma única UO, insira o ID dessa UO.
Clique em Criar pilha e aguarde a conclusão da implantação.
Retorne ao seu guia Lucid e inicie o segundo CloudFormation Modelos fornecido. Você usará esses Modelos para permitir que a função Bastion identifique contas para importação, escaneando a estrutura da sua organização.
Este Modelos implanta uma ResourcePolicy que delega permissões à função bastion para escanear a estrutura da sua organização. Se você já tiver criado uma ResourcePolicy para sua organização, a criação desta pilha do CloudFormation falhará. Em vez disso, adicione a política JSON vinculada aqui à sua ResourcePolicy existente.
Acesse a seção IAM do seu console da AWS para a conta Bastion escolhida e localize a função entre contas que foi criada.
Clique no nome da função para navegar até a página de resumo da função.
Copie a string ao lado de “Role ARN”.
Retorne à sua guia Lucid e role para baixo até a seção “Adicionar a função de conta cruzada ao Lucid”. Insira o ARN da função no campo “Bastion role ARN” do formulário fornecido.
Se você personalizou o parâmetro MemberRoleName ao configurar os primeiros Modelos CloudFormation , atualize esse valor no formulário também.
Se desejar, atualize o valor pré-preenchido para “Nome de exibição da credencial” para a função bastião usada para coordenar as importações. Este nome de exibição será usado no Data Central do Lucidpara que você possa localizar a credencial para uso e gerenciamento futuros.
Clique em Avançar para registrar a função entre contas com o Lucid.
Selecione a função e clique em Avançar.
Prossiga com as etapas para importar contas e criar modelos.

Observação: esses modelos CloudFormation são configurados para usar conjuntos de pilhas com permissões gerenciadas pelo serviço. Atualmente, não oferecemos suporte à configuração do CloudFormation usando conjuntos de pilhas com permissões autogerenciadas.

Importar contas e criar modelos

Selecione a(s) conta(s) que deseja importar para o Data Central.
Clique em Avançar.
- Usando as instruções detalhadas no final desta seção em "Configuração da conta", você pode especificar as regiões que deseja importar e omitir os tipos de recursos ou metadados escolhidos da importação, desmarcando-os. Os tipos de recursos e metadados desmarcados não serão importados ou visualizados em um modelo criado a partir da conta.
Clique em Importar conta da AWS.

Para visualizar sua conta da AWS após a conclusão da importação:

Retorne ao Centro de Dados.
Selecione Criar novo modelo.
Selecione a conta que você importou e clique em Escolher contas.
Revise os detalhes e adicione filtros para excluir recursos desnecessários.
Selecione Criar modelo da AWS.

O modelo Lucidscale será gerado em segundo plano na sua conta do Lucid. Nós o notificaremos assim que ele for criado por meio de uma mensagem de status que aparecerá no canto inferior direito da página.

Você pode abrir o modelo a partir da mensagem de status que aparece logo após a criação de um novo modelo. O modelo (e modelos criados anteriormente) também serão armazenados e acessíveis na seção "documento" da sua página inicial do Lucid depois de gerá-lo.

Configuração de conta usando uma função entre contas

Ao importar uma conta da AWS para o Lucid Data Central usando uma função entre contas, você tem a opção de omitir tipos de recursos ou metadados escolhidos da importação. Isso lhe dá a capacidade de visualizar apenas os tipos de recursos nos quais você está interessado e, em alguns casos, pode aumentar a velocidade da importação. Os tipos de recursos e metadados desmarcados não serão importados ou visualizados em um diagrama.

configurar-recursos-inclusos-na-importação

Acesso confiável em nível de conta

Para importar a infraestrutura da AWS para contas individuais por meio de uma função do IAM entre contas e criar um modelo do Lucidscale, siga as etapas abaixo.

Para acesso confiável no nível da conta, você precisará criar uma função separada para cada nova conta da AWS que deseja importar. Você pode fazer isso selecionando Registrar uma nova credencial na página de importação "Acesso confiável".

Registre uma nova função de IAM entre contas no Lucid:

Navegue até a página inicial da Lucid.
Clique em Central de dados na parte inferior do menu de navegação no lado esquerdo da página.
Selecione Importar dados da AWS.
Selecione Acesso confiável.
No escopo da credencial, escolha “Conectar a contas individuais da AWS”.
Escolha entre as opções para registrar uma nova credencial:
- Use um modelo do CloudFormation
- Criar manualmente

opções-para-criar-uma-nova-função-para-aws-in-lucidscale.png

Para criar uma nova função automaticamente com CloudFormation, siga estas etapas:

Certifique-se de que “Incluir ReadOnlyAccess” esteja ativado.
- Esta configuração é habilitada por padrão e fornece o melhor suporte para importar recursos e visualizá-los em modelos Lucidscale.
Clique em Iniciar CloudFormation para abrir uma nova guia do navegador e fazer login em sua conta AWS. Deixe a guia do navegador Lucid aberta para poder retornar a ela mais tarde.
Clique em Criar pilha.
Após a pilha ter sido criada, navegue até a guia Recursos e selecione “LucidscaleImportRole”.
Pule para as etapas para registrar sua função entre contas no Lucidscale.

Para criar manualmente uma nova função no console AWS IAM, siga estas etapas:

Em “Etapa 1: Comece a criar uma função”, selecione Criar função.
- Você será direcionado para sua conta AWS. Deixe a guia do navegador Lucid aberta para poder retornar a ela mais tarde.
- A Lucidscale gerará automaticamente um ID externo exclusivo associado à sua conta Lucidscale. Isso está alinhado com as recomendações de segurança da AWS.
Na AWS, clique em Próximo: Permissões.
Na página “Adicionar permissões”, pesquise e selecione a política ReadOnlyAccess.
- Esta configuração é habilitada por padrão no Lucid e é necessária para que todos os recursos apareçam corretamente nos modelos Lucidscale criados.
Navegue de volta para a guia Lucid para "Etapa 2: Adicionar permissões personalizadas" e clique em Copiar permissões para copiar o arquivo de texto JSON.
Navegue de volta para a página “Criar função” na AWS e clique em Criar política. Você será direcionado para uma nova guia do navegador para criar a política.
Na página “Criar política”, alterne para a guia JSON e cole o arquivo que você copiou na guia JSON em seu console AWS.
Clique em Próximo: Tags.
Adicione tags à política, se desejar, e clique em Próximo: revisar.
Dê um nome e uma descrição à política.
Clique em Criar política.
Na guia AWS anterior, onde você estava criando uma nova função entre contas, clique no botão Atualizar e pesquise o nome da política que acabou de criar.
Selecione a política e clique em Próximo: Tags.
Adicione tags IAM à função, se desejar, e clique em Próximo: revisar.
Dê um nome e uma descrição à função e clique em Criar função.

Registre uma função entre contas no Data Central

Clique no nome da função para navegar até a página de resumo da função.
Copie a string ao lado de “Role ARN”.
Navegue de volta para a guia Lucid e role para baixo até a seção "Add the Cross-Account Role to Lucidscale" da página New AWS Account.
Cole a sequência de caracteres no campo “Role ARN”, personalize o campo “Credential display name” se desejar e clique em Next para registrar a função entre contas.
- A nova função será exibida na página Nova conta da AWS com o “Nome da função” que você usou.
- A função entre contas também será exibida na seção "AWS: Saved Credentials" do Data Hub.
Selecione a função e clique em Avançar.

Importe contas e crie modelos

Selecione a(s) conta(s) que deseja importar para o Data Hub para gerar um modelo Lucidscale.
Clique em Avançar.
- Seguindo as instruções detalhadas no final desta seção, em "Configuração da conta", você pode especificar as regiões que deseja importar e omitir os tipos de recursos ou metadados selecionados da importação, desmarcando-os. Os tipos de recursos e metadados desmarcados não serão importados ou renderizados em um modelo criado a partir da conta.
Clique em Importar conta da AWS.

Para encontrar sua conta AWS após a conclusão da importação:

Clique em + Novo
Passe o cursor sobre Lucidscale e selecione AWS.
Selecione Criar novo modelo.
Revise os detalhes e adicione filtros para excluir recursos desnecessários.
Selecione Criar modelo da AWS.

O modelo Lucidscale será gerado em segundo plano na sua conta Lucid. Iremos notificá-lo assim que for processado por meio do modal de status que aparece no canto inferior direito da página.

Você pode abrir o modelo a partir do modal de status que renderiza diretamente após a criação de um novo modelo. O modelo (e os modelos criados anteriormente)também serão armazenados e acessíveis na seção "Documentos" da página inicial do Lucid depois de gerá-lo.

Saiba mais: Para saber como trabalhar com a arquitetura AWS em um modelo Lucidscale depois de renderizado, leia nosso artigo.

Autorização de uso único

Para importar a infraestrutura da AWS por meio de credenciais de usuário do IAM, siga estas etapas:

Navegue até a página inicial da Lucid.
Clique em Central de dados na parte inferior do menu de navegação no lado esquerdo da página.
Selecione Importar dados da AWS.
Selecione Autorização de uso único.
No console do AWS IAM, crie uma política personalizada usando as permissões incluídas.
Acesse um usuário do IAM existente ou recém-criado e clique em "Adicionar permissões" e "Anexar políticas existentes diretamente" para adicionar a política personalizada que você criou.
Para melhor suporte de recursos, você também pode anexar a política ReadOnlyAccess gerenciada pela AWS ao usuário do IAM selecionado. Para fazer isso, pesquise e selecione ReadOnlyAccess na página “Adicionar permissões”.
Na guia "Credenciais de segurança" do seu usuário IAM, clique em "Criar chave de acesso" para gerar credenciais ou um arquivo CSV.
Retorne à sua guia Lucid e escolha carregar o arquivo CSV ou insira as credenciais geradas.
Clique em Avançar.
Você pode especificar as regiões que deseja importar e omitir os tipos de recursos ou metadados escolhidos da importação desmarcando-os. Os tipos de recursos e metadados desmarcados não serão importados ou incluídos em um modelo criado a partir da conta.
Clique em Concluir.

Saiba mais: para saber como trabalhar com a arquitetura da AWS em um modelo Lucidscale depois que ele for criado, leia nosso artigo.

Nota de segurança: o Lucid não armazenará suas credenciais do AWS IAM após executar a verificação inicial da sua infraestrutura da AWS. Suas credenciais serão transferidas para nossos servidores usando métodos de criptografia padrão. Os clientes podem negociar protocolos de criptografia de até AES-256. Se você preferir evitar inserir credenciais sempre que quiser atualizar seus dados, o Lucid pode armazenar uma função entre contas que nos dá apenas acesso "descrever e listar" ao seu ambiente (detalhado na seção acima).

Crie um usuário IAM

Para que o Lucidscale acesse sua infraestrutura da AWS, você precisa fornecer ao Lucidscale as credenciais de um novo usuário do IAM. Veja abaixo as instruções sobre como criá-los em seu console AWS.

Para criar um usuário do IAM com uma política em linha para a importação da AWS do Lucidscale, siga estas etapas:

Abra o console da AWS.
Navegue até a seção Usuáriosde Acesso e gerenciamento de identidade (IAM).
Clique em Adicionar usuários e digite um nome para o usuário.
- Marque a caixa ao lado de “Chave de acesso - acesso programático” para que Lucidscale possa usar a chave de acesso para recuperar as informações sobre sua infraestrutura.
Clique em Avançar: Permissões.
Selecione Anexar políticas existentes diretamente.
Clique em Criar política e alterne para a janelaJSON na guia do navegador recém-aberta.
Na seção Contas importadas do Lucid Data Hub, clique em + Nova conta.
Selecione Usuário do IAM na lista de métodos de importação.
Clique em Avançar.
Copie o arquivo de política json do modal.
Cole o arquivo de política json na janelaJSON na página "Criar política" na AWS.
Clique em Avançar: Marcas.
Adicione tags IAM à função, se desejar, e clique em Next: Review.
Dê um nome e uma descrição à política.
Clique em Criar política.
Na guia anterior do navegador do console do IAM, onde você começou a criar um novo usuário, clique no botão de atualização e procure o nome da política que acabou de criar.
Selecione a política e clique em Avançar: Tags.
Adicione tags IAM ao seu usuário, se desejar, e clique em Next: Review.
Revise os detalhes do usuário e clique em Criar usuário.
Clique em Baixar .csv para armazenar o ID da chave de acesso e a chave de acesso secreta e copie/cole-os ou carregue o csv no Lucidscale.
Clique em Avançar.
- Você pode especificar as regiões que deseja importar e omitir os tiposde recursos ou metadados selecionados da importação, desmarcando-os.Os tiposde recursos e metadados desmarcados não serão importados nem incluídos no modelo criado a partir da conta.
Especifique um nome de alias para sua conta e clique em Importar conta da AWS.
- Após a conclusão da importação, a conta será listada como uma conta AWS “importada” no modal após clicar em + Novo > Lucidscale > AWS.
- A conta também será exibida na seção " AWS: contas importadas" do hub de dados.
Selecione Criar novo modelo.
Revise os detalhes do seu modelo e adicione filtros para excluir recursos desnecessários.
Selecione Criar modelo da AWS.

Saiba mais: para saber como trabalhar com a arquitetura da AWS em um modelo Lucidscale depois que ele estiver concluído, leia nosso artigo.

Carregamento de arquivo

Para importar a infraestrutura da AWS via CLI, siga estas etapas:

Navegue até a página inicial da Lucid.
Clique em Central de dados na parte inferior do menu de navegação no lado esquerdo da página.
Selecione Importar dados da AWS.
Selecione Upload de arquivo.
Copie e execute o script fornecido usando a interface de linha de comando do seu terminal para gerar um arquivo JSON.
- Para obter instruções passo a passo, consulte as instruções do script CLI abaixo.
Carregue o JSON resultante no Lucidscale e clique em Avançar.
Dê um nome à conta que você está importando e clique em Avançar.
- A conta será listada como uma conta AWS importada no modal após clicar em + Novo > Lucidscale > AWS.
- A conta também será exibida na seção "AWS: Contas importadas" do Data Central.
Selecione Criar novo modelo.
Revise os detalhes e adicionefiltros para excluir recursos desnecessários.
Selecione Criar modelo da AWS.

O modelo Lucidscale será gerado em segundo plano na sua conta do Lucid. Nós o notificaremos assim que ele for criado por meio do modal de status que aparece no canto inferior direito da página.

Você pode abrir o modelo a partir do modal de status que aparece logo após a criação de um novo modelo. O modelo (e modelos criados anteriormente) também serão armazenados e acessíveis na seção de documentos da sua página inicial do Lucid depois de gerá-lo.

Saiba mais: para saber como trabalhar com a arquitetura da AWS em um modelo Lucidscale depois que ele for criado, leia nosso artigo.

Instruções do script CLI

Instale o Python 3.0-3.9.
Instale a AWS CLI.
Execute pip3 install botocore==1.27.77.
Configure a AWS CLI (instruções da AWS podem ser encontradas aqui).
Execute python3 awscliscript.py --profile “profile name” --regions us-east-1 us-west-1 que produziria um arquivo aws.json.
Clique em + Novo.
Passe o cursor sobre Lucidscale e selecione AWS.
Escolha importar uma conta existente
- Você também pode clicar em Open Data Central, Import AWS data e selecionar AWS CLI Script.
Carregue o arquivo aws.json no Lucidscale e clique em Avançar.
Dê um nome à conta que você está importando e clique em Avançar.
- A conta será listada como uma conta AWSimportada no modal após clicar em + Novo > Lucidscale > AWS.
- A conta também será exibida na seção " AWS: contas importadas" do Data Hub.
Selecione Criar novo modelo.

Instruções detalhadas do script CLI

Instale o Python 3.0-3.9 (as instruções podem ser encontradas aqui). Certifique-se de marcar a opção Add Python to PATH no instalador.
Instale a AWS CLI (instruções da AWS podem ser encontradas aqui).
- Use o painel esquerdo para clicar em instruções como Installing the AWS CLI e Configuring the AWS CLI.
Instale o botocore versão 1.27.77 com pip3 executando pip3 install botocore==1.27.77.
- Lucidscale - AWS foi desenvolvido a partir da versão 1.27.77 do botocore, no entanto, se você já tiver uma versão diferente instalada, a importação ainda deve funcionar. Se não funcionar, considere executar o script em um ambiente virtual python que permite que você gerencie instalações de pacotes separadas para diferentes projetos. Após executar o script, você pode excluir o ambiente virtual. Instruções para criar um ambiente virtual Python podem ser encontradas aqui.
Configure a AWS CLI (instruções da AWS podem ser encontradas aqui).
- Um perfil nomeado é uma coleção de configurações e credenciais que você pode aplicar a um comando da AWS CLI.
- A execução do aws configure armazenará as credenciais inseridas no perfil chamado default. Se você tiver várias contas, recomendamos criar perfis nomeados para elas. Por exemplo, se eu tiver duas contas, preprod e prod e armazenar suas credenciais como dois perfis separados, poderia facilmente descrever as instâncias ec2 em preprod fazendo aws ec2 describe-instances -- profile preprod. Emseguida, para descrever instâncias em prod, posso alterar o argumentodo perfil para aws ec2 describe-instances -- profile prod.
- Instruções para configurar perfis nomeados da AWS podem ser encontradas aqui.
- O script Lucidscale - AWS exigirá que você forneça o nome do(s) perfil(es) que deseja importar.
Execute o script Lucidscale - AWS
1. -c ou --contar
  - Gere um arquivo JSON com detalhes sobre o número de recursos. A execução do script com esse sinalizador segue um caminho diferente no script de importação e não gera um arquivo JSON que pode ser carregado no Lucidscale - AWS
2. -a ou --anon
  - Torne os dados anônimos (hashes todas as strings)
3. -o ou --output
  - Envie os dados para o nome de arquivo fornecido
4. -p ou --profile
  - O nome do perfil a ser usado
5. -r ou --regions
  - As regiões a importar
    - (exemplo) python3 awscliscript.py --profile preprod --regions us-east-1 us-west-1
    - O comando acima executa o script e gera dados para recursos no perfilpreprod que residem nas regiões us-east-1 e us-west-1
    - O script Lucidscale - AWS possui sinalizadores adicionais que podem ser usados
6. Um aws.json será gerado como saída. Carregue este arquivo no Lucidscale para importar sua infraestrutura para o Lucid Data Hub.
  - A conta será listada como uma conta AWSimportada no modal após clicar em + Novo > Lucidscale > AWS.
  - A conta também será exibida na seção " AWS: contas importadas" do Data Hub.
7. Selecione Criar modelo.

O modelo Lucidscale será gerado em segundo plano na sua conta do Lucid. Nós o notificaremos assim que o processo for concluído por meio de uma mensagem de status que aparecerá no canto inferior direito da página.

Você pode abrir o modelo a partir do modal de status que aparece logo após a criação de um novo modelo. O modelo(e os modelos criados anteriormente)também serão armazenados e acessíveis na seção de documentos da sua página inicial do Lucid após a geração.

Saiba mais: para saber como trabalhar com a arquitetura da AWS em um modelo Lucidscale após sua conclusão, leia nosso artigo.

Obs.:

Usuários do Windows: use “Windows CMD” para executar os comandos de script
Usuário MacOS: use o terminal

Use o Data Hub para gerenciar dados e credenciais de infraestrutura da AWS

Acessar contas importadas

Depois de importar sua conta da AWS, ela será listada como uma fonte de dados com o nome da conta que você especificou na seção "AWS: contas importadas" do Data Hub. Nessa seção, você também pode clicar em + Nova conta para importar uma nova conta para o Data Hub.

As contas listadas nesta seção são fontes de dados que podem ser usadas para criar novos modelos Lucidscale. As fontes de dados (“Contas”) contêm os metadados da conta da AWS usados para criar modelos Lucidscale. O campo “Última atualização” indica quando sua fonte de dados foi atualizada pela última vez para contabilizar quaisquer atualizações em sua conta da AWS conectada.

O Cloud Inventory de cada conta pode ser visto no lado direito após selecionar uma conta na lista. Este inventário permite ver uma contagem completa de cada tipo de recurso que foi importado antes de criar um modelo. Você também pode baixar um CSV com a lista de recursos e contar diretamente do Data Hub clicando em Baixar CSV.

O inventário lista todos os recursos que podem ser acessados pela sua política de permissões anexada à função entre contas. Se você optar por usar “Criar uma nova função automaticamente” com nosso modelo CloudFormation Stack, todos os recursos em sua conta que são acessíveis pela política ReadOnlyAccess da AWS serão renderizados no inventário. Se você criar uma função manualmente com uma política personalizada, somente os tipos de recursos especificados na política de permissões anexada serão renderizados no inventário.

Clique no menu detrêspontos renderizado em uma conta para ver seis opções possíveis: Criar novo modelo, Atualizar conta da AWS, Agendar atualização, Editar recursos, Renomear contae Excluir conta.

Criar novo modelo começará a renderizar a infraestrutura da AWS associada à conta como um diagrama no espaço de trabalho de um novo modelo. O modelo será gerado no plano de fundo da sua página inicial do Lucid e iremos notificá-lo assim que for renderizado por meio do modal de status que aparece no canto inferior direito da página.

Atualizar conta da AWS e agendar atualização permite que você atualize manualmente ou automaticamenteos dados da conta da AWS que você importou para o Data Hub para refletir quaisquer alterações na conta da AWS conectada. Novos modelos criados a partir da conta após a atualização refletirão as alterações na conta da AWS conectada.

Saiba mais: Para obter mais informações sobre como atualizar contas da AWS, consulte nosso artigoAtualizar e sincronizar dados no Lucidscale .

Editar recursos permite editar os recursos incluídos em cada conjunto de dados. Selecione esta opção para abrir um modal no qual você pode adicionar ou remover quaisquer recursos de seus conjuntos de dados existentes. Quando terminar de selecionar, clique em Salvar e atualizar conta. Isso garante que o conjunto de dados seja atualizado e os modelos que fazem referência a esse conjunto de dados sejam atualizados com as informações mais recentes.

Renomear conta permite alterar o nome do conjunto de dados selecionado.

Excluir conta remove a conta importada do Lucid Data Hub e qualquer modelo criado a partir dessa conta perderia a capacidade de atualizar dados da AWS.

Observação: as opções exibidas acima variam dependendo do método de importação usado para uma conta. A opçãode atualização está disponível apenas com a importação de função entre contas da AWS. As importações de IAM e CLI não oferecem suporte a essa opção.

Compartilhar e excluir credenciais salvas

A seçãoSaved Credentials em "Data Hub > AWS"lista as funções entre contas que você pode usar para importar suas contas da AWS para o Data Hub. Nesta seção, clique em + Nova função entre contas para adicionar um novo conjunto de credenciais que pode ser usado para importar uma conta da AWS.

Você também pode compartilhar as funções entre contas que criou com outros usuários. Se você clicar no menu de três pontos renderizado em uma conta, verá duas opções possíveis: Compartilhar credencial e Excluir credencial.

example_of_aws_saved_credentials_page_in_the_lucidscale_data_hub.png

A credencial de compartilhamento abre um modal onde você pode compartilhar uma função entre contas com outro usuário em sua conta do Lucid, especificando seu endereço de e-mail. Conceder a eles acesso à credencial permitirá que eles importem a conta associada da AWS para o Data Hub e criem modelos Lucidscale. Após o compartilhamento de uma credencial com outro usuário, você pode revogar o acesso dele à credencial clicando no X ao lado do endereço de e-mail no mesmo modal.

Excluir credencial remove a função entre contas do Data Hub. Depois de excluir uma credencial, todas as contas que foram importadas anteriormente com essa credencial junto com os modelos criados a partir dessas contas perderão a capacidade de atualizar dados da AWS.

Saiba mais: Você só pode compartilhar credenciais no Data Hub de sua propriedade. Apenas os usuários Lucidscale atribuídos a uma licença Creator podem importar contas e criar modelos. Para obter mais detalhes, confira nosso artigo Gerenciamento, uso e segurança de credenciais no Lucidscale .

Informações de segurança

Funções entre contas

As funções entre contas são o método preferencial da AWS para conceder acesso de terceiros à sua conta. Esse método permite que o Lucidscale armazene com segurança credenciais que permitem que você atualize facilmente um diagrama. Consulte estes recursos para obter mais informações:

ID Externa Aplicada

Seguindo as melhores práticas de segurança fornecidas pela AWS, a Lucid garante que os IDs externos permaneçam exclusivos no banco de dados da Lucid. Portanto, o Lucid fornece um ID externo exclusivo ao usuário e não permite que o usuário insira seu próprio ID externo.

Acesso limitado e seguro para usuários IAM

Solicitamos permissão limitada em nível de "descrever" para o usuário do IAM que você criar. Um usuário do IAM criado com essas permissões não pode alterar configurações em sua infraestrutura da AWS ou ler dados em seus bancos de dados. Usamos apenas o usuário IAM para ler os metadados estruturais de sua infraestrutura AWS.

Alternativa de script de CLI

Se você deseja revisar e controlar as ações que tomamos durante nossa verificação de infraestrutura da AWS, você pode baixar e usar nosso script Python fornecido em vez de criar um usuário IAM. Nesse cenário, suas credenciais do IAM nunca serão passadas para o Lucidscale e você pode revisar o código que será executado em seu ambiente e os metadados resultantes antes de fazer o upload dos metadados para o Lucidscale. O JSON importado estará acessível no Lucid Data Hub para uso na criação de modelos Lucidscale.

Armazenamento seguro de documentos (modelos)

O Lucidscale armazena os metadados importados da AWS e os modelos gerados usando proteções padrão do setor para dados confidenciais. Os dados importados da AWS são incorporados como parte do modelo do Lucidscale, para que você possa controlar o acesso aos dados usando as permissões de compartilhamento padrão do Lucid. Para obter informações adicionais sobre como protegemos seus documentos, consulte nossa página de Segurança de conteúdo ou entre em contato com nossa equipe de vendas.

Sem armazenamento de chaves de acesso

Lucidscale não armazenará suas credenciais AWS IAM após realizar a verificação inicial de sua infraestrutura AWS. Suas credenciais serão transferidas para nossos servidores usando métodos de criptografia padrão. Os clientes podem negociar protocolos de criptografia até AES-256. Podemos armazenar uma função entre contas que apenas nos dá acesso de “descrever e listar” ao seu ambiente.

Perguntas frequentes

Assim que o Lucidscale for adquirido, todos os usuários da conta terão acesso?

Se você já é um cliente Lucid (atualmente possui uma assinatura Lucidchart ou Lucidspark), dependendo de suas configurações de licenciamento, é possível que nem todos os usuários da conta tenham acesso ao Lucidscale por padrão. Um administrador de conta pode precisar atribuir as licenças Lucidscale adquiridas a usuários individuais ou grupos por meio da seção Usuários do Painel Administrativo da mesma maneira que Lucidchart e Lucidspark. Os usuários adicionados a uma conta que tenha apenas uma assinatura Lucidscale Team (sem assinaturas atuais do Lucidchart ou Lucidspark) receberão automaticamente uma licença Creator ou Explorer, dependendo de quais licenças foram adquiridas. Para obter instruções sobre como conceder licenças, confira o painel de administração do Lucid: artigo de configurações de licença .

Como o Lucidscale obtém acesso ao nosso ambiente AWS? Qual é o nível de acesso do Lucidscale?

O método recomendado da Lucidscale e da AWS é por meio de uma função entre contas. Fornecemos uma política que nos dá acesso "descrever e listar" ao seu ambiente para que possamos obter um inventário de recursos. As credenciais armazenadas no Lucid só podem ser acessadas por sua conta Lucid. Este método de importação permitirá que você atualize os dados da conta com uma ação. A política de permissões que fornecemos permite que você determine exatamente quais dados a função entre contas terá acesso para solicitar da AWS.

Se você usar nosso método de usuário IAM, as credenciais não serão armazenadas, mas usadas uma vez e descartadas. Geralmente, nossos usuários usam esse método de importação junto com credenciais temporárias da AWS, pois esse método não permite atualizações de dados adicionais.

Também temos um método usando um script python que você pode executar por meio da interface de linha de comando (CLI) que gera um arquivo JSON. Depois de gerar o arquivo JSON, os usuários podem revisar o conteúdo e remover os dados, se desejarem, antes da importação. Os usuários podem fazer upload desse arquivo JSON para o Lucidscale e não preencher nenhuma informação de credencial no Lucidscale.

Como o Lucidscale comercial e o Lucidscale for Gov interagem ao importar por meio de funções entre contas?

Embora a funcionalidade do produto seja a mesma para cada um, a AWS configura a segurança de maneira diferente para esses dois ambientes. As funções do AWS IAM e as políticas baseadas em recursos delegam o acesso entre contas apenas em uma única partição. O Lucid GovSuite está em uma partição separada da AWS e, portanto, não pode importar dados da AWS por meio da função entre contas de contas não-GovCloud da AWS. As funções entre contas, nosso método de importação recomendado, permitem apenas o acesso a contas do mesmo tipo - portanto, se você estiver no ambiente comercial Lucid, poderá acessar e importar contas comerciais da nuvem da AWS por meio da função entre contas e, se estiver no No ambiente Lucid GovSuite, você pode acessar e importar contas AWS GovCloud por meio da função entre contas.

Oferecemos suporte à capacidade de importar contas comerciais da AWS para Lucidscale for Gov via usuário IAM ou um JSON criado a partir de nosso script CLI.

Quais APIs o Lucidscale acessa?

Usamos principalmente descrever e listar endpoints de API.

Você pode escolher quais metadados (os campos e valores mostrados no painel Dados) são importados? Se não, quais metadados são importados?

Não, atualmente você não pode escolher quais metadados serão importados. No entanto, estamos procurando criar alguma capacidade para fazer isso no futuro. Todos os metadados de uma chamada de API de descrição são importados.

Dar feedback sobre este artigo

Tem feedback sobre este artigo? Conte-nos sobre sua experiência aqui.

Artigos relacionados