Используй Lucidscale для импорта данных облачной инфраструктуры из AWS и создания диаграмм в модели Lucidscale.

Чтобы узнать больше о функциональных возможностях, доступных с лицензией Lucidscale, ознакомьтесь со статьей о тарифных планах Lucidscale .

Поддерживаемые регионы, ресурсы и линии

Ты можешь импортировать учетные записи AWS, размещенные в любом из следующих регионов 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 поддерживает следующие ресурсы 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

Lucidscale может проводить линии между ресурсами, которые явно ссылаются на другой в метаданных:

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

Примечание: Если ты решил суммировать ресурсы в рамках Lucidscale View, тебе необходимо разсуммировать их, чтобы линии были отображены в модели.

Импортируй инфраструктуру AWS

Вы можете импортировать данные облачной инфраструктуры AWS одним из четырех следующих способов:

Доверенный доступ: предоставьте роль IAM для разных учетных записей с соответствующими политиками. Это может быть сделано в двух вариантах:
- Импорт данных из Индивидуальной учетной записи
- Централизованное управление импортом для всех учетных записей в вашей организации
Одноразовая авторизация: ввод учетных данных для пользователя IAM с прикрепленными соответствующими политиками
Загрузка файла: запустите скрипт CLI на вашем компьютере AWS, который извлекает данные локально, а затем предоставьте сгенерированный файл JSON.

Ознакомьтесь со следующей таблицей, чтобы получить подробную информацию о каждом методе и определить, какой из них лучше всего подходит для вашего варианта использования.

Типы импорта	Описание	Охват	Ресурсная поддержка	Обновление данных
Доверенный доступ на уровне организации	Зарегистрируйте в Lucid роль IAM для кросс-учетной записи на уровне организации для безопасного и долгосрочного повторного использования.	Централизованно управляйте импортом всех учетных записей в организации AWS, зарегистрировав один учетный документ.	(1) Все поддерживаемые ресурсы, перечисленные в данной статье. (2) Облачная инвентаризация: широкий спектр неотображенных ресурсов, которые вы можете разместить вручную в своих моделях.	Автоматическое обновление по пользовательскому расписанию ИЛИ обновление вручную одним щелчком мыши. Lucid сохраняет эти учетные данные, чтобы вы могли обновить данные или начать новый импорт без повторного ввода информации.
учетная запись доверенного доступа	Зарегистрируйте роль IAM на уровне учетной записи в Lucid для безопасного долгосрочного повторного использования.	Зарегистрируйте учетные данные для каждой индивидуальной учетной записи AWS.	(1) Все поддерживаемые ресурсы, перечисленные в данной статье. (2) Облачная инвентаризация: широкий спектр неотображенных ресурсов, которые вы можете разместить вручную в своих моделях.	Автоматическое обновление по пользовательскому расписанию ИЛИ обновление вручную одним щелчком мыши. Lucid сохраняет эти учетные данные, чтобы вы могли обновить данные или начать новый импорт без повторного ввода информации.
Одноразовое разрешение	Загрузите файл ключа пользователя IAM или учетных данных в Lucid.	Разовый доступ к индивидуальной учетной записи AWS.	(1) Все поддерживаемые ресурсы, перечисленные в данной статье. (2) Облачная инвентаризация: широкий спектр неотображенных ресурсов, которые вы можете разместить вручную в своих моделях.	Обновите данные, повторно введя данные учетных данных. Lucid не хранит учетные данные пользователя IAM для повторного использования в будущем.
Загрузка файла	Запустите скрипт CLI на компьютере AWS, чтобы получить данные локально, а затем загрузите сгенерированный JSON-файл в Lucid.	До 5 учетных записей на один файл JSON.	Ограничено поддерживаемыми ресурсами, перечисленными в этой статье.	Замените данные, загрузив только что сгенерированный файл JSON.

Если вы работаете с очень большой средой, используйте информацию из раздела «Конфигурация учетной записи этой статьи» при использовании ролей кросс-учетной записи, чтобы уменьшить объем импортируемых данных или уменьшить количество вызовов API, которые Lucid выполняет к AWS. Lucid поддерживает до 50 одновременных импортов. После завершения каждого импорта вы можете начать новый импорт.

Чтобы импортировать и визуализировать инфраструктуру AWS в модели Lucidscale, выполните следующие действия:

Перейдите на главную страницу сайта Lucid.
Нажмите Data Hub в нижней части меню навигации в левой части страницы.
Нажмите Import AWS data и выберите метод импорта.
- После выбора способа импорта и завершения импорта учетная запись будет указана в качестве источника данных в разделе «AWS: Импортированная учетная запись» в Data Hub.
Щелкни по меню с тремя точками рядом с учетной записью, из которой ты хочешь создать модель.
Выберите Создать новую модель.
Просмотрите детали и добавьте фильтры, чтобы исключить ненужные ресурсы.
Выбери Create AWS Model.

Модель Lucidscale будет сгенерирована в фоновом режиме в вашей учетной записи Lucid. Мы уведомим вас о его завершении с помощью модального окна статуса, которое отображается в правом нижнем углу страницы.

Модель можно открыть из модального окна статуса, которое появляется сразу после создания новой модели. Модель (и ранее созданные модели) также будут сохранены и доступны в разделе «документ» на главной странице Lucid после ее создания.

modal_confirming_successful_creation_of_aws_lucidscale_model.png

Подробнее: Чтобы узнать, как работать с архитектурой AWS в модели Lucidscale после ее создания, прочитайте нашу статью.

Доверенный доступ на уровне организации

Чтобы централизованно управлять импортом инфраструктуры во всей организации AWS, выполните следующие действия.

Заметка: Если вы работаете в среде Lucid GovSuite, вы сможете импортировать учетную запись AWS GovCloud только с помощью роли кросс-учетной записи. Коммерческая среда Lucid не может получить доступ к учетной записи AWS GovCloud через роли кросс-учетной записи. Обратитесь к разделу часто задаваемых вопросов ниже для получения более подробной информации.

Зарегистрируйте новую межучетную запись IAM в Lucid для управления импортом на уровне организации:

Перейдите на главную страницу сайта Lucid.
Нажмите Data Hub в нижней части меню навигации в левой части страницы.
Выберите Импортировать данные AWS.
Выберите Доверенный доступ.
В разделе «Область действия учетных данных» выберите «Подключиться к организации AWS».
Выберите один из вариантов автоматической настройки разрешений:
- Использование модуля Terraform
- Используйте шаблоны CloudFormation

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

Чтобы настроить разрешения автоматически с помощью Terraform, выполните следующие действия:

Получите доступ к модулю Lucid Terraform для настройки разрешений, нажав « Просмотр» в реестре Terraform, или получите доступ к модулю напрямую по этой ссылке.
На странице реестра модулей нажмите « Подмодули », чтобы получить доступ к каждому из трех необходимых подмодулей по очереди.
Следуйте инструкциям в разделе «Использование» на странице сведений каждого подмодуля, чтобы добавить модуль в код конфигурации Terraform.
- Для подмодулей bastion-role и import-role требуется значение external_id. Чтобы получить значение этого внешнего идентификатора, вернитесь на вкладку Lucid и нажмите «Копировать » рядом с предоставленным внешним идентификатором.
- Подмодуль org-read-delegation включает в себя необязательный параметр учетной записи. Если значение этого параметра не указано, модуль Terraform создаст новую «учетную запись бастиона» для координации импорта с Lucid.
- Как написано, подмодуль org-read-delegation развертывает политику ресурсов, которая делегирует разрешения роли бастиона для сканирования структуры вашей организации. Если вы уже создали политику ресурсов для своей организации, развертывание завершится ошибкой. Вместо этого добавьте политику JSON, указанную здесь , в существующую политику ResourcePolicy.
Разверните свой код Terraform и подождите, пока будут созданы включенные ресурсы из модуля Lucid.
Перейдите в раздел IAM консоли AWS для выбранной учетной записи бастиона и найдите созданную роль с кросс-учетной записью.
Щелкни по имени роли, чтобы перейти на страницу краткого описания роли.
Скопируй строку рядом с "Role ARN".
Вернитесь на вкладку Lucid и прокрутите вниз до раздела «Добавьте роль кросс-учетной записи в Lucid». Введите роль ARN в поле "Роль бастиона ARN" предоставленной формы.
Если вы настроили параметр MemberRoleName при настройке кода Terraform, обновите это значение также в форме.
При необходимости обновите предварительно заполненное значение параметра "Отображаемое имя учетных данных" для роли бастиона, используемой для координации импорта. Это отображаемое имя будет использоваться в Lucid Data Hub, чтобы вы могли найти учетные данные для дальнейшего использования и управления.
Нажмите «Далее », чтобы зарегистрировать роль кросс-учетной записи в Lucid.
Выберите роль и нажмите кнопку Далее.
Перейдите к шагам по импорту учетной записи и созданию моделей.

Чтобы настроить разрешения автоматически с помощью CloudFormation, выполните следующие действия:

Определите учетную запись в своей организации, которую вы хотите использовать для управления доверенным доступом третьих лиц. Lucid возьмет на себя роль кросс-учетной записи в этой «учетной записи-бастионе» для координации импорта.
Запустите первый предоставленный шаблон CloudFormation в консоли AWS. Вы будете использовать этот шаблон для настройки разрешений на импорт для учетной записи бастиона и для каждого из ваших участников учетной записи.
На странице «Создать стек» в консоли AWS введите значения для каждого из необходимых параметров.
- Параметр MembersRootOrOrganizationalUnitId управляет областью учетной записи в вашей организации, которую Lucid сможет импортировать. Чтобы разрешить импорт данных ресурсов для всех учетных записей в вашей организации, введите идентификатор корня вашей организации. Если вы хотите разрешить импорт только для учетной записи, вложенной в одно подразделение, введите идентификатор этого подразделения.
Нажмите кнопку Создать стек и дождитесь завершения развертывания.
Вернитесь на вкладку Lucid и запустите второй предоставленный шаблон CloudFormation. Этот шаблон будет использоваться для того, чтобы роль бастиона могла идентифицировать учетную запись для импорта, сканируя структуру организации.
В этом шаблоне развертывается политика ресурсов, которая делегирует разрешения роли бастиона для сканирования структуры организации. Если вы уже создали ResourcePolicy для своей организации, создание стека CloudFormation завершится ошибкой. Вместо этого добавьте политику JSON, указанную здесь , в существующую политику ResourcePolicy.
Перейдите в раздел IAM консоли AWS для выбранной учетной записи бастиона и найдите созданную роль с кросс-учетной записью.
Щелкни по имени роли, чтобы перейти на страницу краткого описания роли.
Скопируй строку рядом с "Role ARN".
Вернитесь на вкладку Lucid и прокрутите вниз до раздела «Добавьте роль кросс-учетной записи в Lucid». Введите роль ARN в поле "Роль бастиона ARN" предоставленной формы.
Если вы настроили параметр MemberRoleName при настройке первого шаблона CloudFormation, обновите это значение также в форме.
При необходимости обновите предварительно заполненное значение параметра "Отображаемое имя учетных данных" для роли бастиона, используемой для координации импорта. Это отображаемое имя будет использоваться в Lucid Data Hub, чтобы вы могли найти учетные данные для дальнейшего использования и управления.
Нажмите «Далее », чтобы зарегистрировать роль кросс-учетной записи в Lucid.
Выберите роль и нажмите кнопку Далее.
Перейдите к шагам по импорту учетной записи и созданию моделей.

Заметка: Эти шаблоны CloudFormation настроены на использование наборов стеков с разрешениями, управляемыми службой. В настоящее время мы не поддерживаем настройку CloudFormation с использованием наборов стеков с самоуправляемыми разрешениями.

Импорт учетной записи и создание моделей

Выберите учетные записи, которые вы хотите импортировать в Data Hub.
Нажмите «Далее».
- Используя инструкцию, подробно описанную в конце этого раздела в разделе «Конфигурация учетной записи», вы можете указать регионы, которые вы хотите импортировать, и исключить выбранные типы ресурсов или метаданные из импорта, отменив их выбор. Выбранные типы ресурсов и метаданные не будут импортироваться или визуализироваться в модели, созданной на основе учетной записи.
Нажмите Import AWS account record.

Чтобы визуализировать учетную запись AWS после завершения импорта, выполните следующие действия.

Вернитесь в Data Hub.
Выберите Создать новую модель.
Выберите импортированную учетную запись и нажмите кнопку Выбрать учетную запись.
Просмотрите детали и добавьте фильтры, чтобы исключить ненужные ресурсы.
Выбери Создать модель AWS.

Модель Lucidscale будет сгенерирована в фоновом режиме в вашей учетной записи Lucid. Мы уведомим вас о его создании с помощью сообщения о статусе, которое появится в правом нижнем углу страницы.

Модель можно открыть из сообщения о статусе, которое появляется сразу после создания новой модели. Модель (и ранее созданные модели) также будут сохранены и доступны в разделе «документ» на главной странице Lucid после ее создания.

конфигурация учетной записи с использованием роли кросс-учетной записи

При импорте учетной записи AWS в Lucid Data Hub с помощью роли кросс-учетной записи у вас есть возможность исключить выбранные типы ресурсов или метаданные из импорта. Это дает вам возможность визуализировать только те типы ресурсов, которые вас интересуют, и, в некоторых случаях, может увеличить скорость импорта. Выбранные типы ресурсов и метаданные не будут импортированы или визуализированы в схеме.

configure-ресурсы-включенные-в-импорт

учетная запись доверенного доступа

Чтобы импортировать инфраструктуру AWS для индивидуальной учетной записи с помощью роли IAM для кросс-учетной записи и создать модель Lucidscale, выполните следующие действия.

Для доверенного доступа на уровне учетной записи необходимо создать отдельную роль для каждой новой учетной записи AWS, которую вы хотите импортировать. Вы можете сделать это, выбрав «Зарегистрировать новую учетную запись» на странице импорта «Доверенный доступ».

Зарегистрируйте новую кросс-учетную запись IAM-роли в Lucid:

Перейдите на главную страницу сайта Lucid.
Нажмите Data Hub в нижней части меню навигации в левой части страницы.
Выберите Импортировать данные AWS.
Выберите Доверенный доступ.
В разделе «Область действия учетных данных» выберите «Подключиться к индивидуальной учетной записи AWS».
Выберите один из вариантов регистрации новых учетных данных:
- Использование шаблона CloudFormation
- Создание вручную

Чтобы создать новую роль автоматически с помощью CloudFormation, выполни следующие действия:

Убедись, что функция "Include ReadOnlyAccess" включена.
- Этот параметр включен по умолчанию и обеспечивает наилучшую поддержку импорта ресурсов и их визуализации в моделях Lucidscale.
Нажми Launch CloudFormation, чтобы открыть новую вкладку браузера, и войди в свой аккаунт AWS. Оставь вкладку браузера Lucid открытой, чтобы ты мог вернуться к ней позже.
Щелкни по кнопке Create Stack (Создать стек).
После того как стек будет создан, перейди на вкладку "Ресурсы" и выбери "LucidscaleImportRole".
Перейдите к инструкциям по регистрации роли кросс-учетной записи в Lucidscale.

Чтобы вручную создать новую роль в AWS IAM Console, выполни следующие действия:

В разделе "Шаг 1: Начни создавать роль" выбери пункт " Создать роль".
- Ты перейдёшь в свой аккаунт AWS. Оставь вкладку браузера Lucid открытой, чтобы ты мог вернуться к ней позже.
- Lucidscale автоматически сгенерирует уникальный внешний идентификатор, связанный с твоим аккаунтом Lucidscale. Это соответствует рекомендациям AWS по безопасности.
В разделе AWS нажми кнопку Next: Разрешения.
На странице "Add Permissions" найди и выбери политику ReadOnlyAccess.
- Эта настройка включена в Lucid по умолчанию и необходима для корректного отображения всех ресурсов в созданных вами моделях Lucidscale.
Перейди обратно на вкладку Lucid по адресу "Шаг 2: Добавление пользовательских разрешений" и нажми кнопку Copy permissions, чтобы скопировать текстовый файл JSON.
Перейди обратно на страницу "Создание роли" в AWS и нажми кнопку Create Policy. Ты будешь перенаправлен на новую вкладку браузера для создания политики.
На странице "Создание политики" переключись на вкладку JSON и вставь в свою AWS Console файл, который ты скопировал на вкладку JSON.
Нажми кнопку Далее: Теги.
Если хочешь, добавь к политике теги и нажми кнопку Next: Обзор.
Дай политике название и описание.
Нажми кнопку Создать политику.
На предыдущей вкладке AWS, где ты создавал новую кросс-аккаунтную роль, нажми кнопку refresh и найди название только что созданной политики.
Выбери политику и нажми кнопку Next: Далее ты можешь выбрать политику.
Если хочешь, добавь к роли IAM-метки, затем нажми кнопку Next: Обзор.
Дай роли имя и описание и нажми кнопку Создать роль.

Зарегистрируйте роль кросс-учетной записи в Data Hub

Щелкни по имени роли, чтобы перейти на страницу краткого описания роли.
Скопируй строку рядом с "Role ARN".
Перейди обратно на свою вкладку Lucid и прокрути вниз до раздела "Add the Cross-Account Role to Lucidscale" на странице New AWS Account.
Вставьте строку в поле "Role ARN", при необходимости настройте поле "Credential display name"" и нажмите кнопку "Далее ", чтобы зарегистрировать роль кросс-учетной записи.
- Затем новая роль будет отображаться на странице New AWS Account с "Role Name", которое ты использовал.
- Роль кросс-аккаунта также будет отображаться в "AWS: Saved Credentials" разделе Data Hub.
Выбери роль и нажми Next.

Импортируй счета и создавай модели

Выбери счет(s) , который ты хочешь импортировать в Data Hub для создания модели Lucidscale.
Нажми Далее.
- Используя инструкцию, подробно описанную в конце этого раздела в разделе «Конфигурация учетной записи», вы можете указать регионы, которые вы хотите импортировать, и исключить выбранные типы ресурсов или метаданные из импорта, отменив их выбор. Невыбранные типы ресурсов и метаданные не будут импортироваться или отображаться в модели, созданной на основе учетной записи.
Нажмите Импорт Аккаунт AWS.

Чтобы найти свою учётную запись AWS после завершения импорта:

Щелчок + Новый
Наведи курсор на Lucidscale и выбери AWS.
Выберите Создать новую модель.
Просмотри детали и добавь Фильтры, чтобы исключить ненужные ресурсы.
Выбери Create AWS Model.

Модель Lucidscale будет генерироваться в фоновом режиме твоего аккаунта Lucid. Мы уведомим тебя, как только она будет оказана, через модал статуса, который появляется в правом нижнем углу страницы.

Ты можешь открыть модель из модала состояния, который рендерится непосредственно после создания новой модели. Модель (и ранее созданные модели) будет также храниться и будет доступна в разделе "Documents" на твоей домашней странице Lucid после того, как ты её сгенерируешь.

Узнай больше: Чтобы узнать, как работать с архитектурой AWS в модели Lucidscale после ее рендеринга, прочитай нашу статью.

Одноразовое разрешение

Чтобы импортировать инфраструктуру AWS через учетные данные пользователей IAM, выполни следующие шаги:

Перейдите на главную страницу сайта Lucid.
Нажмите Data Hub в нижней части меню навигации в левой части страницы.
Выберите Импортировать данные AWS.
Выберите Разовое разрешение.
В консоли AWS IAM создайте настраиваемую политику, используя включенные разрешения.
Получите доступ к существующему или вновь созданному пользователю IAM, затем нажмите «Добавить разрешения» и «Подключить существующие политики напрямую», чтобы добавить созданную вами пользовательскую политику.
Для обеспечения наилучшей поддержки ресурсов вы также можете прикрепить политику ReadOnlyAccess, управляемую AWS, к выбранному пользователю IAM. Для этого найдите и выберите ReadOnlyAccess на странице "Добавить разрешения".
На вкладке «Учетные данные безопасности» вашего пользователя IAM нажмите «Создать ключ доступа», чтобы сгенерировать учетные данные или файл CSV.
Вернитесь на вкладку Lucid и выберите загрузку файла CSV или введите сгенерированные учетные данные.
Нажмите «Далее».
Вы можете указать регионы, которые вы хотите импортировать, и исключить выбранные типы ресурсов или метаданные из импорта, отменив их выбор. Невыбранные типы ресурсов и метаданные не будут импортированы или включены в модель, созданную на основе учетной записи.
Нажмите Готово.

Примечание о безопасности: Lucid не будет хранить ваши учетные данные AWS IAM после выполнения первоначального сканирования вашей инфраструктуры AWS. Ваши учетные данные будут переданы на наши серверы с использованием стандартных методов шифрования. Клиенты могут согласовывать протоколы шифрования до AES-256. Если вы предпочитаете не вводить учетные данные каждый раз, когда хотите обновить свои данные, Lucid может сохранить роль кросс-учетной записи, которая дает нам доступ только к вашей среде «описать и перечислить» (подробно описано в разделе выше).

Создайте пользователя IAM

Для того чтобы Lucidscale получил доступ к твоей инфраструктуре AWS, тебе нужно предоставить Lucidscale учетные данные нового IAM-пользователя. Инструкции по их созданию в твоей консоли AWS смотри ниже.

Чтобы создать IAM-пользователя с инлайн-политикой для импорта Lucidscale в AWS, выполни следующие шаги:

Открой консоль AWS.
Перейди в раздел Пользователи Identity Access and Management (IAM).
Нажми Добавить пользователей и введи имя для пользователя.
- Поставь галочку напротив "Ключ доступа - программный доступ", чтобы Lucidscale мог использовать ключ доступа для получения информации о твоей инфраструктуре.
Нажми Next: Разрешения.
Выберите Прикрепите существующие политики напрямую.
Нажми Создать политику и переключись на окно JSON во вновь открытой вкладке браузера.
В разделе "Импортированные счета" в Lucid Data Hub нажми + Новый счет.
Выбери IAM User из списка методов импорта.
Нажми Далее.
Скопируй файл json-политики из модала.
Вставь json-файл политики в окно JSON на странице "Создание политики" в AWS.
Нажми Далее: Теги.
Добавь IAM-метки к роли, если хочешь, затем нажми Next: Обзор.
Дай политике название и описание.
Кликни Создать политику.
В предыдущей вкладке браузера консоли IAM, где ты начал создавать нового пользователя, нажми кнопку обновления, а затем найди название только что созданной политики.
Выбери политику и нажми Next: Теги.
Добавь IAM-метки к своему пользователю, если хочешь, затем нажми Next: Обзор.
Просмотри данные о пользователе и нажми Создать пользователя.
Нажми Загрузить .csv , чтобы сохранить идентификатор ключа доступа и секретный ключ доступа, и скопируй/вставь их или загрузи csv в Lucidscale.
Нажми Далее.
- Вы можете указать регионы, которые вы хотите импортировать, и исключить выбранные типыресурсов или метаданные из импорта, отменив их выбор. Выбранные типыресурсов и метаданные не будут импортированы или включены в модель, созданную из учетной записи.
Укажи псевдонимное имя для своего аккаунта и нажми Импорт аккаунта AWS.
- После завершения импорта аккаунт будет указан как "импортированный" аккаунт AWS в модале после нажатия + New > Lucidscale > AWS.
- Учетная запись также будет отображаться в разделе "AWS: Imported Accounts" разделе концентратора данных.
Выберите Создать новую модель.
Просмотри детали своей модели и добавь Фильтры, чтобы исключить ненужные ресурсы.
Выбери Создать модель AWS.

Модель Lucidscale будет сгенерирована в фоновом режиме в вашей учетной записи Lucid. Мы уведомим вас, как только он будет завершен, через модальное окно статуса, которое отображается в правом нижнем углу страницы.

Подробнее: Чтобы узнать, как работать с архитектурой AWS в модели Lucidscale после ее завершения, прочитайте нашу статью.

Загрузка файла

Чтобы импортировать инфраструктуру AWS через CLI, выполни следующие шаги:

Перейдите на главную страницу сайта Lucid.
Нажмите Data Hub в нижней части меню навигации в левой части страницы.
Выберите Импортировать данные AWS.
Выберите Загрузить файл.
Скопируйте и запустите предоставленный скрипт с помощью интерфейса командной строки вашего терминала, чтобы сгенерировать JSON-файл.
- Пошаговые инструкции см. в приведенных ниже инструкциях по скрипту CLI .
Загрузите полученный JSON в Lucidscale и нажмите «Далее».
Присвойте именной учетной записи, которую вы импортируете, затем нажмите «Далее».
- Учетная запись будет указана как импортированная учетная запись AWS в модальном окне после нажатия кнопки + Новый > Lucidscale > AWS.
- Учетная запись также будет отображаться в разделе «AWS: Импортированная учетная запись» в Data Hub.
Выберите Создать новую модель.
Просмотрите детали и добавьте фильтры для исключения ненужные ресурсы.
Выбери Create AWS Model.

Модель Lucidscale будет сгенерирована в фоновом режиме в вашей учетной записи Lucid. Мы уведомим вас, как только он будет создан, с помощью модального окна статуса, которое отображается в правом нижнем углу страницы.

Модель можно открыть из модального окна статуса, которое появляется сразу после создания новой модели. Модель (и ранее созданные модели) также будет сохранена и доступна в разделе документов на главной странице Lucid после ее создания.

Инструкции по скрипту CLI

Установите Python 3.0-3.9.
Установи AWS CLI.
Выполни pip3 install botocore==1.27.77.
Настройте интерфейс командной строки AWS (инструкции от AWS можно найти здесь).
Запусти python3 awscliscript.py --profile "profile name" --regions us-east-1 us-west-1 , который создаст файл aws.json.
Нажмите + New.
Наведи курсор на Lucidscale и выбери AWS.
Выберите импорт существующей учетной записи
- Вы также можете нажать « Открыть Data Hub», «Импортировать данные AWS» и выбрать скрипт AWS CLI.
Загрузи файл aws.json в Lucidscale и нажми Next.
Дай имя учетной записи, которую ты импортируешь, затем нажми Next.
- Аккаунт будет указан как импортированный AWS аккаунт в модале после нажатия + New > Lucidscale > AWS.
- Учетная запись также будет отображаться в разделе "AWS: Imported Accounts" разделе Data Hub.
Выберите Создать новую модель.

Подробные инструкции по сценарию CLI

Установи Python 3.0-3.9 (инструкции можно найти здесь). Убедись, что ты отметил опцию Add Python to PATH в программе установки.
Установите интерфейс командной строки AWS (инструкции от AWS можно найти здесь).
- Используй левую панель для перехода по таким инструкциям, как Установка AWS CLI и Настройка AWS CLI.
Установи botocore версии 1.27.77 с помощью pip3, выполнив pip3 install botocore==1.27.77.
- Lucidscale - AWS был разработан на основе botocore версии 1.27.77, однако, если у вас уже установлена другая версия, импорт все равно должен работать. Если это не так, рассмотрите возможность запуска скрипта в виртуальной среде Python, которая позволяет управлять отдельными установками пакетов для разных проектов. После запуска скрипта вы можете удалить виртуальную среду. Инструкции по созданию виртуальной среды Python можно найти здесь.
Настройте интерфейс командной строки AWS (инструкции от AWS можно найти здесь).
- Профиль с именем - это набор настроек и учетных данных, которые ты можешь применить к команде AWS CLI.
- Выполнение команды aws configure сохранит введенные учетные данные в профиль с именем default. Если у тебя несколько учетных записей, мы рекомендуем создать для них именованные профили. Например, если у меня есть два аккаунта preprod и prod и , я храню их учетные данные как два отдельных профиля, тогда я могу легко описать ec2 экземпляры в preprod , сделав aws ec2 describe-instances -- profile preprod. TЗатем, чтобы описать экземпляры в prod, я могу изменить аргумент profile на 54 aws ec2 describe-instances -- profile prod.
- Инструкции по настройке именованных профилей из AWS можно найти здесь.
- Скрипт Lucidscale - AWS потребует от тебя ввести имя профиля (профилей), который ты хочешь импортировать.
Запустите скрипт Lucidscale - AWS
1. -c или --count
  - Выведи JSON-файл с подробной информацией о количестве ресурсов. Запуск скрипта с этим флагом проходит по другому пути через скрипт импорта и не выводит JSON-файл, который можно загрузить на Lucidscale - AWS
2. -a или --anon
  - Анонимизируй данные (хэшируй все строки).
3. -o или --output
  - Выведите данные в указанное имя файла
4. -p или --profile
  - Имя профиля для использования.
5. -r или --regions
  - Регионы для импорта
    - (пример) python3 awscliscript.py --profile preprod --regions us-east-1 us-west-1
    - Команда выше запускает скрипт и генерирует данные для ресурсов в preprod профиле, проживающих в регионах us-east-1 и us-west-1.
    - Скрипт Lucidscale - AWS имеет дополнительные флаги, которые можно использовать
6. В качестве выходных данных будет сгенерирован aws.json. Загрузи этот файл в Lucidscale, чтобы импортировать твою инфраструктуру в Lucid Data Hub.
  - Аккаунт будет указан как импортированный AWS аккаунт в модале после нажатия + New > Lucidscale > AWS.
  - Учетная запись также будет отображаться в разделе "AWS: Imported Accounts" разделе Data Hub.
7. Выберите Создайте модель.

Модель Lucidscale будет сгенерирована в фоновом режиме в вашей учетной записи Lucid. Мы уведомим вас, как только она будет завершена, с помощью сообщения о статусе, которое появится в правом нижнем углу страницы.

Примечание:

Пользователи Windows: используй "Windows CMD" для запуска команд сценария
Пользователи MacOS: используйте терминал

Используй Data Hub для управления данными и учетными данными инфраструктуры AWS

Доступ к импортированным учетным записям

После импорта твоего аккаунта AWS он будет указан как источник данных с именем аккаунта, которое ты указал в " AWS: Imported Accounts" разделе Data Hub. Из этого раздела ты также можешь нажать + Новый аккаунт для импорта нового аккаунта в Data Hub.

Аккаунты, перечисленные в этом разделе, являются источниками данных, которые можно использовать для создания новых моделей Lucidscale. Источники данных ("Аккаунты") содержат метаданные аккаунта AWS, используемые для создания моделей Lucidscale. Поле "Последнее обновление" указывает, когда твой источник данных обновлялся в последний раз, чтобы учесть все обновления в подключённом аккаунте AWS.

Облачную инвентаризацию каждого аккаунта можно увидеть с правой стороны после выбора аккаунта из списка. Эта инвентаризация позволяет тебе увидеть полный подсчёт каждого типа ресурсов, которые были импортированы перед созданием модели. Ты также можешь скачать CSV со списком ресурсов и подсчётом прямо из Data Hub, нажав на кнопку Download CSV.

В инвентаризации перечислены все ресурсы, к которым можно получить доступ с помощью политики разрешений, прикрепленной к роли межучетной записи. Если вы решите использовать функцию «Создать новую роль автоматически» в нашем шаблоне CloudFormation Stack, все ресурсы в вашей учетной записи, доступные в соответствии с политикой AWS ReadOnlyAccess , будут отображаться в инвентаризации. Если роль создается вручную с помощью настраиваемой политики, в инвентаризации будут отображаться только типы ресурсов, указанные в прикрепленной политике разрешений.

Щелкни по меню стремя точками, изображенному на аккаунте, чтобы увидеть шесть потенциальных опций: Создать новую модель, Обновить аккаунт из AWS, Запланировать обновление, Редактировать ресурсы, Переименовать аккаунт и Удалить аккаунт.

Create New Model начнёт рендерить инфраструктуру AWS, связанную с аккаунтом, в виде диаграммы в рабочей области новой модели. Модель будет генерироваться в фоновом режиме на твоей главной странице Lucid, и мы уведомим тебя о её рендеринге с помощью модала состояния, который появится в правом нижнем углу страницы.

Обновление аккаунта из AWS и Обновление по расписанию позволяет тебе вручную или автоматически обновитьдату данных аккаунта AWS, которые ты импортировал в Data Hub, чтобы отразить любые изменения в подключенном аккаунте AWS. Новые модели, созданные из учетной записи после обновления, будут отражать изменения в подключенной учетной записи AWS.

Узнай больше: Для получения дополнительной информации об обновлении аккаунтов из AWS обратись к нашей статье Обновление и синхронизация данных в Lucidscale .

Редактирование ресурсов позволяет тебе редактировать ресурсы, включенные в каждый набор данных. Выбери эту опцию, чтобы открыть модальное окно, в котором ты можешь добавить или удалить любые ресурсы из существующих наборов данных. Когда ты закончишь с выбором, нажми Сохранить и обновить аккаунт. Это гарантирует, что набор данных обновится, и модели, ссылающиеся на этот набор данных, будут обновлены до последней информации.

Rename Account позволяет тебе изменить имя выбранного набора данных.

Delete Account удаляет импортированную учетную запись из Lucid Data Hub, и любые модели, созданные на основе этой учетной записи, потеряют возможность обновлять данные из AWS.

Примечание: Опции, отображаемые выше, будут отличаться в зависимости от метода импорта, который ты использовал для аккаунта. Опция update доступна только при импорте ролей кросс-аккаунтов AWS. Импорт IAM и CLI не поддерживают эту опцию.

Делись и удаляй сохраненные учетные данные

Раздел Saved Credentials в "Data Hub > AWS" lпредставляет собой кросс-аккаунт роли, которые ты можешь использовать для импорта аккаунтов AWS в Data Hub. В этом разделе нажми + New Cross-account role , чтобы добавить новый набор учетных данных, которые можно использовать для импорта учетной записи AWS.

Ты также можешь поделиться созданными тобой межаккаунтными ролями с другими пользователями. Если ты нажмешь на меню с тремя точками, изображенное на учетной записи, ты увидишь две потенциальные опции: Поделиться учетными данными и Удалить учетные данные.

example_of_aws_saved_credentials_page_in_the_lucidscale_data_hub.png

Share credential открывает модальное окно, в котором ты можешь поделиться ролью кросс-аккаунта с другим пользователем твоего аккаунта Lucid, указав его адрес электронной почты. Предоставление им доступа к учетной записи позволит им импортировать связанную учетную запись AWS в Data Hub и создавать модели Lucidscale. После того как учетная запись была предоставлена другому пользователю, ты можешь отозвать его доступ к учетной записи, нажав на X рядом с его адресом электронной почты в том же модале.

Удаление учетной записи удаляет роль кросс-учета из Data Hub. После удаления мандата все аккаунты, которые ранее были импортированы с этим мандатом вместе с моделями, созданными на основе этих аккаунтов , потеряют возможность обновлять данные из AWS.

Узнай больше: Ты можешь делиться учетными данными только в том Data Hub, который принадлежит тебе. Только пользователи Lucidscale, которым назначена лицензия Creator, могут импортировать учетные данные и создавать модели. Более подробную информацию ты можешь найти в нашей статье Управление учетными данными, их использование и безопасность в Lucidscale .

Информация о безопасности

Межаккаунтские роли

Кросс-аккаунт роли - это предпочтительный метод от AWS для предоставления стороннего доступа к твоей учетной записи. Этот метод позволяет Lucidscale безопасно хранить учетные данные, которые позволяют тебе легко обновлять диаграмму. Смотри эти ресурсы для получения дополнительной информации:

Принудительная внешняя идентификация

Следуя лучшим практикам безопасности, предоставляемым AWS, Lucid следит за тем, чтобы внешние идентификаторы оставались уникальными в базе данных Lucid. Поэтому Lucid предоставляет пользователю уникальный внешний идентификатор и запрещает пользователю вводить свой собственный внешний идентификатор.

Безопасный, ограниченный доступ для пользователей IAM

Мы запрашиваем ограниченное разрешение уровня "описать" для созданного тобой IAM-пользователя. Пользователь IAM, созданный с такими правами, не может изменять настройки в твоей инфраструктуре AWS или читать данные в твоих базах данных. Мы используем пользователя IAM только для чтения структурных метаданных твоей инфраструктуры AWS.

Альтернатива сценарию CLI

Если ты хочешь просматривать и контролировать действия, которые мы предпринимаем во время сканирования инфраструктуры AWS, ты можешь загрузить и использовать предоставленный нами Python-скрипт вместо создания IAM-пользователя. В этом сценарии твои учетные данные IAM никогда не будут переданы Lucidscale, и ты сможешь просмотреть как код, который будет выполняться в твоей среде, так и результирующие метаданные, прежде чем загружать их в Lucidscale. Импортированный JSON будет доступен в Lucid Data Hub, чтобы использовать его для создания моделей Lucidscale.

Безопасное хранение документов (модели)

Lucidscale хранит импортированные AWS метаданные и сгенерированные модели с использованием стандартных отраслевых средств защиты конфиденциальных данных. Импортированные данные AWS встраиваются в модель Lucidscale, поэтому вы можете контролировать доступ к данным с помощью стандартных разрешений Lucid на общий доступ. Для получения дополнительной информации о том, как мы защищаем ваши документы, перейдите на нашу страницу «Безопасность контента» или свяжитесь с нашим отделом продаж.

Отсутствие хранения ключей доступа

Lucidscale не будет хранить твои учетные данные AWS IAM после выполнения первоначального сканирования твоей инфраструктуры AWS. Твои учетные данные будут переданы на наши серверы с использованием стандартных методов шифрования. Клиенты могут договариваться о протоколах шифрования вплоть до AES-256. Мы можем хранить Cross-Account Role, которая дает нам только "описать и перечислить" доступ к твоей среде.

Часто задаваемые вопросы

После покупки Lucidscale каждый пользователь на аккаунте будет иметь доступ?

Если ты являешься существующим клиентом Lucid (в настоящее время имеешь подписку на Lucidchart или Lucidspark), то в зависимости от настроек лицензирования возможно, что не все пользователи аккаунта будут иметь доступ к Lucidscale по умолчанию. Администратору аккаунта может понадобиться назначить купленные лицензии Lucidscale отдельным пользователям или группам через раздел "Пользователи" панели администратора таким же образом, как и Lucidchart и Lucidspark. Пользователи, добавленные в аккаунт, у которого есть только подписка Lucidscale Team (без текущих подписок Lucidchart или Lucidspark), будут автоматически назначены на лицензии Creator или Explorer в зависимости от того, какие лицензии были куплены. Инструкции по предоставлению лицензий смотри в Панель администратора Lucid: Настройки лицензий статью.

Как Lucidscale получает доступ к нашей среде AWS? Какой уровень доступа у Lucidscale?

Рекомендуемый метод от Lucidscale и AWS - через Cross-Account Role. Мы предоставляем политику, которая дает нам доступ "описать и перечислить" к твоей среде, чтобы мы могли получить инвентаризацию ресурсов. Учетные данные, хранящиеся в Lucid, могут быть доступны только твоей учетной записи Lucid. Этот метод импорта позволит тебе обновлять данные из учетной записи одним действием. Политика разрешений, которую мы предоставляем, позволяет тебе точно определить, какие данные роль Cross-Account будет иметь доступ для запроса у AWS.

Если ты используешь наш метод IAM-пользователя, учетные данные вообще не хранятся, а используются один раз и отбрасываются. Как правило, наши пользователи используют этот метод импорта вместе с временными учетными данными AWS, так как этот метод не позволяет дополнительно обновлять данные.

У нас также есть метод с использованием скрипта python, который ты можешь запустить через интерфейс командной строки (CLI), который генерирует JSON-файл. После генерации JSON-файла пользователи могут просмотреть его содержимое и при желании удалить данные перед импортом. Затем пользователи могут загрузить этот JSON-файл в Lucidscale и не вводить в Lucidscale никакую учетную информацию.

Как взаимодействуют коммерческий Lucidscale и Lucidscale for Gov при импорте через кросс-аккаунт роли?

Хотя функциональность продукта одинакова для каждого из них, AWS по-разному настраивает безопасность для этих двух сред. Роли AWS IAM и политики на основе ресурсов делегируют доступ между учетными записями только в пределах одного раздела. Lucid GovSuite находится в отдельном разделе AWS, и поэтому не может импортировать данные AWS через кросс-аккаунтную роль из аккаунтов AWS, не относящихся к GovCloud. Перекрёстные роли аккаунтов, рекомендуемый нами метод импорта, разрешают доступ только к аккаунтам одного типа - так, если ты находишься в коммерческой среде Lucid, ты можешь получить доступ и импортировать коммерческие аккаунты облака AWS с помощью перекрёстной роли аккаунтов, а если ты находишься в среде Lucid GovSuite, ты можешь получить доступ и импортировать аккаунты AWS GovCloud с помощью перекрёстной роли аккаунтов.

Мы поддерживаем возможность импорта коммерческих аккаунтов AWS в Lucidscale for Gov через IAM-пользователя или JSON, созданный с помощью нашего CLI-скрипта.

К каким API имеет доступ Lucidscale?

В основном мы используем конечные точки API describe и list.

Можешь ли ты выбрать, какие метаданные (поля и значения, отображаемые на панели "Данные") будут импортированы? Если нет, то какие метаданные импортируются?

Нет, в настоящее время ты не можешь выбирать, какие метаданные будут импортированы. Однако в будущем мы планируем создать некоторую возможность для этого. Импортируются все метаданные из вызова API описания.

Оставьте отзыв об этой статье

Хотите поделиться мнением об этой статье? Расскажи нам о своем опыте здесь.

Похожие статьи