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

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

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

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

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

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

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

*Тип ресурса 1 — это все сопоставленные ресурсы, перечисленные в разделе Поддерживаемые ресурсы. Тип ресурса 2 — это облачная инвентаризация: широкий спектр неотображенных ресурсов, которые вы можете вручную разместить в своих моделях.
** Пользователи могут настроить автоматическое обновление источника данных по повторяющемуся расписанию (ежедневно, еженедельно, ежемесячно, ежегодно) через концентратор данных. Ручное обновление также выполняется одним щелчком мыши через концентратор данных.

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

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

Заметка: Импорт AWS GovCloud разрешен только клиентами Lucid GovSuite. Коммерческая среда Lucid не может получить доступ к AWS GovCloud через роли кросс-учетной записи.

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

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

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

После того как создание модели Lucidscale будет завершено, вы сможете просмотреть ее в новой вкладке, выбрав ссылку «Открыть модель» в модальном окне статуса. Все сгенерированные модели Lucidscale также будут сохранены и доступны в разделе «документ» на главной странице Lucid после того, как вы их создадите.

modal_confirming_successful_creation_of_aws_lucidscale_model.png

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

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

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

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

Зарегистрируйте новую роль IAM для кросс-учетной записи через концентратор данных Lucid в Lucid для управления импортом на уровне организации. Для этого необходимо выбрать предпочтительного поставщика инфраструктуры как кода (IaC) для автоматической настройки учетной записи в организации для импорта:

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

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

Использование Terraform для автоматической настройки разрешений AWS Organization

Во-первых, убедитесь, что у вас настроен Terraform для учетной записи, в которую вы будете добавлять модули terraform Lucid.

Подробнее: Инструкции см. в этом руководстве Get Started - AWS из документации Terraform. Предоставленная ссылка приведет вас к выходу из справочного центра Lucid, и мы не можем гарантировать точность контента.

Затем настройте и разверните модуль Terraform от Lucid, выполнив следующие действия:

Получите доступ к модулю Lucid Terraform для настройки разрешений, нажав « Просмотр» в реестре Terraform, или получите доступ к модулю напрямую по этой ссылке.
На странице реестра модулей нажмите на « Подмодули». Вы настроите каждый из трех необходимых подмодулей из раскрывающегося списка (org-read-delegation, bastion-role и import-role) в своем main.tf.
Следуйте инструкциям в разделе «Использование» на странице сведений каждого подмодуля, чтобы добавить модуль в код конфигурации Terraform.
- Подмодуль org-read-delegation: настраивает разрешения для Lucid на сканирование структуры вашей организации AWS. Она должна быть развернута в учетной записи управления или учетной записи участника, которой было делегировано управление политиками для организаций.
  - Если политика делегирования на основе ресурсов уже существует, развертывание завершится ошибкой. Вместо того чтобы добавлять этот подмодуль, вручную добавьте разрешения из предоставленной Lucid политики JSON , связанной здесь , с вашей существующей политикой на основе ресурсов.
- Подмодуль bastion-role (англ. bastion-role): создает основную IAM-роль в вашей учетной записи бастиона, которую возьмет на себя Lucid.
  - Задайте параметр external_id, используя уникальное значение «Внешний идентификатор», скопированное со страницы настройки импорта AWS в вашей учетной записи Lucid.
- Подмодуль import-role: создает роль IAM, которая будет развернута в учетной записи участника для чтения данных ресурсов.
  - Этот модуль сам создает одно определение роли в учетной записи бастиона — модуль не может автоматизировать этот процесс для учетной записи участника. Этот модуль необходимо развернуть в каждой учетной записи участника, из которой вы хотите импортировать данные, в том числе всякий раз, когда вы хотите добавить новую учетную запись в свою организацию в будущем. Следуйте стандартным практикам вашей организации, чтобы применить код из этого модуля к вновь добавленной учетной записи.
Разверните свой код Terraform и подождите, пока будут созданы включенные ресурсы из модуля Lucid.
В консоли AWS IAM в учетной записи бастиона скопируйте ARN созданной роли lucid-import-bastion-role (или ее пользовательское имя). Кроме того, вы можете вывести этот ARN из конфигурации Terraform.

Затем вы завершите настройку на вкладке концентратора данных Lucid:

В настройках импорта AWS в Lucid укажите скопированную роль Бастиона ARN.
- Если во время настройки оно было настроено, обновите имя роли учетной записи участника в соответствии с вашей конфигурацией (т. е. параметр role_name в подмодуле import-role).
- При необходимости обновите предварительно заполненное значение для параметра "Отображаемое имя учетных данных". Это отображаемое имя будет использоваться в разделе "Data Hub > AWS > Credentials", чтобы вы могли найти учетные данные для дальнейшего использования и управления, и будет представлять роль бастиона, используемую для координации импорта.
Нажмите «Далее », чтобы зарегистрировать роль кросс-учетной записи в Lucid.
Выберите роль и нажмите кнопку Далее.
Перейдите к шагам по импорту учетной записи и созданию моделей.

Использование CloudFormation для автоматической настройки разрешений AWS Organization

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

Учетная запись AWS должна быть либо учетной записью управления организацией AWS, либо учетной записью делегированного администратора для наборов стеков AWS CloudFormation. Принцип IAM (пользователь или роль), управляющий стеком, должен находиться в пределах вышеупомянутой учетной записи и не должен быть пользователем root.
Кроме того, учетная запись должна быть такой, которая еще не использовалась в качестве бастиона учетной записи в Lucid.

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

Определите следующие три параметра в вашей организации AWS. Это будут ключевые входные данные для первого шаблона стека CloudFormation:
- BastionAccountId: это 12-значный идентификатор учетной записи AWS, который вы хотите использовать для управления доверенным доступом третьих лиц. Lucid возьмет на себя роль кросс-учетной записи в этой «учетной записи-бастионе» для координации импорта.
- BastionRootOrOrganizationalUnitId: это идентификатор организационного подразделения (OU) (например, ou-xxxxxxxxxx) или корня (например, r-xxxx), которое содержит выбранный вами BastionAccountId.
- MembersRootOrOrganizationalUnitId: этот параметр управляет областью учетной записи в вашей организации AWS, из которой Lucid может импортировать данные о ресурсах.
  - Чтобы разрешить импорт из всех учетных записей в вашей организации, используйте идентификатор корня вашей организации (например, r-xxxx).
  - Если вы хотите разрешить импорт только для учетной записи, вложенной в одно конкретное организационное подразделение (OU), используйте идентификатор этого конкретного подразделения (например, ou-xxxxxxxxxx).
После выбора опции CloudFormation для импорта организации запустите первый предоставленный шаблон CloudFormation в консоли AWS и настройте с использованием необходимых параметров, описанных выше.
- Необязательные параметры включают имена для создаваемых ролей (например, MemberRoleName и BastionRoleName). Обратите внимание на все пользовательские имена, которые вы используете.
Нажмите кнопку Создать стек и дождитесь завершения развертывания.
Вернитесь на вкладку Lucid и запустите второй предоставленный шаблон CloudFormation. Вы будете использовать этот шаблон, чтобы позволить роли бастиона идентифицировать учетную запись для импорта, сканируя структуру вашей организации с помощью действий 'list' и 'describe'.
- Если политика делегирования на основе ресурсов уже существует, развертывание завершится ошибкой. Вместо использования этого стека добавьте сюда ResourcePolicy из политики JSON в существующую политику делегирования.
В консоли AWS учетной записи бастиона перейдите в IAM и найдите созданную роль кросс-учетной записи в разделе Роли.
Перейдите на страницу сводки ролей для кросс-учетных записей и скопируйте строку ARN ролей.
Вернитесь на вкладку Lucid data hub и прокрутите вниз до раздела «Добавьте роль кросс-учетной записи в Lucid».
- Введите учетную запись бастиона role ARN в поле "Role ARN".
- Если при настройке первого шаблона CloudFormation вы использовали пользовательский MemberRoleName, обновите поле "Member account record role name" до этого значения.
- (Дополнительный) Обновите предварительно заполненное значение для параметра "Отображаемое имя учетных данных", чтобы оно представляло роль бастиона, используемую для координации импорта. Это отображаемое имя будет использоваться в концентраторе данных Lucid, чтобы вы могли идентифицировать учетные данные для дальнейшего использования и управления.
Нажмите «Далее », чтобы зарегистрировать роль кросс-учетной записи в 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.

Ты можешь открыть модель из модала состояния, который рендерится непосредственно после создания новой модели. Модель (и ранее созданные модели) будет также храниться и будет доступна в разделе "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.

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

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

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

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

Модель можно открыть из модального окна статуса, которое появляется сразу после создания новой модели. Модель (и ранее созданные модели) также будет сохранена и доступна в разделе документов на главной странице 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.
Выберите Создать новую модель.

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

Подробные инструкции по сценарию 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 описания.

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

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

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