ecs_certificate_request
ecs_certificate_request_role
Purpose of role
This role creates a publicly-signed Entrust certificate.
- Create a private key.
- Create a certificate signing request (CSR).
- Note: Before you can request a certificate, the domain and organization in the CSR must be validated by Entrust Certificate Services. An organization and domain undergo a validation process when signing up for an ECS Enterprise account. Additional domain and organization validations are beyond the scope of this example, but the process can easily be extended via the cloud portal.
- Create, reissue, or renew your certificates using the Entrust Certificate Services (ECS) API.
- Note: You must have Entrust Certificate Services (ECS) API credentials.
Requirements
- Ansible version 2.9
- PyYAML version 3.11 or higher
- cryptography version 1.6 or higher
Role Variables
See variables in defaults/main.yml
Dependencies
None
Example Playbook
The command below is an example of how to use the role.
Before running the example you will need to to update the below:
Mandatory Parameters: working_path # Path that the key pair, certificate signing request, and certificate will be stored in, unless otherwise specified (see optional parameters) cert_common_name cert_organization_name: cert_organizational_unit_name: cert_country_name: cert_state_or_province_name: cert_type requester_name requester_email requester_phone
Mandatory authentication parameters entrust_api_user entrust_api_key entrust_api_client_cert_path entrust_api_client_cert_key_path
Optional parameters: cert_path # Full path to the location that will be used to save the generated certificate. csr_path: # Full path to the location that will be used to save the certificate signing request privatekey_path: # Full path to the location that will be used to save the private key. request_type days_remaining entrust_api_specification_path
Run command "ansible-playbook sample_playbook.yml"
Additional references
- Leveraging Deployment Automation Ansible Role to Set Up and Refresh Your Web Infrastructure (article) https://blog.entrust.com/2019/08/leveraging-deployment-automation-tools/
- Entrust SSL certificates information/purchase pages https://www.entrust.com/digital-security/certificate-solutions/products/digital-certificates/tls-ssl-certificates
License
MIT/BSD
Author Information
This role was created by Taha Hadreez Copyright (c), Entrust Corporation, 2021
Entrust Certificate Services (ECS) API Integration - Request an SSL certificate from the ECS API.
ansible-galaxy install EntrustCorporation/ecs_certificate_request_role