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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/windows/win_inet_proxy_module.html