Spec-Zone.ru › Ansible

Модуль dellemc.openmanage.ome_application_network_proxy — обновляет конфигурацию прокси-сервера в OpenManage Enterprise

Примечание

Этот модуль входит в коллекцию dellemc.openmanage (версия 10.0.2).

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

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

Чтобы использовать модуль в плейбуке, укажите: dellemc.openmanage.ome_application_network_proxy.

Добавлено в dellemc.openmanage 2.1.0

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Обзор

  • Этот модуль позволяет настроить сетевой прокси-сервер в OpenManage Enterprise.

Требования

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

  • python >= 3.9.6

Параметры

Параметр

Описание

ca_path

путь

добавлено в dellemc.openmanage 5.0.0

Файл Privacy Enhanced Mail (PEM), содержащий сертификат ЦС, который используется для проверки.

enable_authentication

логическое значение

Включает или отключает аутентификацию на прокси-сервере.

Если enable_authentication имеет значение true, необходимо указать proxy_username и proxy_password.

Если enable_authentication имеет значение false, для имени пользователя и пароля прокси-сервера устанавливаются значения по умолчанию.

Варианты:

  • false
  • true

enable_proxy

логическое значение / обязательный

Включает или отключает конфигурацию HTTP-прокси.

Если enable proxy имеет значение false, для конфигурации HTTP-прокси устанавливается значение по умолчанию.

Варианты:

  • false
  • true

hostname

строка / обязательный

IP-адрес или имя хоста OpenManage Enterprise либо OpenManage Enterprise Modular.

ignore_certificate_validation

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

логическое значение

добавлено в dellemc.openmanage 9.5.0

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

true игнорирует проверку сертификата.

false не игнорирует проверку сертификата.

Варианты:

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

ip_address

строка

Адрес прокси-сервера.

Этот параметр обязателен, если enable_proxy имеет значение true.

password

строка

Пароль OpenManage Enterprise или OpenManage Enterprise Modular.

Если пароль не указан, используется переменная окружения OME_PASSWORD.

Пример: export OME_PASSWORD=password

port

целое число

HTTPS-порт OpenManage Enterprise или OpenManage Enterprise Modular.

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

proxy_exclusion_list

список / элементы=строка

добавлено в dellemc.openmanage 9.5.0

Список IPv4-адресов, IPv6-адресов или доменных имен устройств, которым разрешен обход прокси-сервера для прямого доступа к устройству.

proxy_password

строка

Пароль прокси-сервера.

Этот параметр обязателен, если enable_authentication имеет значение true.

proxy_port

целое число

Номер порта прокси-сервера.

Этот параметр обязателен, если enable_proxy имеет значение true.

proxy_username

строка

Имя пользователя прокси-сервера.

Этот параметр обязателен, если enable_authentication имеет значение true.

timeout

целое число

добавлено в dellemc.openmanage 5.0.0

Тайм-аут на уровне сокета в секундах.

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

update_password

логическое значение

добавлено в dellemc.openmanage 9.5.0

Этот флаг используется для обновления proxy_password.

Применимо только в том случае, если enable_authentication имеет значение true.

true обновит proxy_password.

false не будет обновлять proxy_password.

Варианты:

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

username

строка

Имя пользователя OpenManage Enterprise или OpenManage Enterprise Modular.

Если имя пользователя не указано, используется переменная окружения OME_USERNAME.

Пример: export OME_USERNAME=username

validate_certs

логическое значение

добавлено в dellemc.openmanage 5.0.0

Если false, сертификаты SSL не проверяются.

Настраивайте false только на контролируемых вами сайтах, где используются самозаверяющие сертификаты.

В версиях коллекции до 5.0.0 параметр validate_certs по умолчанию имеет значение false.

Варианты:

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

x_auth_token

строка

добавлено в dellemc.openmanage 9.3.0

Токен аутентификации.

Если x_auth_token не указан, используется переменная окружения OME_X_AUTH_TOKEN.

Пример: export OME_X_AUTH_TOKEN=x_auth_token

Примечания

Примечание

  • Запускайте этот модуль в системе, имеющей прямой доступ к Dell OpenManage Enterprise.
  • Этот модуль поддерживает check_mode.
  • Этот модуль поддерживает адреса IPv4 и IPv6.

Примеры

---
- name: Update proxy configuration and enable authentication
  dellemc.openmanage.ome_application_network_proxy:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    enable_proxy: true
    ip_address: "192.168.0.2"
    proxy_port: 444
    enable_authentication: true
    proxy_username: "proxy_username"
    proxy_password: "proxy_password"

- name: Reset proxy authentication
  dellemc.openmanage.ome_application_network_proxy:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    enable_proxy: true
    ip_address: "192.168.0.2"
    proxy_port: 444
    enable_authentication: false

- name: Reset proxy configuration
  dellemc.openmanage.ome_application_network_proxy:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    enable_proxy: false

- name: Add IPv4, IPv6 and domain names of devices in proxy exclusion list
  dellemc.openmanage.ome_application_network_proxy:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    enable_proxy: true
    ip_address: "192.168.0.2"
    proxy_port: 444
    enable_authentication: false
    proxy_exclusion_list:
      - 192.168.1.0
      - 191.187.2.0
      - www.*.com
      - 191.1.168.1/24

- name: Clear the proxy exclusion list
  dellemc.openmanage.ome_application_network_proxy:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    enable_proxy: true
    ip_address: "192.168.0.2"
    proxy_port: 444
    proxy_exclusion_list: []

- name: Ignore the certificate validation
  dellemc.openmanage.ome_application_network_proxy:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    enable_proxy: true
    ip_address: "192.168.0.2"
    proxy_port: 444
    ignore_certificate_validation: true

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

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

Ключ

Описание

error_info

словарь

Сведения об ошибке HTTP.

Возвращается: при ошибке HTTP

Пример: {"error": {"@Message.ExtendedInfo": [{"Message": "Unable to complete the request because the input value for  PortNumber  is missing or an invalid value is entered.", "MessageArgs": ["PortNumber"], "MessageId": "CGEN6002", "RelatedProperties": [], "Resolution": "Enter a valid value and retry the operation.", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}

msg

строка

Общий статус изменения конфигурации сетевого прокси-сервера.

Возвращается: всегда

Пример: "Successfully updated network proxy configuration."

proxy_configuration

словарь

Обновленная конфигурация сетевого прокси-сервера приложения.

Возвращается: при успешной настройке параметров сетевого прокси-сервера

Пример: {"EnableAuthentication": true, "EnableProxy": true, "IpAddress": "192.168.0.2", "Password": null, "PortNumber": 444, "ProxyExclusionList": ["192.168.0.1", "www.*.com", "172.1.1.1/24"], "SslCheckDisabled": false, "Username": "root"}

Авторы

  • Sajna Shetty(@Sajna-Shetty)
  • Rajshekar P(@rajshekarp87)
  • Sapana Gupta(@sapana05)

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

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

© 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/dellemc/openmanage/ome_application_network_proxy_module.html

Spec-Zone.ru

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