События в аудит-логах
В аудит-логах событие — это запись об операции создания, изменения или удаления с ресурсами и сущностями. Также в аудит-логи записывается чтение чувствительных данных — паролей, сертификатов и т. п.
Событие имеет фиксированную структуру и может быть разных типов.
Структура события
Событие имеет JSON-структуру:
{
"event_saved_time": "string",
"event_id": "string",
"event_type": "string",
"event_time": "string",
"status": "string",
"error_code": "string",
"request_id": "string",
"subject": {
"subject_id": "string",
"subject_type": "string",
"subject_name": "string",
"subject_auth_provider": "string",
"subject_is_authorized": boolean,
"subject_authorized_by": ["string", "string"],
"subject_credentials_fingerprint": "string"
},
"resource": {
"resource_id": "string",
"resource_type": "string",
"resource_name": "string",
"resource_account_id": "string",
"resource_project_id": "string",
"resource_location": "string",
"resource_changes_old_values": {},
"resource_changes_new_values": {}
}
},
"source_type": {"string"},
"request": {
"request_remote_address": "string",
"request_user_agent": "string",
"request_type": "string",
"request_path": "string",
"request_method": "string",
"request_parameters": "string"
},
"schema_version": "1.0"
}
Некоторые поля являются необязательными и могут отсутствовать в событии. Также у некоторых полей есть зарезервированные значения.
Поля события
Зарезервированные значения
Если значение поля не может быть определено сервисами-источниками логов — например, если в процессе выполнения действия возникла ошибка или объект еще не создан и отсутствует resource_id
, — используется зарезервированное значение undefined
.
Оно может быть указано у полей:
subject_id
;subject_type
;resource_id
;resource_type
;resource_account_id
.
Типы событий (event_type)
В аудит-логах типы событий сгруппированы по сервисам, которые отвечают за разные части продуктов. С помощью сервисов вы можете фильтровать события в выгрузке логов через панель управления и Audit Logs API.
Список продуктов, которые поддерживают аудит-логи, сервисов и типов событий будет пополняться.
Сервис iam
Отвечает за операции в аккаунте, с пользователями, проектами и доступами. Управлять некоторыми из них (например, пользователями и их ключами) можно через IAM API.
*
В этих событиях детальная информация о субъекте предоставляется в парном событии аутентификации.
В нем события с типом iam.account.init_action
объединены с основным событием через поле request_id
.
Сервис secrets
Отвечает за секреты в менеджере секретов. Управлять секретами можно через Secrets API.
Сервис certificates
Отвечает за сертификаты в менеджере секретов. Управлять пользовательскими сертификатами можно через User Certificates API, а Let’s Encrypt® сертификатами — через Let’s Encrypt® Certificates API.
Сервис audit_logs
Отвечает за операции с аудит-логами.
Сервис legal
Отвечает за операции с заказчиком по договору — платящим лицом.
Сервис billing
Отвечает за операции, которые происходят с ресурсами при отсрочке платежа, неоплате или погашении задолженности.
В событиях сервиса billing
детальная информация о субъекте предоставляется в парном событии аутентификации.
В нем события с типом iam.account.init_action
объединены с основным событием через поле request_id
.
Сервис cloud_network
Отвечает за операции с сетями облачной платформы.
Сервис cloud_logging
Отвечает за операции в платформе логов. Управлять платформой логов можно через Cloud Logging API.
Сервис quota_manager
Отвечает за операции с квотами проекта. Управлять квотами можно через Quota Management API.
Сервис cloud_compute
Отвечает за операции с облачными серверами.
Сервис cloud_blockstorage
Отвечает за операции с сетевыми дисками облачного сервера.
Сервис cloud_filestorage
Отвечает за операции с файловым хранилищем.
Сервис cloud_load_balancer
Отвечает за операции с облачными балансировщиками нагрузки.
Сервис global_router
Отвечает за операции с глобальным роутером.