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	Варианты: Нет ← 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	Варианты: present ← absent	Нужно ли правило `present` или `absent`. Для absent, требуются только path, user и state. Указание `absent` удалит все правила, соответствующие указанному user.
user обязательно		Пользователь или группа, для которых необходимо настроить правила.

Примеры

- 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": "Нет", "rights": "Удаление" }
path_type строка	всегда	Тип path, на который нацелены настройки. Будет одним из: файл, каталог, реестр.

Статус

Этот модуль помечен как предварительный просмотр, что означает, что гарантии обратной совместимости интерфейса нет.

Автор

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.5/modules/win_audit_rule_module.html