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)