Spec-Zone.ru › Ansible

Модуль netapp.ontap.na_ontap_security_ipsec_policy — модуль NetApp ONTAP для создания, изменения или удаления политики безопасности IPsec.

Примечание

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

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

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

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

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

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

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

  • Создание, изменение или удаление политики безопасности IPsec.

Требования

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

  • 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 или более поздняя версия.

Параметры

Параметр

Комментарии

action

string

Действие для политики IPsec.

Нельзя изменить после создания.

Варианты:

  • "bypass"
  • "discard"
  • "esp_transport"
  • "esp_udp"

authentication_method

string

Метод аутентификации для политики IPsec.

Поддерживается начиная с версии 9.10.1.

Нельзя изменить после создания.

Варианты:

  • "none"
  • "psk"
  • "pki"

cert_filepath

string

добавлено в netapp.ontap 20.6.0

Путь к файлу сертификата клиента SSL (.pem).

Не поддерживается в Python 2.6.

certificate

string

Сертификат для политики IPsec.

Поддерживается начиная с версии 9.10.1.

Обязателен при создании, если authentication_method имеет значение «pki».

enabled

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, где каждый элемент является целым числом.

hostname

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

Имя хоста или IP-адрес экземпляра ONTAP.

http_port

integer

Переопределяет порт по умолчанию (80 или 443).

https

boolean

Включение и отключение HTTPS.

Игнорируется при использовании REST, поскольку поддерживается только HTTPS.

Игнорируется при использовании аутентификации с сертификатом SSL, так как для неё требуется SSL.

Варианты:

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

ipspace

string

Имя IPspace, в котором существует svm.

key_filepath

string

добавлено в netapp.ontap 20.6.0

Путь к файлу ключа клиента SSL.

local_endpoint

dictionary

Локальная конечная точка для политики IPsec.

address

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

Адрес IPv4 или IPv6.

netmask

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

Укажите длину маски подсети (16) или маску IPv4 (255.255.0.0).

Для IPv6 значение по умолчанию — 64, допустимый диапазон — от 1 до 127.

port

string

Порт приложения, на который распространяется политика IPsec, например 23.

local_identity

string

Идентификатор локальной конечной точки IKE для аутентификации.

name

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

Имя политики безопасности IPsec.

password

псевдонимы: pass

string

Пароль указанного пользователя.

protocol

string

Протокол, который защищает эта политика.

Например, ‘any’ или ‘0’, ‘tcp’, ‘udp’ либо номер протокола.

remote_endpoint

dictionary

Удалённая конечная точка для политики IPsec.

address

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

Адрес IPv4 или IPv6.

netmask

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

Укажите длину маски подсети (16) или маску IPv4 (255.255.0.0).

Для IPv6 значение по умолчанию — 64, допустимый диапазон — от 1 до 127.

port

string

Порт приложения, на который распространяется политика IPsec, например 23 или 23-23.

remote_identity

string

Идентификатор удалённой конечной точки IKE для аутентификации.

secret_key

string

Предварительно согласованный ключ для согласования IKE.

Обязателен при создании, если authentication_method имеет значение ‘psk’.

Нельзя изменить после создания.

state

string

Создание или удаление политики безопасности IPsec.

Варианты:

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

svm

string

Имя SVM.

Обязательно при создании политики безопасности IPsec.

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.

Поддерживаются два метода аутентификации:

  1. Базовая аутентификация с использованием имени пользователя и пароля.
  2. Аутентификация с сертификатом SSL с использованием файла сертификата клиента SSL и, при необходимости, файла закрытого ключа.

Для использования сертификата его необходимо установить в кластере ONTAP, а аутентификацию по сертификату — включить.

validate_certs

boolean

Если задано значение no, SSL-сертификаты проверяться не будут.

Задавайте это значение только для личных сайтов, использующих самоподписанные сертификаты; в этом случае следует указать False.

Варианты:

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

Примечания

Примечание

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

Примеры

- name: Create security IPsec policy with pre-shared Keys.
  netapp.ontap.na_ontap_security_ipsec_policy:
    name: ipsec_policy_psk
    ipspace: Default
    svm: ansibleSVM
    authentication_method: psk
    secret_key: "{{ secret_key }}"
    action: esp_transport
    local_endpoint:
      address: 10.23.43.23
      netmask: 24
      port: 201
    remote_endpoint:
      address: 10.23.43.30
      netmask: 24
      port: 205
    protocol: tcp
    enabled: true
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"

- name: Create security IPsec policy with certificates.
  netapp.ontap.na_ontap_security_ipsec_policy:
    name: ipsec_policy_pki
    ipspace: Default
    svm: ansibleSVM
    authentication_method: pki
    certificate: "{{ cert_name }}"
    action: esp_transport
    local_endpoint:
      address: 10.23.43.23
      netmask: 24
      port: 201
    remote_endpoint:
      address: 10.23.43.30
      netmask: 24
      port: 205
    protocol: tcp
    enabled: true
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"

- name: Create security IPsec policy without psk or certificates.
  netapp.ontap.na_ontap_security_ipsec_policy:
    name: ipsec_policy_none
    ipspace: Default
    svm: ansibleSVM
    action: bypass
    local_endpoint:
      address: 10.23.43.23
      netmask: 24
      port: 201
    remote_endpoint:
      address: 10.23.43.30
      netmask: 24
      port: 205
    protocol: tcp
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"

- name: Modify security IPsec policy local, remote end_point.
  netapp.ontap.na_ontap_security_ipsec_policy:
    name: ipsec_policy_pki
    ipspace: Default
    svm: ansibleSVM
    authentication_method: pki
    certificate: "{{ cert_name }}"
    action: esp_transport
    local_endpoint:
      address: 10.23.43.50
      netmask: 24
      port: 201
    remote_endpoint:
      address: 10.23.43.60
      netmask: 24
      port: 205
    protocol: tcp
    enabled: true
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"

- name: Modify security IPsec protocol, enable options.
  netapp.ontap.na_ontap_security_ipsec_policy:
    name: ipsec_policy_pki
    ipspace: Default
    svm: ansibleSVM
    authentication_method: pki
    certificate: "{{ cert_name }}"
    action: esp_transport
    local_endpoint:
      address: 10.23.43.50
      netmask: 24
      port: 201
    remote_endpoint:
      address: 10.23.43.60
      netmask: 24
      port: 205
    protocol: udp
    enabled: false
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"

- name: Delete security IPsec policy.
  netapp.ontap.na_ontap_security_ipsec_policy:
    name: ipsec_policy_pki
    svm: ansibleSVM
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"

Авторы

  • Команда 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_security_ipsec_policy_module.html

Spec-Zone.ru

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