cyberark.pas.cyberark_credential – Получение учетных данных с помощью центрального поставщика учетных данных AAM.
Примечание
Этот плагин является частью коллекции cyberark.pas (версия 1.0.5).
Для его установки используйте: ansible-galaxy collection install cyberark.pas.
Для использования в книге задач укажите: cyberark.pas.cyberark_credential.
В версии 2.4: плагина cyberark.pas
Обзор
- Создает URI для извлечения учетных данных из объекта пароля, хранящегося в хранилище Cyberark Vault. Запрос использует SDK веб-служб безопасности учетных записей с привилегиями (Privileged Account Security Web Services SDK) через центрального поставщика учетных данных, запросив доступ с помощью идентификатора приложения.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_base_url строка / обязательно | Строка, содержащая базовый URL-адрес сервера, на котором размещен центральный поставщик учетных данных. | |
| app_id строка / обязательно | Строка, содержащая идентификатор приложения, авторизованного для извлечения учетных данных. | |
| client_cert строка | Строка, содержащая расположение и имя файла клиентского сертификата, используемого для аутентификации. | |
| client_key строка | Строка, содержащая расположение и имя файла закрытого ключа клиентского сертификата, используемого для аутентификации. | |
| connection_timeout целое число | По умолчанию: "30" | Целочисленное значение допустимого времени до того, как запрос вернет ошибку. |
| fail_request_on_password_change логическое значение |
| Логический параметр для завершения запроса в середине изменения пароля запрошенных учетных данных. |
| query строка / обязательно | Строка, содержащая сведения о запрошенном объекте; Возможными параметрами могут быть Safe, Folder, Object (внутреннее имя учетной записи), UserName, Address, Database, PolicyID. | |
| query_format строка |
| Формат, в котором CCP получит ваш запрос. |
| reason строка | Причина запроса учетных данных, если это требуется политикой; Он должен быть указан, если политика, управляющая объектом, требует его. | |
| validate_certs логическое значение |
| Если false, цепочка сертификатов SSL не будет проверена. Это следует установить только в true случае, если у вас установлен корневой сертификат CA на каждом узле. |
Примеры
tasks:
- name: credential retrieval basic
cyberark_credential:
api_base_url: "http://10.10.0.1"
app_id: "TestID"
query: "Safe=test;UserName=admin"
register: result
- name: credential retrieval advanced
cyberark_credential:
api_base_url: "https://components.cyberark.local"
validate_certs: yes
client_cert: /etc/pki/ca-trust/source/client.pem
client_key: /etc/pki/ca-trust/source/priv-key.pem
app_id: "TestID"
query: "Safe=test;UserName=admin"
connection_timeout: 60
query_format: Exact
fail_request_on_password_change: True
reason: "requesting credential for Ansible deployment"
register: result
Возвращаемые значения
Общие возвращаемые значения описаны в здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое | Описание | |
|---|---|---|---|
| changed логическое значение | всегда | Определяет, привело ли выполнение книги задач к каким-либо изменениям в учетной записи. | |
| failed логическое значение | всегда | Указывает, привело ли выполнение книги задач к ошибкам любого рода. | |
| result сложный тип | успех | JSON-вывод результата действия. | |
| Address строка | если требуется | Целевой адрес запрошенных учетных данных | |
| Content строка | всегда | Пароль запрошенного объекта | |
| CPMDisabled строка | если управление CPM отключено и приведена причина | Описание причины, по которой учетные данные хранилища не управляются CPM. | |
| CreationMethod строка | всегда | Способ создания объекта в хранилище | |
| DeviceType строка | всегда | Внутренняя категория файлов для более детального управления платформами. | |
| Folder строка | всегда | Папка в хранилище, где хранятся учетные данные. | |
| LogonDomain строка | если задано | Дружественное имя адреса, разрешенное CPM | |
| Name строка | всегда | Уникальный идентификатор объекта Cyberark запрошенных учетных данных. | |
| PasswordChangeInProcess логическое значение | всегда | Если пароль имеет флаг изменения, установленный CPM | |
| PolicyID строка | если назначена политика | Указывает, следует ли проверять сертификаты SSL. | |
| Safe строка | всегда | Хранилище, где хранятся запрошенные учетные данные. | |
| Username строка | если требуется | Имя пользователя запрошенных учетных данных | |
| status_code целое число | успех | Код состояния HTTP результата. Пример: 200, 201, -1, 204 | |
Авторы
- Edward Nunez (@enunez-cyberark)
- CyberArk BizDev (@cyberark-bizdev)
- Erasmo Acosta (@erasmix)
- James Stutes (@JimmyJamCABD)
© 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/cyberark/pas/cyberark_credential_module.html
