Order Private SSL

POST

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

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

Use este ponto de extremidade para enviar um pedido de solicitação de certificado particular usando private_ssl_plus, private_ssl_wildcard, ou private_ssl_multi_domain como a private_ssl_certificate_id.

cURL

curl -X POST \
  'https://www.digicert.com/services/v2/order/certificate/{{private_ssl_certificate_id}}' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "certificate": {
        "common_name": "192.168.1.195",
        "dns_names": [
        	"192.168.1.196",
        	"192.168.1.197"
        ],
        "csr": "<csr>",
        "server_platform": {
            "id": 45
        },
        "signature_hash": "sha256",
        "ca_cert_id": "10A101A05684",
        "organization_units": [
            "Accounting department"
        ]
    },
    "validity_years": 1,
    "comments": "Message for the approver",
    "disable_renewal_notifications": true,
    "locale": "en",
    "payment_method": "balance",
    "skip_approval": true,
    "organization": {
        "id": 123456
    }
}'

Python

import requests

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

payload = "{\n    \"certificate\": {\n        \"common_name\": \"192.168.1.195\",\n        \"dns_names\": [\n        \t\"192.168.1.196\",\n        \t\"192.168.1.197\"\n        ],\n        \"csr\": \"<csr>\",\n        \"server_platform\": {\n            \"id\": 45\n        },\n        \"signature_hash\": \"sha256\",\n        \"ca_cert_id\": \"10A101A05684\",\n        \"organization_units\": [\n            \"Accounting department\"\n        ]\n    },\n    \"validity_years\": 1,\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}"
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

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

print(response.text)

package main

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

func main() {

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

	payload := strings.NewReader("{\n    \"certificate\": {\n        \"common_name\": \"192.168.1.195\",\n        \"dns_names\": [\n        \t\"192.168.1.196\",\n        \t\"192.168.1.197\"\n        ],\n        \"csr\": \"<csr>\",\n        \"server_platform\": {\n            \"id\": 45\n        },\n        \"signature_hash\": \"sha256\",\n        \"ca_cert_id\": \"10A101A05684\",\n        \"organization_units\": [\n            \"Accounting department\"\n        ]\n    },\n    \"validity_years\": 1,\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}")

	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/{{private_ssl_certificate_id}}',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { certificate: 
      { common_name: '192.168.1.195',
        dns_names: [ '192.168.1.196', '192.168.1.197' ],
        csr: '<csr>',
        server_platform: { id: 45 },
        signature_hash: 'sha256',
        ca_cert_id: '10A101A05684',
        organization_units: [ 'Accounting department' ] },
     validity_years: 1,
     comments: 'Message for the approver',
     disable_renewal_notifications: true,
     locale: 'en',
     payment_method: 'balance',
     skip_approval: true,
     organization: { id: 123456 } },
  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

Use o ponto de extremidade Product list e localize a matriz allowed_ca_certs para identificar valores ca_cert_id possíveis.

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.
.. ca_cert_id	opcional*	string	ID do certificado de CA que deve assinar o certificado. *Requerido se múltiplos certificados de CA estiverem configurados.
.. 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`
validity_days	opcional	int	Número de dias que o certificado é válido após emissão. Substitui `validity_years`
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.).
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`.

Parâmetros da solicitação

Parâmetros da resposta

Sobre