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

Примечание

Этот плагин входит в коллекцию community.windows (версия 1.2.0).

Для его установки используйте: ansible-galaxy collection install community.windows

Чтобы использовать его в книге задач, укажите: community.windows.win_audit_rule

Краткое описание
Параметры
См. также
Примеры
Возвращаемые значения

Краткое описание

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
audit_flags список / элементы=строка / обязательный	Варианты: Failure Success	Определяет, записывать ли события при ошибке, успехе или обоих случаях. Для записи событий при обоих случаях укажите через запятую "Success, Failure".
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 строка / обязательный		Пользователь или группа, для которых настраиваются правила.

См. также

community.windows.win_audit_policy_system: Официальная документация по модулю community.windows.win_audit_policy_system.

Примеры

- name: Add filesystem audit rule for a folder
  community.windows.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
  community.windows.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
  community.windows.win_audit_rule:
    path: HKLM:\software
    user: BUILTIN\Users
    rights: delete
    audit_flags: 'success'

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

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

Возвращаемые значения

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

Ключ	Возвращаемое значение	Описание
current_audit_rules словарь	всегда	Текущие правила для указанного path Возвращает "Нет правил аудита для path" Пример: { "audit_flags": "Success", "user": "Все пользователи", "inheritance_flags": "False", "is_inherited": "False", "propagation_flags": "None", "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.10/collections/community/windows/win_audit_rule_module.html