Como criar um certificado digital

Se sua aplicação roda em HTTPS, você precisa cadastrar um certificado digital com Azion Digital Certificates. Um certificado digital TLS confirma a identidade de um site e protege as transferências de dados. Ele garante transações financeiras e qualquer troca de informações sensíveis, desde credenciais de login até dados pessoais.

Você também pode solicitar que um certificado Let’s Encrypt seja gerado para o seu domínio através da Azion. O processo para solicitar um certificado Let’s Encrypt é diferente dos certificados personalizados. Consulte como gerar um certificado Let’s Encrypt para mais informações.

Há instruções separadas para as configurações do Domains legado e para o novo produto Workloads.

Opção 1: Faça upload de certificado personalizado

Acesse o Azion Console > Digital Certificates.
Clique no botão + Digital Certificate.
Nomeie seu certificado.
Selecione a opção Import a server certificate.
No campo Certificate, cole o certificado.
No campo Private Key, cole a chave privada.
Clique no botão Save.

Adquira o certificado X.509 de uma CA.
Substitua quebras de linha por \n, incluindo para os marcadores de início e fim, para transformar o certificado em uma string.
Faça o mesmo com a chave privada.
Execute o seguinte comando cURL no seu terminal, substituindo [TOKEN VALUE] pelo seu personal token e adicionando seu certificado e chave privada aos campos:

curl --request POST --url https://api.azion.com/v4/digital_certificates/certificates --header 'Accept: application/json' --header 'Authorization: Token [TOKEN VALUE]' --header 'Content-Type: application/json' --data '{
"name": "CERT yourdomain.com",
"certificate": "-----BEGIN CERTIFICATE-----
<your_private_key>
-----END CERTIFICATE-----",
"private_key": "-----BEGIN RSA PRIVATE KEY-----
<your_private_key>
-----END RSA PRIVATE KEY-----",
"type": "edge_certificate",
"active": true
}'

Chave	Descrição
`name`	Define a string no valor como um nome da entrada do certificado na Azion.
`certificate`	Recebe seu certificado como um valor. Deve ser uma string contínua.
`private_key`	Recebe sua chave privada como um valor. Deve ser uma string contínua.

Ao fazer o upload de seu certificado, você receberá uma resposta confirmando a sua criação:

{
  "results": {
      "id": <digital_certificate_id>,
      "name": "CERT yourdomain.com",
      "issuer": "",
      "subject_name": [],
      "validity": "2028-03-24 20:09:00-03:00",
      "status": "Active",
      "certificate_type": "edge_certificate",
      "managed": false
  }
}

Opção 2: Faça upload do Trusted CA para mTLS

Acesse o Azion Console > Digital Certificates.
Clique no botão + Digital Certificate.
Nomeie seu certificado.
Selecione a opção Import a Trusted CA certificate.
No campo Certificate, cole o certificado.
Clique no botão Save.

Adquira um trusted certificate assinado pela sua CA.
Substitua qualquer quebra de linha por \n, incluindo para os marcadores de início e fim, para transformar o certificado em uma string.
Execute o seguinte comando cURL no seu terminal, substituindo [TOKEN VALUE] pelo seu personal token e adicionando seu certificado aos campos:

curl --request POST --url https://api.azion.com/v4/digital_certificates/certificates --header 'Accept: application/json' --header 'Authorization: Token [TOKEN VALUE]' --header 'Content-Type: application/json' --data '{
"name": "TCA yourdomain.com",
"certificate": "-----BEGIN CERTIFICATE-----
<your_private_key>
-----END CERTIFICATE-----",
"type": "trusted_ca_certificate",
"active": true
}'

Chave	Descrição
`name`	Define a string no valor como um nome da entrada do certificado com Azion.
`certificate`	Recebe seu certificado como um valor. Deve ser uma string contínua.
`certificate_type`	Quando definido como `trusted_ca_certificate`, o endpoint não requer mais uma entrada de chave privada.

Ao fazer o upload de seu Trusted CA, você receberá uma resposta com dados sobre o certificado:

{
  "results": {
      "id": <digital_certificate_id>,
      "name": "TCA yourdomain.com",
      "issuer": "",
      "subject_name": [],
      "validity": "2028-03-24 20:09:00-03:00",
      "status": "Active",
      "certificate_type": "trusted_ca_certificate",
      "managed": false
  }
}

Associe certificado a um domínio

Para associar seu certificado a um domínio Azion:

No canto superior esquerdo da página, abra o Products menu, representado por três linhas horizontais > Workloads.
Selecione o domínio desejado.
Em Digital Certificate, selecione o certificado que você criou nas etapas anteriores.
Certifique-se de que os domínios listados nos campos Subdomain e Domain sejam os mesmos do certificado emitido para o seu domínio.
Clique no botão Save.
Espere alguns minutos para que as alterações se propaguem.

Você pode acessar sua aplicação HTTPS e verificar as configurações de segurança usando seu navegador ou executar o seguinte comando OpenSSL, substituindo seudominio.com por um dos CNAMEs do domínio:

openssl s_client -showcerts -connect seudominio.com:443

No canto superior esquerdo da página, abra o Products menu, representado por três linhas horizontais > Domains.
Selecione o domínio desejado.
Em Digital Certificate, selecione o certificado que você criou nas etapas anteriores.
Certifique-se de que os CNAMEs listados no campo CNAME sejam os mesmos do certificado emitido para o seu domínio.
Clique no botão Save.
Espere alguns minutos para que as alterações se propaguem.

openssl s_client -showcerts -connect seudominio.com:443

Execute a seguinte requisição GET para obter o ID do seu workload:

curl --request GET --url https://api.azion.com/v4/workspace/workloads --header 'Accept: application/json' --header 'Authorization: Token [TOKEN VALUE]'

Você receberá uma resposta semelhante a esta:

"results": [
  {
    "id": <workload_id>,
    "name": "My Workload",
    "active": true,
    "last_editor": "your-email@example.com",
    "last_modified": "2025-08-06T17:53:47.460211Z",
    "infrastructure": 1,
    "tls": {
      "certificate": null,
      "ciphers": 7,
      "minimum_version": "tls_1_3"
  },
  }
 ]

Localize o workload que você deseja associar ao certificado e copie o valor workload_id recebido na resposta.
Execute uma requisição PATCH, adicionando o workload_id como um caminho, para atualizar o campo digital_certificate_id com o id que você recebeu no processo de criação:

curl --request PATCH --url https://api.azion.com/v4/workspace/workloads/{workload_id} --header 'Accept: application/json' --header 'Authorization: Token [TOKEN VALUE]' --header 'Content-Type: application/json' --data '{
  "tls": {
    "certificate": <digital_certificate_id>
  },
  "domains": [
    "yourdomain.com"
  ]
}'

Você deve receber uma resposta com os dados atualizados.
Aguarde alguns minutos para que as alterações propaguem para o edge. Em seguida, acesse sua aplicação HTTPS e verifique as configurações de segurança usando seu navegador ou execute o seguinte comando OpenSSL, substituindo seudominio.com por um dos CNAMEs do domínio:

openssl s_client -showcerts -connect seudominio.com:443

Execute a seguinte requisição GET para obter o ID do seu domínio:

curl --location 'https://api.azionapi.net/domains' --header 'Accept: application/json; version=3' --header 'Authorization: Token [TOKEN VALUE]'

Você receberá uma resposta semelhante a esta:

{
  ...
  "results": [
      {
          "id": <domain_id>,
          "name": "example.com CA1 DC0",
          "cnames": [],
          "cname_access_only": true,
          "digital_certificate_id": null,
          "edge_application_id": <edge_application_id>,
          "is_active": true,
          "domain_name": "xxxxxxxxxx.map.azionedge.net"
      }
  ]
}

Localize o domínio que você deseja associar ao certificado e copie o valor domain_id recebido na resposta.
Execute uma requisição PATCH, adicionando o domain_id como um caminho, para atualizar o campo digital_certificate_id com o id que você recebeu no processo de criação:

curl --location --request PATCH 'https://api.azionapi.net/domains/<domain_id>' --header 'Accept: application/json; version=3' --header 'Authorization: Token [TOKEN VALUE]' --header 'Content-Type: application/json' --data '{
  "digital_certificate_id": <digital_certificate_id>,
  "cnames": [
      "seudominio.com"
  ]
}'

Você deve receber uma resposta com os dados atualizados.
Aguarde alguns minutos para que as alterações propaguem para o edge. Em seguida, acesse sua aplicação HTTPS e verifique as configurações de segurança usando seu navegador ou execute o seguinte comando OpenSSL, substituindo seudominio.com por um dos CNAMEs do domínio:

openssl s_client -showcerts -connect seudominio.com:443