Модуль community.crypto.openssl_privatekey_info — сведения о закрытых ключах OpenSSL

check_consistency

boolean

добавлено в community.crypto 2.0.0

Проверять ли целостность закрытого ключа.

В community.crypto < 2.0.0 целостность проверялась всегда.

Начиная с community.crypto 2.0.0 проверка целостности по умолчанию отключена, чтобы не передавать закрытый ключ и не выполнять над ним вычисления без явного запроса. Это может помочь предотвратить атаки по сторонним каналам.

Обратите внимание, что проверка целостности работает только для некоторых типов ключей и может зависеть от версии библиотеки cryptography. Например, в cryptography 42.0.0 и более поздних версиях проверка целостности ключей RSA больше невозможна.

Варианты:

• false ← (по умолчанию)
• true

content

string

добавлено в community.crypto 1.0.0

Содержимое файла закрытого ключа.

Необходимо указать либо path, либо content, но не оба параметра одновременно.

passphrase

string

Парольная фраза для закрытого ключа.

path

path

Удалённый абсолютный путь, по которому загружается файл закрытого ключа.

return_private_key_data

boolean

Возвращать ли данные закрытого ключа.

Устанавливайте значение true только в том случае, если вы хотите, чтобы закрытая информация об этом ключе передавалась с удалённой машины.

ПРЕДУПРЕЖДЕНИЕ: убедитесь, что данные закрытого ключа не будут случайно записаны в журнал!

Варианты:

• false ← (по умолчанию)
• true

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

Поддержка: полная

Это действие не изменяет состояние.

При повторном запуске с теми же аргументами вне режима check второй вызов сообщает об отсутствии изменений.

Предполагается, что система, которой управляет модуль или сведения о которой он получает, не изменилась существенным образом.

can_load_key

boolean

Удалось ли модулю загрузить закрытый ключ с диска.

Возвращается: всегда

can_parse_key

boolean

Удалось ли модулю разобрать закрытый ключ.

Возвращается: всегда

key_is_consistent

boolean

Является ли ключ целостным. Может также возвращать none наряду с true и false, указывая, что проверить целостность не удалось.

Если проверка возвращает false, модуль завершится с ошибкой.

Возвращается: когда check_consistency=true

private_data

dictionary

Данные закрытого ключа. Зависят от типа ключа.

Возвращается: при успешном выполнении, если для return_private_key_data задано значение true

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

public_key

string

Открытый ключ закрытого ключа в формате PEM.

Возвращается: при успешном выполнении

Пример: "-----BEGIN PUBLIC KEY-----\nMIICIjANBgkqhkiG9w0BAQEFAAOCAg8A..."

public_key_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..."

type

string

Тип ключа.

Одно из значений: RSA, DSA, ECC, Ed25519, X25519, Ed448 или X448.

Если определить тип ключа невозможно, значение будет начинаться с unknown.

Возвращается: при успешном выполнении

Пример: "RSA"