Spec-Zone.ru › Ansible

community.crypto.openssl_csr_info фильтр – Извлечение информации из запросов на подписание сертификатов OpenSSL (CSR)

Примечание

Этот плагин фильтрации входит в коллекцию community.crypto (версия 2.22.1).

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

Чтобы установить её, используйте: ansible-galaxy collection install community.crypto. Для использования этого плагина фильтрации необходимы дополнительные требования. Подробности см. в разделе Требования.

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

Впервые в community.crypto 2.10.0

  • Обзор
  • Требования
  • Входные данные
  • Параметры ключевых слов
  • См. также
  • Примеры
  • Значение возврата

Обзор

  • Принимая запрос на подписание сертификата OpenSSL (CSR), извлекает информацию.
  • Это фильтрованная версия модуля community.crypto.openssl_csr_info.

Требования

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

  • Если name_encoding установлено на значение, отличное от ignore, необходимо установить библиотеку Python idna.

Входные данные

Это описание входных данных фильтра, значения перед | community.crypto.openssl_csr_info.

Параметр

Комментарии

Входные данные

строка / обязательно

Содержание запроса на подписание сертификата OpenSSL (CSR).

Параметры ключевых слов

Это описание параметров ключевых слов фильтра. Это значения key1=value1, key2=value2 и так далее в следующем примере: input | community.crypto.openssl_csr_info(key1=value1, key2=value2, ...)

Параметр

Комментарии

name_encoding

строка

Как кодировать имена (имена DNS, URI, адреса электронной почты) в значениях возврата.

ignore будет использовать кодировку, возвращаемую бэкендом.

idna преобразует все метки доменных имён в кодировку IDNA. Будет предпочтительнее IDNA2008, а IDNA2003 будет использоваться, если кодировка IDNA2008 не удастся.

unicode преобразует все метки доменных имён в Unicode. Будет предпочтительнее IDNA2008, а IDNA2003 будет использоваться, если декодирование IDNA2008 не удастся.

Примечание, что idna и unicode требуют наличия библиотеки Python idna.

Варианты:

  • "ignore" ← (по умолчанию)
  • "idna"
  • "unicode"

См. также

См. также

community.crypto.openssl_csr_info

Предоставляет информацию о запросах на подписание сертификатов OpenSSL (CSR).

community.crypto.to_serial плагин фильтра

Преобразовать целое число в список шестнадцатеричных чисел, разделенных двоеточием.

Примеры

- name: Show the Subject Alt Names of the CSR
  ansible.builtin.debug:
    msg: >-
      {{
        (
          lookup('ansible.builtin.file', '/path/to/cert.csr')
          | community.crypto.openssl_csr_info
        ).subject_alt_name | join(', ')
      }}

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

Ключ

Описание

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

dictionary

Информация о сертификате.

Возвращено: success

authority_cert_issuer

list / elements=string

Эмитент сертификата уполномоченного центра CSR в виде списка общих имен.

Is none if the AuthorityKeyIdentifier extension is not present.

See name_encoding for how IDNs are handled.

Возвращено: success

Пример: ["DNS:www.ansible.com", "IP:1.2.3.4"]

authority_cert_serial_number

integer

Серийный номер сертификата уполномоченного центра CSR.

Is none if the AuthorityKeyIdentifier extension is not present.

Это возвращаемое значение является целым числом. Если вам нужны серийные номера в виде шестнадцатеричной строки, разделенной двоеточиями, например 11:22:33, вам нужно преобразовать его в эту форму с помощью community.crypto.to_serial.

Возвращено: success

Пример: 12345

authority_key_identifier

string

Идентификатор ключа уполномоченного центра CSR.

Идентификатор возвращается в шестнадцатеричном формате, с использованием : для разделения байтов.

Is none if the AuthorityKeyIdentifier extension is not present.

Возвращено: success

Пример: "00:11:22:33:44:55:66:77:88:99:aa:bb:cc:dd:ee:ff:00:11:22:33"

basic_constraints

list / elements=string

Записи в расширении basic_constraints, или none если расширение отсутствует.

Возвращено: success

Пример: ["CA:TRUE", "pathlen:1"]

basic_constraints_critical

boolean

Является ли расширение basic_constraints критическим.

Возвращено: success

extended_key_usage

list / elements=string

Записи в расширении extended_key_usage, или none если расширение отсутствует.

Возвращено: success

Пример: ["Biometric Info", "DVCS", "Time Stamping"]

extended_key_usage_critical

boolean

Является ли расширение extended_key_usage критическим.

Возвращено: success

extensions_by_oid

dictionary

Возвращает словарь для каждого OID расширения

Возвращено: success

Пример: {"1.3.6.1.5.5.7.1.24": {"critical": false, "value": "MAMCAQU="}}

critical

boolean

Является ли расширение критическим.

Возвращено: success

value

string

Значение расширения, закодированное в Base64 (в формате DER).

Примечание: в зависимости от используемой версии cryptography, извлечь содержимое ASN.1 расширения невозможно, можно только предоставить повторно закодированное содержимое расширения в случае, если оно было разобрано cryptography. Обычно это должно привести к точно такому же значению, за исключением случая, если исходное значение расширения было некорректно сформировано.

Возвращено: success

Пример: "MAMCAQU="

key_usage

string

Записи в расширении key_usage, или none если расширение отсутствует.

Возвращено: success

Пример: "['Key Agreement', 'Data Encipherment']"

key_usage_critical

boolean

Является ли расширение key_usage критическим.

Возвращено: success

name_constraints_critical

boolean

Является ли расширение name_constraints критическим.

Is none if extension is not present.

Возвращено: success

name_constraints_excluded

list / elements=string

Список исключенных поддеревьев, для которых ЦС не может подписывать сертификаты.

Is none if extension is not present.

See name_encoding for how IDNs are handled.

Возвращено: success

Пример: ["email:.com"]

name_constraints_permitted

list / elements=string

Список разрешённых поддеревьев для подписи сертификатов.

Возвращено: success

Пример: ["email:.somedomain.com"]

ocsp_must_staple

boolean

true если расширение OCSP Must Staple присутствует, none в противном случае.

Возвращено: success

ocsp_must_staple_critical

boolean

Является ли расширение ocsp_must_staple критическим.

Возвращено: success

public_key

string

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

Возвращено: success

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

public_key_data

dictionary

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

Возвращено: success

curve

string

Название кривой для ECC.

Возвращено: Когда _value.public_key_type=ECC

exponent

integer

Открытый показатель ключа RSA.

Возвращено: Когда _value.public_key_type=RSA

exponent_size

integer

Максимальное количество бит закрытого ключа. Это в основном размер в битах используемой подгруппы.

Возвращено: Когда _value.public_key_type=ECC

g

integer

Значение g для DSA.

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

Возвращено: Когда _value.public_key_type=DSA

modulus

integer

Модуль ключа RSA.

Возвращено: Когда _value.public_key_type=RSA

p

integer

Значение p для DSA.

Это простой модуль, на котором выполняются арифметические операции.

Возвращено: Когда _value.public_key_type=DSA

q

integer

Значение q для DSA.

Это простое число, которое делит p - 1, и одновременно порядок подгруппы мультипликативной группы используемого поля простых чисел.

Возвращено: Когда _value.public_key_type=DSA

size

integer

Размер в битах модуля (RSA) или простого числа (DSA).

Возвращено: Когда _value.public_key_type=RSA или _value.public_key_type=DSA

x

integer

Координата x для открытой точки на эллиптической кривой.

Возвращено: Когда _value.public_key_type=ECC

y

integer

Для _value.public_key_type=ECC, это координата y для открытой точки на эллиптической кривой.

Для _value.public_key_type=DSA, это публично известный групповой элемент, дискретный логарифм которого относительно g является закрытым ключом.

Возвращено: Когда _value.public_key_type=DSA или _value.public_key_type=ECC

public_key_fingerprints

dictionary

Отпечатки открытого ключа CSR.

Вычисляется отпечаток для каждого доступного алгоритма хэширования.

Возвращено: success

Пример: "{'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_key_type

string

Тип открытого ключа CSR.

Один из RSA, DSA, ECC, Ed25519, X25519, Ed448, или X448.

Начнётся с unknown если тип ключа не может быть определён.

Возвращено: success

Пример: "RSA"

signature_valid

boolean

Является ли подпись CSR действительной.

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

Возвращено: success

subject

словарь

Предмет CSR в виде словаря.

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

Возвращено: успех

Пример: {"commonName": "www.example.com", "emailAddress": "test@example.com"}

subject_alt_name

список / элементы=строка

Элементы расширения subject_alt_name, или none, если расширение отсутствует.

См. name_encoding, чтобы узнать, как обрабатываются IDN.

Возвращено: успех

Пример: ["DNS:www.ansible.com", "IP:1.2.3.4"]

subject_alt_name_critical

логическое значение

Является ли расширение subject_alt_name критическим.

Возвращено: успех

subject_key_identifier

строка

Идентификатор ключа субъекта CSR.

Идентификатор возвращается в шестнадцатеричном формате, с использованием : для разделения байтов.

Возвращает none, если расширение SubjectKeyIdentifier отсутствует.

Возвращено: успех

Пример: "00:11:22:33:44:55:66:77:88:99:aa:bb:cc:dd:ee:ff:00:11:22:33"

subject_ordered

список / элементы=список

Предмет CSR в виде упорядоченного списка кортежей.

Возвращено: успех

Пример: [["commonName", "www.example.com"], [{"emailAddress": "test@example.com"}]]

Авторы

  • Felix Fontein (@felixfontein)

Подсказка

Вводные данные для каждого типа записи имеют порядок приоритета снизу вверх. Например, переменная, расположенная ниже в списке, переопределяет переменную, расположенную выше.

Ссылки на сборку

  • Система отслеживания ошибок
  • Репозиторий (источники)
  • Задайте вопрос (crypto)
  • Задайте вопрос (ACME)
  • Отправить отчет об ошибке
  • Запросить функцию
  • Общение

© 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_csr_info_filter.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API