Spec-Zone.ru › Ansible

Модуль netapp.storagegrid.na_sg_grid_audit_destination – настройка назначений журналов аудита в StorageGRID.

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install netapp.storagegrid.

Чтобы использовать её в плейбуке, укажите: netapp.storagegrid.na_sg_grid_audit_destination.

Новое в netapp.storagegrid 21.15.0

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

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

  • Настройка назначений журналов аудита в NetApp StorageGRID.

Параметры

Параметр

Комментарии

api_url

string / обязательно

URL REST API узла администрирования StorageGRID.

auth_token

string / обязательно

Токен авторизации для запроса API

defaults

dictionary

Параметры по умолчанию будут использоваться для настройки назначений аудита на всех узлах, отсутствующих в массиве nodes.

admin_nodes

dictionary

Настройка традиционного экспорта журналов аудита на узлы администрирования.

enabled

boolean

Если значение равно true, традиционный экспорт журналов аудита на узлы администрирования включен.

Варианты:

  • false
  • true ← (по умолчанию)

remote_syslog_server

dictionary

Настройка отправки журналов аудита на внешний сервер syslog.

access_logs_facility

integer

добавлено в netapp.storagegrid 21.16.0

Код facility syslog для журналов доступа, отправляемых на внешний сервер syslog, или -1 для сохранения локального кода facility.

По умолчанию: -1

access_logs_send

boolean

добавлено в netapp.storagegrid 21.16.0

Если значение равно true, журналы доступа отправляются на внешний сервер syslog.

Варианты:

  • false
  • true ← (по умолчанию)

access_logs_severity

integer

добавлено в netapp.storagegrid 21.16.0

Уровень серьезности syslog для журналов доступа, отправляемых на внешний сервер syslog, или -1 для сохранения локального уровня серьезности.

По умолчанию: -1

application_logs_facility

integer

Код facility syslog для журналов приложений, отправляемых на внешний сервер syslog, или -1 для сохранения локального кода facility.

По умолчанию: -1

application_logs_send

boolean

Если значение равно true, журналы приложений отправляются на внешний сервер syslog.

Варианты:

  • false
  • true ← (по умолчанию)

application_logs_severity

integer

Уровень серьезности syslog для журналов приложений, отправляемых на внешний сервер syslog, или -1 для сохранения локального уровня серьезности.

По умолчанию: -1

audit_logs_facility

integer

Код facility syslog для журналов аудита, отправляемых на внешний сервер syslog, или -1 для сохранения локального кода facility.

По умолчанию: 23

audit_logs_send

boolean

Если значение равно true, журналы аудита отправляются на внешний сервер syslog.

Варианты:

  • false
  • true ← (по умолчанию)

audit_logs_severity

integer

Уровень серьезности syslog для журналов аудита, отправляемых на внешний сервер syslog, или -1 для сохранения локального уровня серьезности.

По умолчанию: 6

auth_events_facility

integer

Код facility syslog для событий безопасности, отправляемых на внешний сервер syslog, или -1 для сохранения локального кода facility.

По умолчанию: -1

auth_events_send

boolean

Если значение равно true, события безопасности отправляются на внешний сервер syslog.

Варианты:

  • false
  • true ← (по умолчанию)

auth_events_severity

integer

Уровень серьезности syslog для событий безопасности, отправляемых на внешний сервер syslog, или -1 для сохранения локального уровня серьезности.

По умолчанию: -1

client_cert

string

Сертификат клиента для аутентификации на внешнем сервере syslog (в кодировке PEM).

client_key

string

Закрытый ключ сертификата клиента (в кодировке PEM).

Если ключ зашифрован, необходимо использовать традиционный формат (формат PKCS использовать нельзя

client_key_passphrase

string

Парольная фраза для расшифровки закрытого ключа клиента; не указывайте ее, если закрытый ключ не зашифрован.

enabled

boolean

Если значение равно true, назначение для внешнего сервера syslog включено.

Варианты:

  • false ← (по умолчанию)
  • true

hostname

string / обязательно

IP-адрес или DNS-имя хоста, на который следует отправлять сообщения syslog.

insecure_TLS

boolean

Флаг, разрешающий небезопасное использование Transport Layer Security (TLS) для подключений к внешнему серверу syslog.

Варианты:

  • false ← (по умолчанию)
  • true

port

integer

Номер порта, на который следует отправлять сообщения syslog.

По умолчанию: 514

protocol

string

IP-протокол для отправки данных на внешний сервер syslog.

Варианты:

  • "udp" ← (по умолчанию)
  • "tcp"
  • "tls"
  • "relp+tcp"
  • "relp+tls"

server_ca_cert

string

Один или несколько доверенных сертификатов CA для проверки внешнего сервера syslog (в кодировке PEM).

Если параметр не указан, будут использоваться сертификаты CA операционной системы.

tls_configuration_parameters

string

Команды конфигурации OpenSSL, используемые только когда protocol имеет значение tls.

remote_syslog_server_test

dictionary

Настройка отправки тестовых сообщений аудита на внешний сервер syslog.

access_logs_facility

integer

добавлено в netapp.storagegrid 21.16.0

Код facility syslog для журналов доступа, отправляемых на внешний сервер syslog, или -1 для сохранения локального кода facility.

По умолчанию: -1

access_logs_send

boolean

добавлено в netapp.storagegrid 21.16.0

Если значение равно true, журналы доступа отправляются на внешний сервер syslog.

Варианты:

  • false
  • true ← (по умолчанию)

access_logs_severity

integer

добавлено в netapp.storagegrid 21.16.0

Уровень серьезности syslog для журналов доступа, отправляемых на внешний сервер syslog, или -1 для сохранения локального уровня серьезности.

По умолчанию: -1

application_logs_facility

integer

Код facility syslog для журналов приложений, отправляемых на внешний сервер syslog, или -1 для сохранения локального кода facility.

По умолчанию: -1

application_logs_send

boolean

Если значение равно true, журналы приложений отправляются на внешний сервер syslog.

Варианты:

  • false
  • true ← (по умолчанию)

application_logs_severity

integer

Уровень серьезности syslog для журналов приложений, отправляемых на внешний сервер syslog, или -1 для сохранения локального уровня серьезности.

По умолчанию: -1

audit_logs_facility

integer

Код facility syslog для журналов аудита, отправляемых на внешний сервер syslog, или -1 для сохранения локального кода facility.

По умолчанию: 23

audit_logs_send

boolean

Если значение равно true, журналы аудита отправляются на внешний сервер syslog.

Варианты:

  • false
  • true ← (по умолчанию)

audit_logs_severity

integer

Уровень серьезности syslog для журналов аудита, отправляемых на внешний сервер syslog, или -1 для сохранения локального уровня серьезности.

По умолчанию: 6

auth_events_facility

integer

Код facility syslog для событий безопасности, отправляемых на внешний сервер syslog, или -1 для сохранения локального кода facility.

По умолчанию: -1

auth_events_send

boolean

Если значение равно true, события безопасности отправляются на внешний сервер syslog.

Варианты:

  • false
  • true ← (по умолчанию)

auth_events_severity

integer

Уровень серьезности syslog для событий безопасности, отправляемых на внешний сервер syslog, или -1 для сохранения локального уровня серьезности.

По умолчанию: -1

client_cert

string

Сертификат клиента для аутентификации на внешнем сервере syslog (в кодировке PEM).

client_key

string

Закрытый ключ сертификата клиента (в кодировке PEM).

Если ключ зашифрован, необходимо использовать традиционный формат (формат PKCS использовать нельзя

client_key_passphrase

string

Парольная фраза для расшифровки закрытого ключа клиента; не указывайте ее, если закрытый ключ не зашифрован.

enabled

boolean

Если значение равно true, назначение для внешнего сервера syslog включено.

Варианты:

  • false ← (по умолчанию)
  • true

hostname

string / обязательно

IP-адрес или DNS-имя хоста, на который следует отправлять сообщения syslog.

insecure_TLS

boolean

Флаг, разрешающий небезопасное использование Transport Layer Security (TLS) для подключений к внешнему серверу syslog.

Варианты:

  • false ← (по умолчанию)
  • true

port

integer

Номер порта, на который следует отправлять сообщения syslog.

По умолчанию: 514

protocol

string

IP-протокол для отправки данных на внешний сервер syslog.

Варианты:

  • "udp" ← (по умолчанию)
  • "tcp"
  • "tls"
  • "relp+tcp"
  • "relp+tls"

server_ca_cert

string

Один или несколько доверенных сертификатов CA для проверки внешнего сервера syslog (в кодировке PEM).

Если параметр не указан, будут использоваться сертификаты CA операционной системы.

tls_configuration_parameters

string

Команды настройки OpenSSL, используются только если protocol имеет значение tls.

nodes

list / elements=dictionary

Необязательные параметры конфигурации для отдельных узлов в массиве nodes переопределяют конфигурацию по умолчанию.

admin_nodes

dictionary

Конфигурация традиционного экспорта журналов аудита на узлы администрирования.

enabled

boolean

Если значение равно true, традиционный экспорт журналов аудита на узлы администрирования включен.

Варианты:

  • false
  • true ← (по умолчанию)

node_id

string

Необязательное сопоставление UUID узлов с конфигурациями назначения их журналов аудита.

remote_syslog_server

dictionary

Конфигурация отправки журналов аудита на внешний сервер syslog.

access_logs_facility

integer

добавлено в netapp.storagegrid 21.16.0

Объект syslog для журналов доступа, отправляемых на внешний сервер syslog, или -1, чтобы сохранить локальный объект.

По умолчанию: -1

access_logs_send

boolean

добавлено в netapp.storagegrid 21.16.0

Если значение равно true, журналы доступа отправляются на внешний сервер syslog.

Варианты:

  • false
  • true ← (по умолчанию)

access_logs_severity

integer

добавлено в netapp.storagegrid 21.16.0

Уровень важности syslog для журналов доступа, отправляемых на внешний сервер syslog, или -1, чтобы сохранить локальный уровень важности.

По умолчанию: -1

application_logs_facility

integer

Объект syslog для журналов приложений, отправляемых на внешний сервер syslog, или -1, чтобы сохранить локальный объект.

По умолчанию: -1

application_logs_send

boolean

Если значение равно true, журналы приложений отправляются на внешний сервер syslog.

Варианты:

  • false
  • true ← (по умолчанию)

application_logs_severity

integer

Уровень важности syslog для журналов приложений, отправляемых на внешний сервер syslog, или -1, чтобы сохранить локальный уровень важности.

По умолчанию: -1

audit_logs_facility

integer

Объект syslog для журналов аудита, отправляемых на внешний сервер syslog, или -1, чтобы сохранить локальный объект.

По умолчанию: 23

audit_logs_send

boolean

Если значение равно true, журналы аудита отправляются на внешний сервер syslog.

Варианты:

  • false
  • true ← (по умолчанию)

audit_logs_severity

integer

Уровень важности syslog для журналов аудита, отправляемых на внешний сервер syslog, или -1, чтобы сохранить локальный уровень важности.

По умолчанию: 6

auth_events_facility

integer

Объект syslog для событий безопасности, отправляемых на внешний сервер syslog, или -1, чтобы сохранить локальный объект.

По умолчанию: -1

auth_events_send

boolean

Если значение равно true, события безопасности отправляются на внешний сервер syslog.

Варианты:

  • false
  • true ← (по умолчанию)

auth_events_severity

integer

Уровень важности syslog для событий безопасности, отправляемых на внешний сервер syslog, или -1, чтобы сохранить локальный уровень важности.

По умолчанию: -1

client_cert

string

Сертификат клиента для аутентификации на внешнем сервере syslog (в кодировке PEM).

client_key

string

Закрытый ключ сертификата клиента (в кодировке PEM).

Если ключ зашифрован, необходимо использовать традиционный формат (нельзя использовать PKCS

client_key_passphrase

string

Парольная фраза для расшифровки закрытого ключа клиента; если закрытый ключ не зашифрован, не указывайте парольную фразу.

enabled

boolean

Если значение равно true, назначение на внешний сервер syslog включено.

Варианты:

  • false ← (по умолчанию)
  • true

hostname

string / обязательный параметр

IP-адрес или DNS-имя узла, на который отправляются сообщения syslog.

insecure_TLS

boolean

Флаг, разрешающий небезопасное использование протокола Transport Layer Security (TLS) для подключений к внешнему серверу syslog.

Варианты:

  • false ← (по умолчанию)
  • true

port

integer

Номер порта, на который отправляются сообщения syslog.

По умолчанию: 514

protocol

string

IP-протокол для отправки данных на внешний сервер syslog.

Варианты:

  • "udp" ← (по умолчанию)
  • "tcp"
  • "tls"
  • "relp+tcp"
  • "relp+tls"

server_ca_cert

string

Один или несколько доверенных сертификатов CA для проверки внешнего сервера syslog (в кодировке PEM).

Если параметр не указан, будут использоваться сертификаты CA операционной системы.

tls_configuration_parameters

string

Команды настройки OpenSSL, используются только если protocol имеет значение tls.

remote_syslog_server_test

dictionary

Конфигурация отправки тестовых сообщений аудита на внешний сервер syslog.

access_logs_facility

integer

добавлено в netapp.storagegrid 21.16.0

Объект syslog для журналов доступа, отправляемых на внешний сервер syslog, или -1, чтобы сохранить локальный объект.

По умолчанию: -1

access_logs_send

boolean

добавлено в netapp.storagegrid 21.16.0

Если значение равно true, журналы доступа отправляются на внешний сервер syslog.

Варианты:

  • false
  • true ← (по умолчанию)

access_logs_severity

integer

добавлено в netapp.storagegrid 21.16.0

Уровень важности syslog для журналов доступа, отправляемых на внешний сервер syslog, или -1, чтобы сохранить локальный уровень важности.

По умолчанию: -1

application_logs_facility

integer

Объект syslog для журналов приложений, отправляемых на внешний сервер syslog, или -1, чтобы сохранить локальный объект.

По умолчанию: -1

application_logs_send

boolean

Если значение равно true, журналы приложений отправляются на внешний сервер syslog.

Варианты:

  • false
  • true ← (по умолчанию)

application_logs_severity

integer

Уровень важности syslog для журналов приложений, отправляемых на внешний сервер syslog, или -1, чтобы сохранить локальный уровень важности.

По умолчанию: -1

audit_logs_facility

integer

Объект syslog для журналов аудита, отправляемых на внешний сервер syslog, или -1, чтобы сохранить локальный объект.

По умолчанию: 23

audit_logs_send

boolean

Если значение равно true, журналы аудита отправляются на внешний сервер syslog.

Варианты:

  • false
  • true ← (по умолчанию)

audit_logs_severity

integer

Уровень важности syslog для журналов аудита, отправляемых на внешний сервер syslog, или -1, чтобы сохранить локальный уровень важности.

По умолчанию: 6

auth_events_facility

integer

Объект syslog для событий безопасности, отправляемых на внешний сервер syslog, или -1, чтобы сохранить локальный объект.

По умолчанию: -1

auth_events_send

boolean

Если значение равно true, события безопасности отправляются на внешний сервер syslog.

Варианты:

  • false
  • true ← (по умолчанию)

auth_events_severity

integer

Уровень важности syslog для событий безопасности, отправляемых на внешний сервер syslog, или -1, чтобы сохранить локальный уровень важности.

По умолчанию: -1

client_cert

string

Сертификат клиента для аутентификации на внешнем сервере syslog (в кодировке PEM).

client_key

string

Закрытый ключ сертификата клиента (в кодировке PEM).

Если ключ зашифрован, необходимо использовать традиционный формат (нельзя использовать PKCS

client_key_passphrase

string

Парольная фраза для расшифровки закрытого ключа клиента; если закрытый ключ не зашифрован, не указывайте парольную фразу.

enabled

boolean

Если значение равно true, назначение на внешний сервер syslog включено.

Варианты:

  • false ← (по умолчанию)
  • true

hostname

string / обязательный параметр

IP-адрес или DNS-имя узла, на который отправляются сообщения syslog.

insecure_TLS

boolean

Флаг, разрешающий небезопасное использование протокола Transport Layer Security (TLS) для подключений к внешнему серверу syslog.

Варианты:

  • false ← (по умолчанию)
  • true

port

integer

Номер порта, на который отправляются сообщения syslog.

По умолчанию: 514

protocol

string

IP-протокол для отправки данных на внешний сервер syslog.

Варианты:

  • "udp" ← (по умолчанию)
  • "tcp"
  • "tls"
  • "relp+tcp"
  • "relp+tls"

server_ca_cert

string

Один или несколько доверенных сертификатов CA для проверки внешнего сервера syslog (в кодировке PEM).

Если не указано, будут использоваться сертификаты CA операционной системы.

tls_configuration_parameters

string

Команды конфигурации OpenSSL, используемые только если protocol — tls.

state

string

Целевое расположение аудита должно присутствовать.

Варианты:

  • "present" ← (по умолчанию)

validate_certs

boolean

Следует ли проверять сертификаты HTTPS?

Варианты:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

  • Модули с префиксом na_sg предназначены для управления NetApp StorageGRID.

Примеры

- name: Configure audit destination defaults
  netapp.storagegrid.na_sg_grid_audit_destination:
    state: present
    api_url: "https://gmi.example.com"
    auth_token: "01234567-5678-9abc-78de-9fgabc123def"
    validate_certs: false
    defaults:
      admin_nodes:
        enabled: true
      remote_syslog_server:
        enabled: true
        protocol: udp
        hostname: "syslog.example.com"
        port: 514
        auth_events_send: true
        auth_events_facility: -1
        auth_events_severity: -1
        audit_logs_send: true
        audit_logs_facility: 23
        audit_logs_severity: 6
        application_logs_send: true
        application_logs_facility: -1
        application_logs_severity: -1
        access_logs_send: true
        access_logs_facility: -1
        access_logs_severity: -1

- name: Configure audit destination for specific nodes
  netapp.storagegrid.na_sg_grid_audit_destination:
    state: present
    api_url: "https://gmi.example.com"
    auth_token: "01234567-5678-9abc-78de-9fgabc123def"
    validate_certs: false
    nodes:
      - node_id: "6562d5d8-f218-45ff-a466-5bb39e729288"
        admin_nodes:
          enabled: true
        remote_syslog_server:
          enabled: true
          protocol: udp
          hostname: "syslog.example.com"
          port: 514
          auth_events_send: true
          auth_events_facility: -1
          auth_events_severity: -1
          audit_logs_send: true
          audit_logs_facility: 23
          audit_logs_severity: 6
          application_logs_send: true
          application_logs_facility: -1
          application_logs_severity: -1
          access_logs_send: true
          access_logs_facility: -1
          access_logs_severity: -1

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

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

Ключ

Описание

resp

dictionary

Возвращает сведения о целевом расположении аудита StorageGRID.

Возвращается: Если state имеет значение ‘present’.

Пример: {"defaults": {"adminNodes": {"enabled": true}, "remoteSyslogServerA": {"accessLogsFacility": -1, "accessLogsSend": true, "accessLogsSeverity": -1, "applicationLogsFacility": -1, "applicationLogsSend": true, "applicationLogsSeverity": -1, "auditLogsFacility": 23, "auditLogsSend": true, "auditLogsSeverity": 6, "authEventsFacility": -1, "authEventsSend": true, "authEventsSeverity": -1, "clientCert": "<Client certificate in PEM-encoding>", "clientKey": "<Client private key in PEM-encoding>", "clientKeyPassphrase": "<Client private key passphrase>", "enabled": true, "hostname": "syslog.example.com", "insecureTLS": false, "port": 514, "protocol": "tls", "serverCaCert": "<CA bundle in PEM-encoding>", "tlsConfigurationParameters": "<OpenSSL configuration commands>"}, "remoteSyslogServerATest": {"accessLogsFacility": -1, "accessLogsSend": true, "accessLogsSeverity": -1, "applicationLogsFacility": -1, "applicationLogsSend": true, "applicationLogsSeverity": -1, "auditLogsFacility": 23, "auditLogsSend": true, "auditLogsSeverity": 6, "authEventsFacility": -1, "authEventsSend": true, "authEventsSeverity": -1, "clientCert": "<Client certificate in PEM-encoding>", "clientKey": "<Client private key in PEM-encoding>", "clientKeyPassphrase": "<Client private key passphrase>", "enabled": true, "hostname": "syslog.example.com", "insecureTLS": false, "port": 514, "protocol": "tls", "serverCaCert": "<CA bundle in PEM-encoding>", "tlsConfigurationParameters": "<OpenSSL configuration commands>"}}, "nodes": {"6562d5d8-f218-45ff-a466-5bb39e729288": {"adminNodes": {"enabled": true}, "remoteSyslogServerA": {"accessLogsFacility": -1, "accessLogsSend": true, "accessLogsSeverity": -1, "applicationLogsFacility": -1, "applicationLogsSend": true, "applicationLogsSeverity": -1, "auditLogsFacility": 23, "auditLogsSend": true, "auditLogsSeverity": 6, "authEventsFacility": -1, "authEventsSend": true, "authEventsSeverity": -1, "clientCert": "<Client certificate in PEM-encoding>", "clientKey": "<Client private key in PEM-encoding>", "clientKeyPassphrase": "<Client private key passphrase>", "enabled": true, "hostname": "syslog.example.com", "insecureTLS": false, "port": 514, "protocol": "tls", "serverCaCert": "<CA bundle in PEM-encoding>", "tlsConfigurationParameters": "<OpenSSL configuration commands>"}, "remoteSyslogServerATest": {"accessLogsFacility": -1, "accessLogsSend": true, "accessLogsSeverity": -1, "applicationLogsFacility": -1, "applicationLogsSend": true, "applicationLogsSeverity": -1, "auditLogsFacility": 23, "auditLogsSend": true, "auditLogsSeverity": 6, "authEventsFacility": -1, "authEventsSend": true, "authEventsSeverity": -1, "clientCert": "<Client certificate in PEM-encoding>", "clientKey": "<Client private key in PEM-encoding>", "clientKeyPassphrase": "<Client private key passphrase>", "enabled": true, "hostname": "syslog.example.com", "insecureTLS": false, "port": 514, "protocol": "tls", "serverCaCert": "<CA bundle in PEM-encoding>", "tlsConfigurationParameters": "<OpenSSL configuration commands>"}}}}

Авторы

  • Команда NetApp Ansible (@vinaykus)

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

  • Главная страница
  • Репозиторий (исходный код)

© 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/storagegrid/na_sg_grid_audit_destination_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API