Order Secure Site SSL

POST
https://www.digicert.com/services/v2/order/certificate/{{ssl_certificate_id}}

Esta página descreve produtos com o nome de grupo securesite_ssl_certificate (consulte Glossário — Identificadores de produtos).

Use este ponto de extremidade para enviar um pedido de solicitação de certificado OV/EV usando ssl_ev_securesite, ssl_ev_securesite_multi_domain, ssl_securesite, ssl_securesite_multi_domain, ou ssl_securesite_wildcard como a ssl_certificate_id.

cURL
curl -X POST \
  'https://www.digicert.com/services/v2/order/certificate/{{ssl_certificate_id}}' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "certificate": {
        "common_name": "example.com",
        "dns_names": [
            "sub.example.com",
            "app.example.com"
        ],
        "csr": "<csr>",
        "server_platform": {
            "id": 45
        },
        "signature_hash": "sha256",
        "organization_units": [
            "Accounting department"
        ]
    },
    "validity_years": 2,
    "comments": "Message for the approver",
    "disable_renewal_notifications": true,
    "locale": "en",
    "payment_method": "balance",
    "skip_approval": true,
    "organization": {
        "id": 123456
    },
    "custom_fields": [
        {
            "metadata_id": 11,
            "value": "Invoice #00001"
        }
    ]
}'
Python
import requests

url = "https://www.digicert.com/services/v2/order/certificate/{{ssl_certificate_id}}"

payload = "{\n    \"certificate\": {\n        \"common_name\": \"example.com\",\n        \"dns_names\": [\n            \"sub.example.com\",\n            \"app.example.com\"\n        ],\n        \"csr\": \"<csr>\",\n        \"server_platform\": {\n            \"id\": 45\n        },\n        \"signature_hash\": \"sha256\",\n        \"organization_units\": [\n            \"Accounting department\"\n        ]\n    },\n    \"validity_years\": 2,\n    \"comments\": \"Message for the approver\",\n    \"disable_renewal_notifications\": true,\n    \"locale\": \"en\",\n    \"payment_method\": \"balance\",\n    \"skip_approval\": true,\n    \"organization\": {\n        \"id\": 123456\n    },\n    \"custom_fields\": [\n        {\n            \"metadata_id\": 11,\n            \"value\": \"Invoice #00001\"\n        }\n    ]\n}"
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)
Go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://www.digicert.com/services/v2/order/certificate/{{ssl_certificate_id}}"

	payload := strings.NewReader("{\n    \"certificate\": {\n        \"common_name\": \"example.com\",\n        \"dns_names\": [\n            \"sub.example.com\",\n            \"app.example.com\"\n        ],\n        \"csr\": \"<csr>\",\n        \"server_platform\": {\n            \"id\": 45\n        },\n        \"signature_hash\": \"sha256\",\n        \"organization_units\": [\n            \"Accounting department\"\n        ]\n    },\n    \"validity_years\": 2,\n    \"comments\": \"Message for the approver\",\n    \"disable_renewal_notifications\": true,\n    \"locale\": \"en\",\n    \"payment_method\": \"balance\",\n    \"skip_approval\": true,\n    \"organization\": {\n        \"id\": 123456\n    },\n    \"custom_fields\": [\n        {\n            \"metadata_id\": 11,\n            \"value\": \"Invoice #00001\"\n        }\n    ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
NodeJS
var request = require("request");

var options = { method: 'POST',
  url: 'https://www.digicert.com/services/v2/order/certificate/{{ssl_certificate_id}}',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { certificate: 
      { common_name: 'example.com',
        dns_names: [ 'sub.example.com', 'app.example.com' ],
        csr: '<csr>',
        server_platform: { id: 45 },
        signature_hash: 'sha256',
        organization_units: [ 'Accounting department' ] },
     validity_years: 2,
     comments: 'Message for the approver',
     disable_renewal_notifications: true,
     locale: 'en',
     payment_method: 'balance',
     skip_approval: true,
     organization: { id: 123456 },
     custom_fields: [ { metadata_id: 11, value: 'Invoice #00001' } ] },
  json: true };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
201 (one-step)
{
  "id": 112233,
  "requests": [
    {
      "id": 113,
      "status": "pending"
    }
  ]
}
201 (two-step)
{
  "id": 112233,
  "requests": [
    {
      "id": 113,
      "status": "submitted"
    }
  ]
}
201 (auto)
{
  "id": 112233,
  "requests": [
    {
      "id": 113,
      "status": "approved"
    }
  ],
  "certificate_id": 113
}
201 (skip)
{
  "id": 112233,
  "certificate_id": 113
}
201 (immediate)
{
  "id": 112233,
  "certificate_id": 113,
  "certificate_chain": [
    {
      "subject_common_name": "example.com",
      "pem": "<pem_certificate>"
    },
    {
      "subject_common_name": "DigiCert SHA2 Secure Server CA",
      "pem": "<pem_certificate>"
    },
    {
      "subject_common_name": "DigiCert Global Root CA",
      "pem": "<pem_certificate>"
    }
  ]
}

Parâmetros da solicitação

Para informações sobre valores permitidos para campos do certificado, consulte Certificados publicamente confiáveis – Entradas de dados que violam os padrões na indústria.

Nome Obr/Opc Tipo Descrição
certificate obrigatório object Detalhes do certificado.
.. common_name obrigatório string Domínio a ser protegido.
.. dns_names opcional array Domínios adicionais a serem protegidos.
Pode resultar em custos adicionais. (Consulte Melhores práticas — Obter ambas versões de um domínio gratuitamente.)
.. csr obrigatório string Solicitação de Assinatura de Certificado (CSR).
.. signature_hash obrigatório string Algoritmo de hash usado para assinar o certificado.
Certificados de assinatura de código suportam apenas SHA-256.
.. organization_units opcional array Departamento na sua organização para o certificado.
.. server_platform opcional object Tipo da plataforma do servidor.
Padrão: -1 (outro)
.. .. id obrigatório int ID da plataforma do servidor.
Veja Glossário — Plataformas do servidor
.. profile_option opcional string Se usando perfis de certificados personalizados, especifique o nome do perfil.
renewed_thumbprint opcional string Se o pedido for uma renovação, insira a impressão digital SHA-1 do certificado primário do pedido anterior.
validity_years obrigatório int Número de anos que o certificado é válido.
Pode ser substituído por validity_days ou custom_expiration_date.
Valores permitidos: 1, 2
custom_expiration_date opcional string Data de vencimento personalizada para o certificado. Data deve ser menor que 825 dias no futuro.
Substitui validity_days e validity_years
Formato: yyyy-MM-dd
comments opcional string Comentários sobre o pedido para o aprovador.
auto_renew opcional int Especifica se o certificado deve renovar automaticamente.
Padrão: 0
Valores permitidos: 0 (desabilitado), 1 (habilitado)
custom_renewal_message opcional string Mensagem personalizada a ser incluída em notificações de renovação.
disable_renewal_notifications opcional bool Especifica se e-mails de notificação de renovação devem ser desabilitados.
Padrão: false
additional_emails opcional array Endereços adicionais de e-mail recebem e-mails de notificação (por ex., emissão do certificado, certificado duplicado, renovações de certificados, etc.).
locale opcional string Idioma que o e-mail DCV deve usar.
Veja Glossário — Códigos de localidades
renewal_of_order_id opcional int Se o pedido for uma renovação, insira a ID do pedido anterior.
payment_method opcional string Especifique o método de pagamento a usar.
Valores permitidos: balance, card, profile
Padrão: balance
dcv_method opcional string Método DCV a usar ao verificar o controle do domínio.
Consulte Glossário — Métodos DCV
skip_approval opcional bool Especifica se o pedido deve pular a etapa de aprovação e ser imediatamente enviado para validação e emitido quando concluído.
Padrão: false
disable_ct opcional bool Especifica se registro de CT para o certificado deve ser desabilitado.
Registro de CT específico ao pedido deve ser habilitado ou isso será ignorado. Consulte Permitir que usuários mantenham certificados fora de registros de CT.
Padrão: false
organization obrigatório object Recipiente para detalhes da organização.
.. id obrigatório int ID da organização para associar com o pedido.
De outra forma, é possível passar um objeto da organização para adicionar uma nova organização ao enviar um pedido. Veja Criar organização para requisitos de estrutura do objeto.
container opcional object Se necessário, especifique o recipiente em que o pedido deve ser colocado.
.. id obrigatório int ID do recipiente.
custom_fields opcional* array Campos personalizados específicos à conta.
*Se esses campos são obrigatórios ou não dependerá das suas configurações de campos personalizados.
.. metadata_id obrigatório int ID do campo personalizado.
.. value obrigatório string Valor para o campo personalizado.
Tipo de validação de dados depende das suas configurações de campos personalizados.

Parâmetros da resposta

Nome Tipo Descrição
id int ID do pedido.
organization object Recipiente para novos detalhes da organização.
Retornado apenas se uma nova organização foi criada com o pedido.
.. id int ID da organização para a nova organização.
requests array Possui informações sobre a solicitação.
.. id int ID da solicitação.
.. status string Status da solicitação.
Valores possíveis: pending, submitted, approved, rejected
certificate_id int ID do Certificado.
Retornado se o status da solicitação for approved.