If your application runs on HTTPS, you’ll need to register a certificate with Azion Certificate Manager. A TLS digital certificate confirms a website’s identity and protects data transfers. It secures financial transactions and any exchange of sensitive information, from login credentials to personal data.
You can also request that a Let’s Encrypt certificate be generated for your domain through Azion. The process for requesting a Let’s Encrypt certificate is different from custom certificates. See how to generate a Let’s Encrypt certificate for more information.
- Azion now offers the flexibility of issuing and renewing Let’s Encrypt certificates via API using either the DNS-01 or HTTP-01 challenge, allowing you to choose the method that best suits your needs.
- Don’t have a digital certificate? Check the guide on How to acquire and register a Digital Certificate with Azion.
This page has steps for API v4 and API v3. If the Products menu of Azion Console lists Workloads, follow the API v4 steps. For more information, refer to Verify your account’s API version.
- Access Azion Console > Certificate Manager.
- Click the + Digital Certificate button.
- Name your certificate.
- Select the Import a server certificate option.
- In the field Certificate, paste the certificate.
- In the Private Key field, paste the private key.
- Click the Save button.
- Acquire the X.509 certificate from a CA.
- Replace any line breaks with
\n, including for the begin and end markers, to turn the certificate into a string.
- Do the same to the private key.
- Run the following cURL command in your terminal, replacing
[TOKEN VALUE] with your personal token and adding your certificate and private key to the fields:
| Key |
Description |
name |
Sets the string in the value as a name of the certificate entry with Azion. |
certificate |
Takes your certificate as a value. Must be a continuous string. |
private_key |
Takes your private key as a value. Must be a continuous string. |
type |
Set to edge_certificate for a server certificate. It is the default, so you can leave it out. |
The API answers 201 with the new certificate in data. Keep its id to associate the certificate with a workload. The certificate reads inactive until a workload uses it:
- Access Azion Console > Certificate Manager.
- Click the + Digital Certificate button.
- Name your certificate.
- Select the Import a Trusted CA certificate option.
- In the field Certificate, paste the certificate.
- Click the Save button.
- Acquire a trusted certificate signed by your CA.
- Replace any line breaks with
\n, including for the begin and end markers, to turn the certificate into a string.
- Run the following cURL command in your terminal, replacing
[TOKEN VALUE] with your personal token and adding your certificate and to the fields:
| Key |
Description |
name |
Sets the string in the value as a name of the certificate entry with Azion. |
certificate |
Takes your certificate as a value. Must be a continuous string. |
type |
When set to trusted_ca_certificate, the endpoint no longer requires a private key entry. |
The API answers 201 with the new Trusted CA in data. Keep its id to turn on mTLS in a workload. The certificate reads inactive until a workload names it in its mtls object:
Now you need to associate your certificate to an Azion domain:
- On the upper-left corner of the page, open the Products menu, represented by three horizontal lines > Workloads.
- Select the desired Workload.
- In Certificate Manager, select the certificate you created in the previous steps.
- Make sure the domain listed in the Subdomain and Domain fields are the same as the issued certificate for your domain.
- Click the Save button.
- Wait a couple of minutes for the changes to propagate.
You can access your HTTPS application and check the security settings using your browser or run the following OpenSSL command, replacing yourdomain.com with one of the CNAMEs of the domain:
- On the upper-left corner of the page, open the Products menu, represented by three horizontal lines > Domains.
- Select the desired domain.
- In Digital Certificate, select the certificate you created in the previous steps.
- Make sure the CNAMEs listed in the CNAME field are the same as the issued certificate for your custom domain.
- Click the Save button.
- Wait a couple of minutes for the changes to propagate.
You can access your HTTPS application and check the security settings using your browser or run the following OpenSSL command, replacing yourdomain.com with one of the CNAMEs of the domain:
- Run the following
GET request to retrieve your Workload’s id:
- You’ll receive a response similar to this:
- Locate the workload you wish to associate to the certificate and copy its
id value from the response.
- Run a
PATCH request, adding the workload_id as a path, to set tls.certificate to the id you received when you created the certificate:
Optional — As shown in the example below, if you didn’t update the Domain and Subdomain fields with your custom domain yet, make sure to add the host and any common names for the application that are protected by the certificate. This will be useful when you later point your domain or migrate your NS resolution to Azion.
- You should receive a response with the updated data.
- Wait a couple of minutes for the changes to propagate. Then, access your HTTPS application and check the security settings using your browser or run the following OpenSSL command, replacing
yourdomain.com with one of the CNAMEs of the domain:
- Run the following
GET request to retrieve your domain’s id:
- You’ll receive a response similar to this:
- Locate the domain you wish to associate to the certificate and copy the
domain_id value received in the response.
- Run a
PATCH request, adding the domain_id as a path, to update the digital_certificate_id field with the id you received in the creation process:
Optional — As shown in the example below, if you didn’t update the CNAME field with your custom domain yet, make sure to add the host and any common names for the application that are protected by the certificate. This will be useful when you later point your domain or migrate your NS resolution to Azion.
- You should receive a response with the updated data.
- Wait a couple of minutes for the changes to propagate. Then, access your HTTPS application and check the security settings using your browser or run the following OpenSSL command, replacing
yourdomain.com with one of the CNAMEs of the domain: