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 -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"
}
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))
}
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);
});
{
"id": 112233,
"requests": [
{
"id": 113,
"status": "pending"
}
]
}
{
"id": 112233,
"requests": [
{
"id": 113,
"status": "submitted"
}
]
}
{
"id": 112233,
"requests": [
{
"id": 113,
"status": "approved"
}
],
"certificate_id": 113
}
{
"id": 112233,
"certificate_id": 113
}
{
"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>"
}
]
}
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.
|
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. |
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 .
|