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

Примечание

Этот плагин является частью коллекции community.windows (версия 1.2.0).

Для его установки используйте: ansible-galaxy collection install community.windows.

Для использования в книге задач укажите: 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 для автоматического обнаружения настроек прокси через Web Proxy Auto-Detection `WPAD`. Это соответствует флажку Автоматически обнаруживать настройки в окне настроек подключения.
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: Официальная документация по модулю community.windows.win_http_proxy.
community.windows.win_credential: Официальная документация по модулю community.windows.win_credential.

Примеры

# 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: yes

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

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

- name: Configure IE to use explicit proxy host with port and without auto detection
  win_inet_proxy:
    auto_detect: no
    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: yes
  become_user: '{{ ansible_user }}'
  become_method: runas

Авторы

Jordan Borean (@jborean93)

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