Pedir EV básico

POST

https://www.digicert.com/services/v2/order/certificate/ssl_ev_basic

Use este ponto de extremidade para solicitar um certificado Basic EV SSL.

Este certificado Basic EV SSL mais flexível facilita fazer com que o certificado Basic EV se adeque às suas necessidades. Este certificado substitui os produtos EV SSL e SSL EV Multi Domain.

cURL

curl -X POST \
  https://www.digicert.com/services/v2/order/certificate/ssl_ev_basic \
  -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>",
        "signature_hash": "sha256",
        "organization_units": [
            "Shared Services"
        ],
        "server_platform": {
            "id": 2
        }
    },
    "comments": "Certificate for app server.",
    "container": {
        "id": 334455
    },
    "auto_renew": 1,
    "custom_renewal_message": "Keep this renewed.",
    "organization": {
        "id": 123456,
        "contacts": [
            {
                "contact_type": "ev_approver",
                "user_id": 565622
            },
            {
                "contact_type": "organization_contact",
                "user_id": 565611
            },
            {
                "contact_type": "technical_contact",
                "first_name": "Jill",
                "last_name": "Valentine",
                "job_title": "STAR Member",
                "telephone": "8017019600",
                "email": "jill.valentine@digicert.com"
            }
        ]
    },
    "validity_years": 2,
    "payment_method": "balance"
}

Python

import requests

url = "https://www.digicert.com/services/v2/order/certificate/ssl_ev_basic"

payload = "{\n    \"certificate\": {\n        \"common_name\": \"example.com\",\n    \"dns_names\": [\n      \"example2.com\",\n      \"example3.com\"\n    ],\n        \"csr\": \"<csr>\",\n        \"signature_hash\": \"sha256\",\n        \"organization_units\": [\n            \"Shared Services\"\n        ],\n        \"server_platform\": {\n            \"id\": 45\n        }\n    },\n    \"comments\": \"Certificate for app server.\",\n    \"container\": {\n        \"id\": 334455\n    },\n    \"auto_renew\": 1,\n    \"custom_renewal_message\": \"Keep this renewed.\",\n     \"organization\": {\n        \"id\": 123456,\n        \"contacts\": [\n            {\n                \"contact_type\": \"organization_contact\",\n                \"user_id\": 565611\n            },\n            {\n                \"contact_type\": \"technical_contact\",\n                \"user_id\": 565615\n            },\n            {\n                \"contact_type\": \"ev_approver\",\n                \"first_name\": \"Jill\",\n                \"last_name\": \"Valentine\",\n                \"job_title\": \"STAR Member\",\n                \"telephone\": \"8017019600\",\n                \"email\": \"jill.valentine@digicert.com\"\n            }\n        ]\n    },\n    \"validity_years\": 2,\n    \"payment_method\": \"balance\"\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/ssl_ev_basic"

	payload := strings.NewReader("{\n    \"certificate\": {\n        \"common_name\": \"example.com\",\n    \"dns_names\": [\n      \"example2.com\",\n      \"example3.com\"\n    ],\n        \"csr\": \"<csr>\",\n        \"signature_hash\": \"sha256\",\n        \"organization_units\": [\n            \"Shared Services\"\n        ],\n        \"server_platform\": {\n            \"id\": 45\n        }\n    },\n    \"comments\": \"Certificate for app server.\",\n    \"container\": {\n        \"id\": 334455\n    },\n    \"auto_renew\": 1,\n    \"custom_renewal_message\": \"Keep this renewed.\",\n     \"organization\": {\n        \"id\": 123456,\n        \"contacts\": [\n            {\n                \"contact_type\": \"organization_contact\",\n                \"user_id\": 565611\n            },\n            {\n                \"contact_type\": \"technical_contact\",\n                \"user_id\": 565615\n            },\n            {\n                \"contact_type\": \"ev_approver\",\n                \"first_name\": \"Jill\",\n                \"last_name\": \"Valentine\",\n                \"job_title\": \"STAR Member\",\n                \"telephone\": \"8017019600\",\n                \"email\": \"jill.valentine@digicert.com\"\n            }\n        ]\n    },\n    \"validity_years\": 2,\n    \"payment_method\": \"balance\"\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_ev_basic',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { certificate: 
      { common_name: 'example.com',
        dns_names: [ 'example2.com', 'example3.com' ],
        csr: '<csr>',
        signature_hash: 'sha256',
        organization_units: [ 'Shared Services' ],
        server_platform: { id: 45 } },
     comments: 'Certificate for app server.',
     container: { id: 334455 },
     auto_renew: 1,
     custom_renewal_message: 'Keep this renewed.',
     organization: 
      { id: 123456,
        contacts: 
         [ { contact_type: 'organization_contact', user_id: 565611 },
           { contact_type: 'technical_contact', user_id: 565615 },
           { contact_type: 'ev_approver',
             first_name: 'Jill',
             last_name: 'Valentine',
             job_title: 'STAR Member',
             telephone: '8017019600',
             email: 'jill.valentine@digicert.com' } ] },
     validity_years: 2,
     payment_method: 'balance' },
  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.
.. contacts	obrigatório	array	Lista de contatos da organização para o pedido. Nota: É necessário incluir um contato `ev_approver`. Para obter possíveis aprovadores EV, veja Listar aprovadores.
.. .. contact_type	obrigatório	string	Tipo de contato para adicionar ao pedido. Valores permitidos: `organization_contact`, `technical_contact`, `ev_approver`
.. .. user_id	obrigatório^*	int	ID do usuário existente ou contato para a conta. * Pode ser omitido se adicionando um novo contato.
.. .. first_name	opcional	string	Primeiro nome do novo contato. Nota: Obrigatório ao omitir `user_id`. Se `user_id` não estiver omitido, as informações do usuário especificado serão atualizadas com o novo valor.
.. .. last_name	opcional	string	Sobrenome do novo contato. Nota: Obrigatório ao omitir `user_id`. Se `user_id` não estiver omitido, as informações do usuário especificado serão atualizadas com o novo valor.
.. .. job_title	opcional	string	Cargo de trabalho do novo contato. Nota: Obrigatório ao omitir `user_id`. Se `user_id` não estiver omitido, as informações do usuário especificado serão atualizadas com o novo valor.
.. .. telephone	opcional	string	Número de telefone do novo contato. Nota: Obrigatório ao omitir `user_id`. Se `user_id` não estiver omitido, as informações do usuário especificado serão atualizadas com o novo valor.
.. .. email	opcional	string	Endereço de e-mail do novo contato. Nota: Obrigatório ao omitir `user_id`. Se `user_id` não estiver omitido, as informações do usuário especificado serão atualizadas com o novo valor.
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