модуль dellemc.openmanage.ome_application_certificate — этот модуль позволяет создать CSR и загрузить сертификат

Примечание

Этот модуль входит в коллекцию dellemc.openmanage (версия 10.0.2).

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

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

Чтобы использовать модуль в плейбуке, укажите: dellemc.openmanage.ome_application_certificate.

Добавлено в dellemc.openmanage 2.1.0

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

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

Этот модуль позволяет создать новый запрос на подпись сертификата (CSR) и загрузить сертификат в OpenManage Enterprise.

Требования

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

python >= 3.9.6

Параметры

Параметр	Комментарии
business_name строка	Название организации, выдавшей сертификат. Этот параметр применяется для `generate_csr`.
ca_path путь добавлено в dellemc.openmanage 5.0.0	Файл Privacy Enhanced Mail (PEM), содержащий сертификат центра сертификации, который будет использоваться для проверки.
command строка	`generate_csr` позволяет создать CSR. `upload` загружает сертификат в OpenManage Enterprise. `upload_cert_chain` загружает цепочку сертификатов в OpenManage Enterprise. Варианты: `"generate_csr"` ← (по умолчанию) `"upload"` `"upload_cert_chain"`
country строка	Страна, в которой находится издатель сертификата. Этот параметр применяется для `generate_csr`.
country_state строка	Штат или регион, в котором находится издатель сертификата. Этот параметр применяется для `generate_csr`.
department_name строка	Название подразделения, выдавшего сертификат. Этот параметр применяется для `generate_csr`.
distinguished_name строка	Имя издателя сертификата. Этот параметр применяется для `generate_csr`.
email строка	Адрес электронной почты, связанный с издателем сертификата. Этот параметр применяется для `generate_csr`.
hostname строка / обязательный	IP-адрес или имя узла OpenManage Enterprise либо OpenManage Enterprise Modular.
locality строка	Местонахождение издателя сертификата. Этот параметр применяется для `generate_csr`.
password строка	Пароль OpenManage Enterprise или OpenManage Enterprise Modular. Если пароль не указан, используется переменная среды `OME_PASSWORD`. Пример: export OME_PASSWORD=password
port целое число	HTTPS-порт OpenManage Enterprise или OpenManage Enterprise Modular. По умолчанию: `443`
subject_alternative_names строка добавлено в dellemc.openmanage 8.1.0	Альтернативное имя субъекта, необходимое для создания запроса на подпись сертификата. Поддерживается до 4 значений, разделённых запятыми: первичное, вторичное, третичное и четвертичное.
timeout целое число добавлено в dellemc.openmanage 5.0.0	Тайм-аут на уровне сокета в секундах. По умолчанию: `30`
upload_file строка	Локальный путь к файлу сертификата для загрузки. Этот параметр применяется для `upload` и `upload_cert_chain`. После загрузки сертификата доступ к OpenManage Enterprise будет невозможен в течение нескольких секунд. Поддерживаемые форматы файла сертификата: .crt, .cer, .ca-bundle, .p7b, .der и .pem.
username строка	Имя пользователя OpenManage Enterprise или OpenManage Enterprise Modular. Если имя пользователя не указано, используется переменная среды `OME_USERNAME`. Пример: export OME_USERNAME=username
validate_certs логический добавлено в dellemc.openmanage 5.0.0	Если `false`, SSL-сертификаты проверяться не будут. Настраивайте `false` только на контролируемых вами сайтах, где используются самоподписанные сертификаты. До версии коллекции `5.0.0` параметр validate_certs по умолчанию имеет значение `false`. Варианты: `false` `true` ← (по умолчанию)
x_auth_token строка добавлено в dellemc.openmanage 9.3.0	Токен аутентификации. Если x_auth_token не указан, используется переменная среды `OME_X_AUTH_TOKEN`. Пример: export OME_X_AUTH_TOKEN=x_auth_token

Примечания

Примечание

Если загружаемый сертификат совпадает с уже существующим, модуль принимает его.
Этот модуль не поддерживает check_mode.

Примеры

---
- name: Generate a certificate signing request
  dellemc.openmanage.ome_application_certificate:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    command: "generate_csr"
    distinguished_name: "hostname.com"
    department_name: "Remote Access Group"
    business_name: "Dell Inc."
    locality: "Round Rock"
    country_state: "Texas"
    country: "US"
    email: "support@dell.com"

- name: Generate a certificate signing request with subject alternative names
  dellemc.openmanage.ome_application_certificate:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    command: "generate_csr"
    distinguished_name: "hostname.com"
    subject_alternative_names: "hostname1.chassis.com,hostname2.chassis.com"
    department_name: "Remote Access Group"
    business_name: "Dell Inc."
    locality: "Round Rock"
    country_state: "Texas"
    country: "US"
    email: "support@dell.com"

- name: Upload the certificate
  dellemc.openmanage.ome_application_certificate:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    command: "upload"
    upload_file: "/path/certificate.cer"

- name: Upload the certificate chain
  dellemc.openmanage.ome_application_certificate:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    command: "upload_cert_chain"
    upload_file: "/path/certificate_chain.p7b"

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

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

Ключ	Описание
csr_status словарь	Сведения о созданном сертификате. Возвращается: при успешном выполнении Пример: `{"CertificateData": "-----BEGIN CERTIFICATE REQUEST-----GHFSUEKLELE af3u4h2rkdkfjasczjfefhkrr/frjrfrjfrxnvzklf/nbcvxmzvndlskmcvbmzkdk kafhaksksvklhfdjtrhhffgeth/tashdrfstkm@kdjFGD/sdlefrujjfvvsfeikdf yeufghdkatbavfdomehtdnske/tahndfavdtdfgeikjlagmdfbandfvfcrfgdtwxc qwgfrteyupojmnsbajdkdbfs/ujdfgthedsygtamnsuhakmanfuarweyuiwruefjr etwuwurefefgfgurkjkdmbvfmvfvfk==-----END CERTIFICATE REQUEST-----"}`
error_info словарь	Сведения об ошибке HTTP. Возвращается: при ошибке HTTP Пример: `{"error": {"@Message.ExtendedInfo": [{"Message": "Unable to upload the certificate because the certificate file provided is invalid.", "MessageArgs": [], "MessageId": "CSEC9002", "RelatedProperties": [], "Resolution": "Make sure the CA certificate and private key are correct and retry the operation.", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}`
msg строка	Общий статус запроса на подпись сертификата. Возвращается: всегда Пример: `"Successfully generated certificate signing request."`

Авторы

Felix Stephen (@felixs88)
Kritika Bhateja (@Kritika-Bhateja-03)
Jennifer John (@Jennifer-John)
Abhishek Sinha (@ABHISHEK-SINHA10)
Saksham Nautiyal (@Saksham-Nautiyal)
Sapana Gupta (@sapana05)

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

© 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/dellemc/openmanage/ome_application_certificate_module.html