win_inet_proxy – Управляет настройками прокси для WinINet и Internet Explorer
Новая версия 2.8.
Описание
- Используется для установки или удаления настроек прокси для Windows INet, включая Internet Explorer.
- WinINet — это фреймворк, используемый интерактивными приложениями для отправки веб-запросов.
- Настройки прокси также могут использоваться другими приложениями, такими как Firefox, Chrome и другими, но окончательного списка нет.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| auto_config_url строка | URL скрипта конфигурации прокси. Скрипты конфигурации прокси обычно представляют собой JavaScript-файлы с расширением .pac, реализующие функцию C(FindProxyForURurl).Пропускается, устанавливается в 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. Для управления ими используйте модуль win_http_proxy. - По умолчанию эти настройки устанавливаются на уровне пользователя, а не на уровне системы. Для применения прокси для всех пользователей необходимо независимо установить реестровый параметр. Подробности смотрите в примерах.
- Если необходимы настройки прокси на уровне пользователя, используйте become, чтобы стать любым локальным пользователем на хосте. Для работы не требуется пароль.
- Если прокси требует аутентификации, установите учетные данные, используя модуль win_credential. Это требует использования become для доступа к хранилищу учетных данных.
См. также
См. также
- win_http_proxy – Управляет настройками прокси для WinHTTP
- Официальная документация модуля win_http_proxy.
- win_credential – Управляет учетными данными Windows в диспетчере учетных данных
- Официальная документация модуля win_credential.
Примеры
# This should be set before running the win_inet_proxy module
- name: Configure IE proxy settings to apply to all users
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
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
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [предварительный просмотр]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- 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.9/modules/win_inet_proxy_module.html