модуль netapp.ontap.na_ontap_vserver_audit – NetApp Ontap — создание, удаление или изменение конфигурации аудита vserver.

Примечание

Этот модуль входит в коллекцию netapp.ontap (версия 23.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install netapp.ontap. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: netapp.ontap.na_ontap_vserver_audit.

Добавлено в netapp.ontap 22.3.0

Краткое описание
Требования
Параметры
Примечания
Примеры

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

Создание, удаление или изменение конфигурации аудита vserver.

Требования

Следующие требования необходимы на узле, где выполняется этот модуль.

Ansible 2.9 или более поздней версии — рекомендуется версия 2.12 или более поздняя.
Python3 — рекомендуется версия 3.9 или более поздняя.
netapp-lib требуется только при использовании ZAPI (установите с помощью «pip install netapp-lib»). Обратите внимание, что netapp-lib устарел и больше не поддерживается. Используйте его на свой страх и риск.
Физическая или виртуальная кластерная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и более поздние версии; для поддержки REST требуется ONTAP 9.6 или более поздняя версия.

Параметры

Параметр	Комментарии
cert_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу сертификата SSL-клиента (.pem). Не поддерживается в Python 2.6.
enabled boolean	Указывает, включён ли аудит для SVM. Варианты: `false` `true`
events dictionary	Указывает события, для которых включён аудит на SVM.
authorization_policy boolean	События изменения политики авторизации. Варианты: `false` `true`
cap_staging boolean	События подготовки центральной политики доступа. Варианты: `false` `true`
cifs_logon_logoff boolean	События входа в систему и выхода из неё CIFS. Варианты: `false` `true`
file_operations boolean	События операций с файлами. Варианты: `false` `true`
file_share boolean	События категории общих файловых ресурсов. Варианты: `false` `true`
security_group boolean	События управления локальными группами безопасности. Варианты: `false` `true`
user_account boolean	События управления локальными учётными записями пользователей. Варианты: `false` `true`
feature_flags dictionary добавлено в netapp.ontap 20.5.0	Включение или отключение новой функции. Этот параметр можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут изменяться без уведомления. Неизвестные ключи игнорируются.
force_ontap_version string добавлено в netapp.ontap 21.23.0	Переопределяет версию ONTAP кластера при использовании REST. Поведение не определено, если указанная версия не соответствует целевому кластеру. Этот параметр предоставляется как обходное решение, когда версию кластера невозможно прочитать из-за проблем с разрешениями. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues. Версия должна иметь формат 9.10 или 9.10.1, где каждый элемент является целым числом.
guarantee boolean	Указывает, действует ли строгая гарантия аудита. Для этого параметра требуется ONTAP 9.10.1 или более поздняя версия. Варианты: `false` `true`
hostname string / обязательный	Имя узла или IP-адрес экземпляра ONTAP.
http_port integer	Переопределяет порт по умолчанию (80 или 443), задавая этот порт.
https boolean	Включение и отключение HTTPS. Игнорируется при использовании REST, поскольку поддерживается только HTTPS. Игнорируется при использовании аутентификации с сертификатом SSL, поскольку для неё требуется SSL. Варианты: `false` ← (по умолчанию) `true`
key_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу ключа SSL-клиента.
log dictionary	Задаёт параметры конфигурации файлов журнала аудита.
format string	Этот параметр задаёт формат журналов, создаваемых в процессе консолидации. Возможные значения: xml — формат журнала XML, специфичный для Data ONTAP evtx — формат журнала Microsoft Windows EVTX Варианты: `"xml"` `"evtx"`
retention dictionary	Этот параметр задаёт количество и срок хранения файла журнала аудита.
count integer	Определяет, сколько файлов журнала аудита следует хранить, прежде чем удалять самый старый файл. Взаимоисключающий параметр с duration.
duration string	Задаёт дату и время хранения файла журнала аудита в формате ISO-8601. Файлы журнала аудита удаляются по достижении указанной даты и времени. Взаимоисключающий параметр с count.
rotation dictionary	Файлы журнала событий аудита ротируются при достижении заданного порогового размера или по заданному расписанию. При ротации файла журнала событий запланированная задача консолидации сначала переименовывает активный преобразованный файл в архивный файл с отметкой времени, а затем создаёт новый активный преобразованный файл журнала событий.
schedule dictionary добавлено в netapp.ontap 22.11.0	Ротирует журналы аудита по расписанию, используя любые сочетания параметров ротации по времени. Расписание ротации вычисляется с учётом всех значений, относящихся ко времени.
days list / элементы=integer	Задаёт дни месяца для ротации журнала аудита. Укажите -1, чтобы ротировать журналы аудита во все дни месяца.
hours list / элементы=integer	Задаёт часы для ротации журнала аудита. Укажите -1, чтобы ротировать журналы аудита каждый час.
minutes list / элементы=integer	Задаёт минуты для ротации журнала аудита.
months list / элементы=integer	Задаёт месяцы для ротации журнала аудита. Укажите -1, чтобы ротировать журналы аудита каждый месяц.
weekdays list / элементы=integer	Задаёт дни недели для ротации журнала аудита. Укажите -1, чтобы ротировать журналы аудита каждый день.
size integer	Ротирует журналы в зависимости от их размера в байтах. Значение по умолчанию — 104857600.
log_path string	Путь назначения для журналов аудита, в котором хранятся консолидированные журналы.
password псевдонимы: pass string	Пароль указанного пользователя.
state string	Определяет, должна ли указанная конфигурация аудита vserver существовать. Варианты: `"present"` ← (по умолчанию) `"absent"`
use_lambda boolean добавлено в netapp.ontap 23.4.0	Указывает, следует ли использовать функциональность прокси AWS Lambda для подключения к системе ONTAP. Поддерживается только с REST. Варианты: `false` ← (по умолчанию) `true`
use_rest string	Этот модуль поддерживает только REST. always — всегда использовать REST API. Если модуль не поддерживает REST, выводится предупреждение. По умолчанию: `"always"`
username псевдонимы: user string	Это может быть учётная запись уровня кластера или уровня SVM — в зависимости от того, требуется ли API уровня кластера или уровня SVM. Дополнительные сведения см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html. Поддерживаются два метода аутентификации: Базовая аутентификация с использованием имени пользователя и пароля. Аутентификация с сертификатом SSL с использованием файла сертификата SSL-клиента и, при необходимости, файла закрытого ключа. Для использования сертификата он должен быть установлен в кластере ONTAP, а аутентификация по сертификату должна быть включена.
validate_certs boolean	Если задано значение `no`, сертификаты SSL не будут проверяться. Задавать это значение следует только для `False` на контролируемых вами сайтах, использующих самоподписанные сертификаты. Варианты: `false` `true` ← (по умолчанию)
vserver string / обязательный	Указывает имя Vserver.

Примечания

Примечание

Этот модуль поддерживает только REST.
Должно быть включено как минимум одно событие.
Если для изменения задан параметр enabled, другие поля указывать нельзя.
Модули с префиксом na_ontap предназначены для поддержки платформы хранения ONTAP.
HTTPS включён по умолчанию и рекомендуется к использованию. Чтобы включить HTTP в кластере, необходимо выполнить следующие команды: ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’

Примеры

- name: Create vserver audit configuration
  netapp.ontap.na_ontap_vserver_audit:
    state: present
    vserver: ansible
    enabled: true
    events:
      authorization_policy: false
      cap_staging: false
      cifs_logon_logoff: true
      file_operations: true
      file_share: false
      security_group: false
      user_account: false
    log_path: "/"
    log:
      format: xml
      retention:
        count: 4
      rotation:
        size: "1048576"
    guarantee: false
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Modify vserver audit configuration
  netapp.ontap.na_ontap_vserver_audit:
    state: present
    vserver: ansible
    enabled: true
    events:
      authorization_policy: true
      cap_staging: true
      cifs_logon_logoff: true
      file_operations: true
      file_share: true
      security_group: true
      user_account: true
    log_path: "/tmp"
    log:
      format: evtx
      retention:
        count: 5
      rotation:
        size: "104857600"
    guarantee: true
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Delete vserver audit configuration
  netapp.ontap.na_ontap_vserver_audit:
    state: absent
    vserver: ansible
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

# The audit logs are rotated in January and March on Monday, Wednesday, and Friday,
# at 6:15, 6:30, 6:45, 12:15, 12:30, 12:45, 18:15, 18:30, and 18:45
# The last 6 audit logs are retained
- name: Create vserver audit configuration
  netapp.ontap.na_ontap_vserver_audit:
    state: present
    vserver: ansible
    enabled: true
    events:
      authorization_policy: false
      cap_staging: false
      cifs_logon_logoff: true
      file_operations: true
      file_share: false
      security_group: false
      user_account: false
    log_path: "/"
    log:
      format: xml
      retention:
        count: 6
      rotation:
        schedule:
          hours: [6, 12, 18]
          minutes: [15, 30, 45]
          months: [1, 3]
          weekdays: [1, 3, 5]
    guarantee: false
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

# The audit logs are rotated monthly, all days of the week, at 12:30
- name: Modify vserver audit configuration
  netapp.ontap.na_ontap_vserver_audit:
    state: present
    vserver: ansible
    enabled: true
    events:
      authorization_policy: false
      cap_staging: false
      cifs_logon_logoff: true
      file_operations: true
      file_share: false
      security_group: false
      user_account: false
    log_path: "/"
    log:
      format: xml
      rotation:
        schedule:
          hours: [12]
          minutes: [30]
          months: [-1]
          weekdays: [-1]
    guarantee: false
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

Авторы

Команда NetApp Ansible (@carchi8py)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/netapp/ontap/na_ontap_vserver_audit_module.html