psrp – Запуск задач через протокол удаленного управления Microsoft PowerShell
Новое в версии 2.7.
Краткое описание
- Выполнение команд или загрузка/загрузка на целевой компьютер через PSRP (плагин WinRM)
- Это аналогично плагину подключения winrm, использующему тот же базовый транспорт, но выполняющемуся в интерпретаторе PowerShell.
Требования
Ниже перечислены требования к локальному мастер-узлу, на котором выполняется это подключение.
- pypsrp (библиотека Python)
Параметры
| Параметр | Варианты/Значения по умолчанию | Настройка | Комментарии |
|---|---|---|---|
| auth строка |
| переменная: ansible_psrp_auth | Протокол аутентификации для аутентификации удаленного пользователя. По умолчанию, negotiate, будет пытаться использовать Kerberos если оно доступно, и перейти к NTLM если нет. |
| ca_cert путь | переменная: ansible_psrp_cert_trust_path переменная: ansible_psrp_ca_cert | Путь к цепочке сертификатов PEM для проверки сертификата сервера. Это значение игнорируется, если cert_validation установлено в ignore. псевдонимы: cert_trust_path | |
| cert_validation строка |
| переменная: ansible_psrp_cert_validation | Нужно ли проверять сертификат удаленного сервера. Установите в ignore для отключения проверки сертификатов.
ca_cert может быть установлен для пути к цепочке сертификатов PEM, используемых при проверке. |
| certificate_key_pem путь | переменная: ansible_psrp_certificate_key_pem | Локальный путь к ключу сертификата X509 для использования с аутентификацией по сертификату. | |
| certificate_pem путь | переменная: ansible_psrp_certificate_pem | Локальный путь к сертификату X509 для использования с аутентификацией по сертификату. | |
| configuration_name строка | Значение по умолчанию: "Microsoft.PowerShell" | переменная: ansible_psrp_configuration_name | Имя конечной точки конфигурации PowerShell, к которой нужно подключиться. |
| connection_timeout целое число | Значение по умолчанию: 30 | переменная: ansible_psrp_connection_timeout | Таймаут соединения для отправки запроса на удаленный хост. Измеряется в секундах. |
| credssp_auth_mechanism строка |
| переменная: ansible_psrp_credssp_auth_mechanism | Подпротокол аутентификации для использования с аутентификацией CredSSP. Когда auto, как Kerberos, так и NTLM пытаются подключиться, причём Kerberos предпочтительнее. |
| credssp_disable_tlsv1_2 логическое |
| переменная: ansible_psrp_credssp_disable_tlsv1_2 | Отключает использование TLSv1.2 на канале аутентификации CredSSP. Это не должно быть установлено в yes если хост не поддерживает TLSv1.2. |
| credssp_minimum_version целое число | Значение по умолчанию: 2 | переменная: ansible_psrp_credssp_minimum_version | Минимальная версия аутентификации сервера CredSSP, которая будет принята. Установите в 5 для обеспечения того, что сервер был обновлён и не уязвим к CVE 2018-0886. |
| ignore_proxy логическое |
| переменная: ansible_psrp_ignore_proxy | Отключит все настройки прокси среды и подключится напрямую к удалённому хосту. Этот параметр игнорируется, если proxy задано. |
| max_envelope_size целое число | Значение по умолчанию: 153600 | переменная: ansible_psrp_max_envelope_size | Устанавливает максимальный размер каждого сообщения WSMan, отправляемого на удалённый хост. Измеряется в байтах. По умолчанию 150KiB для совместимости со старыми хостами. |
| message_encryption строка |
| переменная: ansible_psrp_message_encryption | Управляет настройками шифрования сообщений, это отличается от шифрования TLS, когда ansible_psrp_protocol равен https. Только протоколы аутентификации negotiate, kerberos, ntlm, и credssp могут шифровать сообщения. Другие протоколы аутентификации поддерживают шифрование только тогда, когда protocol установлено в https.auto означает, что шифрование сообщений используется только при отсутствии TLS/HTTPS.always то же самое, что и auto, но шифрование сообщений всегда используется, даже при работе через TLS/HTTPS.never отключает все проверки шифрования, когда используется HTTP, и отключает любые процессы шифрования аутентификации. |
| negotiate_delegate логическое |
| переменная: ansible_psrp_negotiate_delegate | Разрешить удалённому пользователю делегировать свои учетные данные другому серверу, т.е. делегирование учетных данных. Действительно только когда Kerberos был выбран для аутентификации или явно задан. Игнорируется, когда NTLM был выбран для аутентификации. |
| negotiate_hostname_override строка | переменная: ansible_psrp_negotiate_hostname_override | Переопределение имени удалённого хоста при поиске хоста в Kerberos поиске. Это позволяет Ansible подключаться по IP, но аутентифицироваться на удалённом сервере с помощью его имени DNS. Действительно только когда Kerberos был выбран для аутентификации или явно задан. Игнорируется, когда NTLM был выбран для аутентификации. | |
| negotiate_send_cbt логическое |
| переменная: ansible_psrp_negotiate_send_cbt | Отправить структуру Channel Binding Token (CBT) при аутентификации. CBT используется для дополнительной защиты от атак «человек посередине» MitM путём привязки внешнего транспортного канала к каналу аутентификации.CBT не используется при использовании только HTTP, только при HTTPS. |
| negotiate_service строка | Значение по умолчанию: "WSMAN" | переменная: ansible_psrp_negotiate_service | Переопределение части имени службы SPN, используемой при аутентификации Kerberos. Действительно только когда Kerberos был выбран для аутентификации или явно задан. Игнорируется, когда NTLM был выбран для аутентификации. |
| operation_timeout целое число | Значение по умолчанию: 20 | переменная: ansible_psrp_operation_timeout | Устанавливает таймаут WSMan для каждой операции. Измеряется в секундах. Это значение не должно превышать значение для connection_timeout. |
| path строка | Значение по умолчанию: "wsman" | переменная: ansible_psrp_path | Путь URI для подключения. |
| port целое число | переменная: ansible_port переменная: ansible_psrp_port | Порт для PSRP для подключения к удалённой цели. По умолчанию 5986 если protocol не определено или https, в противном случае порт 5985. | |
| protocol строка |
| переменная: ansible_psrp_protocol | Установить используемый протокол для подключения. По умолчанию https если port не определено или port не 5985. |
| proxy строка | переменная: ansible_psrp_proxy | Установить URL прокси для подключения к удалённому хосту. |
| read_timeout целое число добавлено в 2.8 | Значение по умолчанию: 30 | переменная: ansible_psrp_read_timeout | Тайм-аут чтения для получения данных от удаленного узла. Это значение всегда должно быть больше, чем operation_timeout. Для этого параметра требуется pypsrp >= 0.3. Измеряется в секундах. |
| reconnection_backoff целое число добавлено в 2.8 | Значение по умолчанию: 2 | переменная: ansible_psrp_connection_backoff переменная: ansible_psrp_reconnection_backoff | Время ожидания между попытками повторного подключения. (Сначала ожидается X, затем 2*X, затем 4*X и т.д.). Измеряется в секундах. Переменная ansible_psrp_reconnection_backoff была добавлена в Ansible 2.9. |
| reconnection_retries целое число добавлено в 2.8 | Значение по умолчанию: 0 | переменная: ansible_psrp_reconnection_retries | Количество попыток повторного подключения при ошибках соединения. |
| remote_addr строка | Значение по умолчанию: "inventory_hostname" | переменная: ansible_host переменная: ansible_psrp_host | Имя хоста или IP-адрес удаленного узла. |
| remote_password строка | переменная: ansible_password переменная: ansible_winrm_pass переменная: ansible_winrm_password | Пароль аутентификации для remote_user. Может быть передан в качестве параметра командной строки.псевдонимы: password | |
| remote_user строка | переменная: ansible_user переменная: ansible_psrp_user | Пользователь, под которым необходимо войти в систему. |
Статус
- Это подключение не гарантирует обратную совместимость. [превью]
- Это подключение поддерживается сообществом Ansible. [community]
Авторы
- Команда разработчиков Ansible
Подсказка
Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете изменить этот документ, чтобы улучшить его.
Подсказка
Элементы конфигурации для каждого типа записи имеют порядок приоритета от низкого к высокому. Например, переменная, расположенная ниже в списке, переопределит переменную, расположенную выше.
© 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/plugins/connection/psrp.html
