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

Примечание

Этот модуль входит в коллекцию community.crypto (версия 2.22.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.
Он использует библиотеку cryptography python для взаимодействия с OpenSSL.

Требования

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

cryptography >= 1.2.3

Параметры

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

Атрибуты

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

См. также

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 словарь	Отпечатки пальцев открытого ключа. Для каждого доступного алгоритма хэширования вычисляется отпечаток пальца. Возвращается: успех Пример: `"{'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 словарь	Данные открытого ключа. Зависит от типа ключа. Возвращается: успех
curve строка	Имя кривой для ECC. Возвращается: когда `type=ECC`
exponent целое число	Общеизвестный показатель степени RSA ключа. Возвращается: когда `type=RSA`
exponent_size целое число	Максимальное количество битов закрытого ключа. В основном размер в битах подгруппы, используемой. Возвращается: когда `type=ECC`
g целое число	Значение `g` для DSA. Это элемент, охватывающий подгруппу мультипликативной группы простого поля, используемого. Возвращается: когда `type=DSA`
modulus целое число	Модуль открытого ключа RSA. Возвращается: когда `type=RSA`
p целое число	Значение `p` для DSA. Это простой модуль, на котором выполняются арифметические операции. Возвращается: когда `type=DSA`
q целое число	Значение `q` для DSA. Это простое число, делящее `p - 1`, и в то же время порядок подгруппы мультипликативной группы используемого простого поля. Возвращается: когда `type=DSA`
size целое число	Размер модуля в битах (RSA) или простого числа (DSA). Возвращается: когда `type=RSA` или `type=DSA`
x целое число	Координата `x` для открытой точки на эллиптической кривой. Возвращается: когда `type=ECC`
y целое число	Для `type=ECC`, это координата `y` для открытой точки на эллиптической кривой. Для `type=DSA`, это общеизвестный элемент группы, дискретный логарифм которого относительно `g` является закрытым ключом. Возвращается: когда `type=DSA` или `type=ECC`
type строка	Тип ключа. Один из `RSA`, `DSA`, `ECC`, `Ed25519`, `X25519`, `Ed448`, или `X448`. Начнется с `unknown` если тип ключа невозможно определить. Возвращается: успех Пример: `"RSA"`

Авторы

Felix Fontein (@felixfontein)

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

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