Модуль community.crypto.openssl_publickey_info – получение информации об открытых ключах OpenSSL

Примечание

Этот модуль входит в коллекцию community.crypto (версия 3.2.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.crypto. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: community.crypto.openssl_publickey_info.

Добавлено в community.crypto 1.7.0

Краткое описание
Требования
Параметры
Атрибуты
См. также
Примеры
Возвращаемые значения

Краткое описание

Этот модуль позволяет получать информацию об открытых ключах OpenSSL.
Для взаимодействия с OpenSSL используется библиотека Python cryptography.

Требования

Следующие требования должны быть выполнены на хосте, выполняющем этот модуль.

cryptography >= 3.3

Параметры

Параметр	Комментарии
content string	Содержимое файла открытого ключа. Необходимо указать либо `path`, либо `content`, но не оба параметра одновременно.
path path	Удаленный абсолютный путь, по которому загружается файл открытого ключа.
select_crypto_backend string	Определяет, какую криптографическую реализацию использовать. По умолчанию выбирается `auto`: предпринимается попытка использовать `cryptography`, если она доступна. Если задано значение `cryptography`, будет предпринята попытка использовать библиотеку cryptography. Обратите внимание: в community.crypto 3.0.0 все значения работают одинаково. В более поздней версии этот параметр будет объявлен устаревшим. Рекомендуем не задавать его явно. Варианты: `"auto"` ← (по умолчанию) `"cryptography"`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная Это действие не изменяет состояние.	Может выполняться в режиме `check_mode` и возвращать прогноз изменения состояния, не изменяя целевой объект.
diff_mode	Поддержка: Н/Д Это действие не изменяет состояние.	В режиме diff будут возвращены сведения об изменениях (или о возможных необходимых изменениях в `check_mode`).
idempotent	Поддержка: полная Это действие не изменяет состояние.	При повторном запуске с теми же аргументами вне режима проверки второй вызов сообщает об отсутствии изменений. Предполагается, что система, которой управляет модуль или которую он опрашивает, не изменилась существенным образом.

См. также

community.crypto.openssl_publickey: Создание открытого ключа OpenSSL на основе закрытого ключа.
community.crypto.openssl_privatekey_info: Получение информации о закрытых ключах OpenSSL.
community.crypto.openssl_publickey_info — плагин фильтра: Вариант этого модуля в виде фильтра.

Примеры

---
- name: Generate an OpenSSL private key with the default values (4096 bits, RSA)
  community.crypto.openssl_privatekey:
    path: /etc/ssl/private/ansible.com.pem

- name: Create public key from private key
  community.crypto.openssl_publickey:
    privatekey_path: /etc/ssl/private/ansible.com.pem
    path: /etc/ssl/ansible.com.pub

- name: Get information on public key
  community.crypto.openssl_publickey_info:
    path: /etc/ssl/ansible.com.pub
  register: result

- name: Dump information
  ansible.builtin.debug:
    var: result

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
fingerprints dictionary	Отпечатки открытого ключа. Для каждого доступного алгоритма хеширования вычисляется отпечаток. Возвращается: при успешном выполнении Пример: `"{'sha256': 'd4:b3:aa:6d:c8:04:ce:4e:ba:f6:29:4d:92:a3:94:b0:c2:ff:bd:bf:33:63:11:43:34:0f:51:b0:95:09:2f:63', 'sha512': 'f7:07:4a:f0:b0:f0:e6:8b:95:5f:f9:e6:61:0a:32:68:f1..."`
public_data dictionary	Данные открытого ключа. Зависят от типа ключа. Возвращается: при успешном выполнении
curve string	Название эллиптической кривой для ECC. Возвращается: когда `type=ECC`
exponent integer	Открытый показатель степени ключа RSA. Возвращается: когда `type=RSA`
exponent_size integer	Максимальное количество битов закрытого ключа. По сути, это размер в битах используемой подгруппы. Возвращается: когда `type=ECC`
g integer	Значение `g` для DSA. Это элемент, порождающий используемую подгруппу мультипликативной группы простого поля. Возвращается: когда `type=DSA`
modulus integer	Модуль ключа RSA. Возвращается: когда `type=RSA`
p integer	Значение `p` для DSA. Это простой модуль, по которому выполняются вычисления. Возвращается: когда `type=DSA`
q integer	Значение `q` для DSA. Это простое число, делящее `p - 1` и одновременно являющееся порядком используемой подгруппы мультипликативной группы простого поля. Возвращается: когда `type=DSA`
size integer	Размер модуля (RSA) или простого числа (DSA) в битах. Возвращается: когда `type=RSA` или `type=DSA`
x integer	Координата `x` открытой точки на эллиптической кривой. Возвращается: когда `type=ECC`
y integer	Для `type=ECC` это координата `y` открытой точки на эллиптической кривой. Для `type=DSA` это общедоступный элемент группы, дискретный логарифм которого по основанию `g` является закрытым ключом. Возвращается: когда `type=DSA` или `type=ECC`
type string	Тип ключа. Одно из значений: `RSA`, `DSA`, `ECC`, `Ed25519`, `X25519`, `Ed448` или `X448`. Если тип ключа не удается определить, значение будет начинаться с `unknown`. Возвращается: при успешном выполнении Пример: `"RSA"`

Авторы

Felix Fontein (@felixfontein)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/crypto/openssl_publickey_info_module.html