validate-logs

Описание

Проверяет журналы CloudTrail за определенный период времени.

Эта команда использует файлы дайджестов, доставленные в ваш ведро S3, для выполнения проверки.

AWS CLI позволяет обнаружить следующие типы изменений:

Изменение или удаление файлов журналов CloudTrail.
Изменение или удаление файлов дайджестов CloudTrail.

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

У вас должен быть онлайн-доступ к AWS.
У вас должен быть доступ для чтения к ведру S3, содержащему файлы дайджестов и журналов.
Файлы дайджестов и журналов не должны быть перемещены из исходного местоположения в S3, куда их доставил CloudTrail.
Для организационных трейлов у вас должен быть доступ к команде describe-organization для проверки файлов дайджестов.

При отключении проверки файлов журналов цепочка файлов дайджестов разрывается через час. CloudTrail не будет создавать дайджесты для файлов журналов, которые были доставлены в период, когда функция проверки файлов журналов была отключена. Например, если вы включите проверку файлов журналов 1 января, отключите её 2 января и снова включите 10 января, дайджесты не будут созданы для файлов журналов, доставленных с 3 по 9 января. То же самое происходит при остановке записи журналов CloudTrail или удалении трейла.

Примечание

Файлы журналов, которые были загружены на локальный диск, не могут быть проверены с помощью AWS CLI. CLI загрузит все файлы журналов каждый раз при выполнении этой команды.

Примечание

Эта команда требует, чтобы роль, выполняющая команду, имела разрешения на вызов ListObjects, GetObject и GetBucketLocation для каждого ведра, указанного в трейле.

Синтаксис

  validate-logs
--trail-arn <value>
--start-time <value>
[--end-time <value>]
[--s3-bucket <value>]
[--s3-prefix <value>]
[--account-id <value>]
[--verbose]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--trail-arn (строка) Указывает ARN трейла, который нужно проверить

--start-time (строка) Указывает, что файлы журналов, доставленные в или после указанной метки времени UTC, будут проверены. Пример: “2015-01-08T05:21:42Z”.

--end-time (строка) Дополнительно указывает, что файлы журналов, доставленные в или до указанной метки времени UTC, будут проверены. Значение по умолчанию — текущее время. Пример: “2015-01-08T12:31:41Z”.

--s3-bucket (строка) Дополнительно указывает ведро S3, в котором хранятся файлы дайджестов. Если имя ведра не указано, CLI получит его, вызвав describe_trails

--s3-prefix (строка) Дополнительно указывает необязательный префикс S3, в котором хранятся файлы дайджестов. Если не указано, CLI определит префикс автоматически, вызвав describe_trails.

--account-id (строка) Дополнительно указывает учётную запись для проверки журналов. Этот параметр необходим для организационных трейлов для проверки журналов конкретной учётной записи внутри организации

--verbose (логическое значение) Отображает подробную информацию о проверке журналов

Глобальные параметры

--debug (логическое значение)

Включить отладку.

--endpoint-url (строка)

Переопределить URL по умолчанию команды на указанный URL.

--no-verify-ssl (логическое значение)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (логическое значение)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования для вывода команд.

json
text
table
yaml
yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определённый профиль из файла credencial.

--region (строка)

Использовать указанный регион. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

on
off
auto

--no-sign-request (логическое значение)

Не подписывать запросы. Кредиты не будут загружены, если этот аргумент указан.

--ca-bundle (строка)

Набор сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет выполняться без блокировки и таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет выполняться без блокировки и таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, отображаемого как двоичный блок fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую независимо от параметра cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного параметра cli-binary-format.

base64
raw-in-base64-out

--no-cli-pager (логическое значение)

Отключить тулбар для вывода.

--cli-auto-prompt (логическое значение)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (логическое значение)

Отключить автоматическое запрошен для параметров ввода CLI.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. См. руководство по началу работы в руководстве пользователя AWS CLI для получения дополнительной информации.

За исключением случаев, когда явно указано иное, все примеры используют правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей консоли. См. Использование кавычек со строками в руководстве пользователя AWS CLI.

Для проверки файла журнала

Следующая validate-logs команда проверяет журналы для Trail1:

aws cloudtrail validate-logs --trail-arn arn:aws:cloudtrail:us-east-1:123456789012:trail/Trail1 --start-time 20160129T19:00:00Z

Вывод:

Validating log files for trail arn:aws:cloudtrail:us-east-1:123456789012:trail/Trail1 between 2016-01-29T19:00:00Z and 2016-01-29T22:15:43Z
Results requested for 2016-01-29T19:00:00Z to 2016-01-29T22:15:43Z
Results found for 2016-01-29T19:24:57Z to 2016-01-29T21:24:57Z:
3/3 digest files valid
15/15 log files valid