Модуль community.windows.win_inet_proxy — Управление настройками прокси для WinINet и Internet Explorer

Примечание

Этот модуль входит в коллекцию community.windows (версия 2.3.0).

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

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

Чтобы использовать её в playbook, укажите: community.windows.win_inet_proxy.

Описание
Параметры
Примечания
См. также
Примеры

Описание

Используется для установки или удаления настроек прокси для Windows INet, включая Internet Explorer.
WinINet — это фреймворк, используемый интерактивными приложениями для отправки веб-запросов через него.
Настройки прокси также могут использоваться другими приложениями, такими как Firefox, Chrome и другими, но нет определённого списка.

Параметры

Параметр	Комментарии
auto_config_url строка	URL скрипта конфигурации прокси. Скрипты конфигурации прокси — это, как правило, JavaScript-файлы с расширением `.pac`, реализующие функцию `FindProxyForURL(url, host`. Опустить, установить в null или пустую строку, чтобы удалить URL автоконфигурации. Это соответствует флажку Использовать скрипт автоматической конфигурации в окне настроек подключения.
auto_detect булево	Указывает, нужно ли настроить WinINet на автоматическое обнаружение настроек прокси через автоматическое обнаружение прокси `WPAD`. Это соответствует флажку Автоматически определять настройки в окне настроек подключения. Варианты: `false` `true` ← (по умолчанию)
bypass список / элементы=строка	Список хостов, для которых будет проигнорирован установленный прокси при доступе. Используйте `<local>` для сопоставления имён хостов, которые не являются полными доменными именами. Это полезно при необходимости подключения к внутренним сайтам, используя только имя хоста. Если определено, это должно быть последним элементом в списке bypass. Используйте `<-loopback>` для отключения автоматического пропуска прокси при подключении через любой адрес обратной связи, например, `127.0.0.1`, `localhost`, или имя локального хоста. Опустить, установить в null или пустую строку/список для удаления списка bypass. Если это задано, то также должно быть задано proxy.
connection строка	Имя подключения IE, для которого будут установлены настройки прокси. Это подключения в разделе Подключение по коммутируемому доступу и виртуальные частные сети в настройках IE. Если опущено, используется подключение по умолчанию для локальной сети.
proxy любой	Строка или словарь, определяющий устанавливаемый прокси. Если задаётся строка, она должна иметь вид `hostname`, `hostname:port`, или `protocol=hostname:port`. Если порт не определён, используется порт по умолчанию для используемого протокола. Если задаётся словарь, ключами должны быть протоколы, а значениями — имя хоста и/или порт для этого протокола. Допустимые протоколы: `http`, `https`, `ftp`, и `socks`. Опустить, установить в null или пустую строку, чтобы удалить настройки прокси.

Примечания

Примечание

Это отличается от настроек прокси, установленных в WinHTTP через команду netsh. Для управления этим используйте модуль community.windows.win_http_proxy.
Эти настройки по умолчанию устанавливаются для каждого пользователя, а не для всей системы. Свойство реестра нужно задать отдельно от этого модуля, если вы хотите применить прокси для всех пользователей. Более подробные сведения см. в примерах.
Если требуются настройки прокси для каждого пользователя, используйте become, чтобы стать любым локальным пользователем на хосте. Пароль для этого устанавливать не нужно.
Если прокси требует аутентификации, установите учетные данные с помощью модуля community.windows.win_credential. Для доступа к хранилищу учетных данных необходимо использовать become.

См. также

community.windows.win_http_proxy: Управление настройками прокси для WinHTTP.
community.windows.win_credential: Управление учетными данными Windows в диспетчере учетных данных.

Примеры

# This should be set before running the win_inet_proxy module
- name: Configure IE proxy settings to apply to all users
  ansible.windows.win_regedit:
    path: HKLM:\SOFTWARE\Policies\Microsoft\Windows\CurrentVersion\Internet Settings
    name: ProxySettingsPerUser
    data: 0
    type: dword
    state: present

# This should be set before running the win_inet_proxy module
- name: Configure IE proxy settings to apply per user
  ansible.windows.win_regedit:
    path: HKLM:\SOFTWARE\Policies\Microsoft\Windows\CurrentVersion\Internet Settings
    name: ProxySettingsPerUser
    data: 1
    type: dword
    state: present

- name: Configure IE proxy to use auto detected settings without an explicit proxy
  win_inet_proxy:
    auto_detect: true

- name: Configure IE proxy to use auto detected settings with a configuration script
  win_inet_proxy:
    auto_detect: true
    auto_config_url: http://proxy.ansible.com/proxy.pac

- name: Configure IE to use explicit proxy host
  win_inet_proxy:
    auto_detect: true
    proxy: ansible.proxy

- name: Configure IE to use explicit proxy host with port and without auto detection
  win_inet_proxy:
    auto_detect: false
    proxy: ansible.proxy:8080

- name: Configure IE to use a specific proxy per protocol
  win_inet_proxy:
    proxy:
      http: ansible.proxy:8080
      https: ansible.proxy:8443

- name: Configure IE to use a specific proxy per protocol using a string
  win_inet_proxy:
    proxy: http=ansible.proxy:8080;https=ansible.proxy:8443

- name: Set a proxy with a bypass list
  win_inet_proxy:
    proxy: ansible.proxy
    bypass:
      - server1
      - server2
      - <-loopback>
      - <local>

- name: Remove any explicit proxies that are set
  win_inet_proxy:
    proxy: ''
    bypass: ''

# This should be done after setting the IE proxy with win_inet_proxy
- name: Import IE proxy configuration to WinHTTP
  win_http_proxy:
    source: ie

# Explicit credentials can only be set per user and require become to work
- name: Set credential to use for proxy auth
  win_credential:
    name: ansible.proxy  # The name should be the FQDN of the proxy host
    type: generic_password
    username: proxyuser
    secret: proxypass
    state: present
  become: true
  become_user: '{{ ansible_user }}'
  become_method: runas

Авторы

Jordan Borean (@jborean93)

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

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/windows/win_inet_proxy_module.html