community.crypto.ecs_domain – Запрос валидации домена с помощью API Entrust Certificate Services (ECS)

• Обзор
• Требования
• Параметры
• Примечания
• См. также
• Примеры
• Возвращаемые значения

Обзор

• Запрос валидации или повторной валидации домена с помощью API Entrust Certificate Services (ECS).
• Требуются учетные данные для API Entrust Certificate Services (ECS).
• Если домен уже находится в процессе валидации, новый запрос на валидацию не будет отправлен, но данные валидации (при наличии) будут возвращены.
• Если домен уже находится в процессе валидации, но указанный verification_method отличается от текущего verification_method, verification_method будет обновлен, и данные валидации (при наличии) будут возвращены.
• Если домен является активным, валидированным доменом, возвращаемое значение changed будет false, за исключением случаев domain_status=EXPIRED, в этом случае будет выполнена повторная валидация.
• Если verification_method=dns, сведения о необходимом записей DNS будут указаны в возвращаемых параметрах dns_contents, dns_location и dns_resource_type.
• Если verification_method=web_server, сведения о необходимых файлах будут указаны в возвращаемых параметрах file_contents и file_location.
• Если verification_method=email, адреса электронной почты, которым были отправлены электронные письма с валидацией, будут содержаться в параметре возврата emails. Это исключительно информационные данные. Для доменов, запрошенных с помощью этого модуля, это всегда будет список размером 1.

Требования

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

• PyYAML >= 3.11

Параметры

Примечания

См. также

Примеры

- name: Request domain validation using email validation for client ID of 2.
  community.crypto.ecs_domain:
    domain_name: ansible.com
    client_id: 2
    verification_method: email
    verification_email: admin@ansible.com
    entrust_api_user: apiusername
    entrust_api_key: a^lv*32!cd9LnT
    entrust_api_client_cert_path: /etc/ssl/entrust/ecs-client.crt
    entrust_api_client_cert_key_path: /etc/ssl/entrust/ecs-client.key

- name: Request domain validation using DNS. If domain is already valid,
        request revalidation if expires within 90 days
  community.crypto.ecs_domain:
    domain_name: ansible.com
    verification_method: dns
    entrust_api_user: apiusername
    entrust_api_key: a^lv*32!cd9LnT
    entrust_api_client_cert_path: /etc/ssl/entrust/ecs-client.crt
    entrust_api_client_cert_key_path: /etc/ssl/entrust/ecs-client.key

- name: Request domain validation using web server validation, and revalidate
        if fewer than 60 days remaining of EV eligibility.
  community.crypto.ecs_domain:
    domain_name: ansible.com
    verification_method: web_server
    entrust_api_user: apiusername
    entrust_api_key: a^lv*32!cd9LnT
    entrust_api_client_cert_path: /etc/ssl/entrust/ecs-client.crt
    entrust_api_client_cert_key_path: /etc/ssl/entrust/ecs-client.key

- name: Request domain validation using manual validation.
  community.crypto.ecs_domain:
    domain_name: ansible.com
    verification_method: manual
    entrust_api_user: apiusername
    entrust_api_key: a^lv*32!cd9LnT
    entrust_api_client_cert_path: /etc/ssl/entrust/ecs-client.crt
    entrust_api_client_cert_key_path: /etc/ssl/entrust/ecs-client.key

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

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

Авторы

• Chris Trufan (@ctrufan)