win_audit_rule – Добавляет правило аудита к файлам, папкам или ключам реестра

Новое в версии 2.5.

Описание
Параметры
См. также
Примеры
Значения возврата
Статус

Описание

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
audit_flags список / обязательно	Варианты: Ошибка Успех	Определяет, регистрировать ли ошибку, успех или оба. Для регистрации обоих определить как список, разделённый запятыми: «Успех, Ошибка».
inheritance_flags список	Варианты: ContainerInherit ObjectInherit Значение по умолчанию: "ContainerInherit,ObjectInherit"	Определяет, какие объекты внутри папки или ключа реестра унаследуют настройки. Если вы устанавливаете правило для файла, это значение должно быть изменено на `none`. Для получения дополнительной информации о вариантах см. перечисление MSDN PropagationFlags по адресу https://msdn.microsoft.com/en-us/library/system.security.accesscontrol.inheritanceflags.aspx.
path путь / обязательно		Путь к файлу, папке или ключу реестра. Пути к реестру должны быть в формате PowerShell, начиная с аббревиатуры для корня, например, `HKLM:\Software`. псевдонимы: dest, destination
propagation_flags -	Варианты: None ← InherityOnly NoPropagateInherit	Флаг распространения для правил аудита. Это значение игнорируется, когда тип пути — файл. Для получения дополнительной информации о вариантах см. перечисление MSDN PropagationFlags по адресу https://msdn.microsoft.com/en-us/library/system.security.accesscontrol.propagationflags.aspx.
rights список / обязательно		Список прав, разделённых запятыми. Требуется только для добавления правила. Если path — файл или каталог, права могут быть любыми правами в MSDN FileSystemRights https://msdn.microsoft.com/en-us/library/system.security.accesscontrol.filesystemrights.aspx. Если path — ключ реестра, права могут быть любыми правами в MSDN RegistryRights https://msdn.microsoft.com/en-us/library/system.security.accesscontrol.registryrights.aspx.
state строка	Варианты: absent present ←	Указывает, должно ли правило быть `present` или `absent`. Для absent требуются только path, user и state. Указание `absent` удалит все правила, соответствующие заданному user.
user строка / обязательно		Пользователь или группа, для которых нужно настроить правила.

См. также

win_audit_policy_system – Используется для внесения изменений в политику аудита системы: Официальная документация по модулю win_audit_policy_system.

Примеры

- name: Add filesystem audit rule for a folder
  win_audit_rule:
    path: C:\inetpub\wwwroot\website
    user: BUILTIN\Users
    rights: write,delete,changepermissions
    audit_flags: success,failure
    inheritance_flags: ContainerInherit,ObjectInherit

- name: Add filesystem audit rule for a file
  win_audit_rule:
    path: C:\inetpub\wwwroot\website\web.config
    user: BUILTIN\Users
    rights: write,delete,changepermissions
    audit_flags: success,failure
    inheritance_flags: None

- name: Add registry audit rule
  win_audit_rule:
    path: HKLM:\software
    user: BUILTIN\Users
    rights: delete
    audit_flags: 'success'

- name: Remove filesystem audit rule
  win_audit_rule:
    path: C:\inetpub\wwwroot\website
    user: BUILTIN\Users
    state: absent

- name: Remove registry audit rule
  win_audit_rule:
    path: HKLM:\software
    user: BUILTIN\Users
    state: absent

Значения возврата

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

Ключ	Возвращаемое значение	Описание
current_audit_rules словарь	всегда	Текущие правила для заданного path Вернёт «Правила аудита для path не определены» Пример: { "audit_flags": "Успех", "user": "Все пользователи", "inheritance_flags": "Ложь", "is_inherited": "Ложь", "propagation_flags": "None", "rights": "Удалить" }
path_type строка	всегда	Тип path, на который нацелены настройки. Будет одним из: файл, каталог, реестр.

Статус

Интерфейс этого модуля не гарантируется как обратной совместимости. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Noah Sparks (@nwsparks)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/win_audit_rule_module.html