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. [сообщество]
Авторы
- 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.8/modules/win_inet_proxy_module.html