Ресурс aws_iam_policies

[править на GitHub]

Используйте ресурс проверки InSpec aws_iam_policies для проверки свойств набора AWS IAM политик.

Синтаксис

aws_iam_policies Ресурс возвращает набор IAM политик и позволяет проверять этот набор.

describe aws_iam_policies do
  its('policy_names') { should include('test-policy-1') }
end

Параметры

only_attached (необязательно)

Этот ресурс позволяет фильтровать по only_attached. Когда OnlyAttached равно true, возвращаемый список содержит только политики, прикрепленные к пользователю, группе или роли IAM. Когда OnlyAttached равно false, или когда параметр не указан, возвращаются все политики.

scope (необязательно)

Этот ресурс позволяет фильтровать по scope. Чтобы отобразить только управляемые AWS политики, установите Scope в AWS. Чтобы отобразить только управляемые пользователем политики в вашей учетной записи AWS, установите Scope в Local. Если scope не задан, возвращаются ALL политики.

См. также документацию AWS по IAM политике.

Свойства

Свойство	Описание
arns	Идентификатор ARN указанной политики.
policy_ids	Идентификаторы политик.
policy_names	Названия политик.
attachment_counts	Количество прикрепленных сущностей для каждой политики.
attached_groups	Список имен групп, прикрепленных к каждой политике.
attached_roles	Список имен ролей, прикрепленных к каждой политике.
attached_users	Список имен пользователей, прикрепленных к каждой политике.
default_version_ids	Значение ‘default_version_id’ каждой политики.
entries	Предоставляет доступ к исходным результатам запроса, которые можно рассматривать как массив хэшей.

Примеры

Обеспечить существование политики

describe aws_iam_policies do
  its('policy_names') { should include('test-policy-1') }
end

Разрешить не более 100 IAM политик в учетной записи

describe aws_iam_policies do
  its('entries.count') { should be <= 100}
end

Сопоставители

Полный список доступных сопоставителей см. на нашей странице сопоставителей.

exist

Управление будет передано, если описание вернет по крайней мере один результат.

Используйте should_not для проверки того, что сущность не должна существовать.

describe aws_iam_policies.where( <property>: <value>) do
  it { should exist }
end

describe aws_iam_policies.where( <property>: <value>) do
  it { should_not exist }
end

Разрешения AWS

Вашему Принципалу потребуется действие iam:ListPolicies с эффектом Allow.

Подробную документацию можно найти по адресу Действия, ресурсы и ключи условий для управления удостоверениями и доступом.