Esta página descreve produtos com o nome de grupo client_certificate
(consulte Glossário — Identificadores de produtos).
Use este ponto de extremidade para enviar um pedido de solicitação de certificado do cliente usando client_premium_sha2
, client_email_security_plus
, client_authentication_plus
ou client_digital_signature_plus_sha2
como client_certificate_id.
curl -X POST \
'https://www.digicert.com/services/v2/order/certificate/{{client_certificate_id}}' \
-H 'Content-Type: application/json' \
-H 'X-DC-DEVKEY: {{api_key}}' \
-d '{
"certificate": {
"common_name": "Lock Cole",
"emails": [
"locke.cole@example.com"
],
"signature_hash": "sha256",
"organization_units": [
"Accounting"
],
"csr": "<csr>"
},
"skip_approval": true,
"organization": {
"id": 112233
},
"container": {
"id": 445566
},
"validity_years": 1,
"payment_method": "balance"
}'
import requests
url = "https://www.digicert.com/services/v2/order/certificate/{{client_certificate_id}}"
payload = "{\n \"certificate\": {\n \"common_name\": \"Lock Cole\",\n \"emails\": [\n \"locke.cole@example.com\"\n ],\n \"signature_hash\": \"sha256\",\n \"organization_units\": [\n \"Accounting\"\n ],\n \"csr\": \"<csr>\"\n },\n \"skip_approval\": true,\n \"organization\": {\n \"id\": 112233\n },\n \"container\": {\n \"id\": 445566\n },\n \"validity_years\": 1,\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/{{client_certificate_id}}"
payload := strings.NewReader("{\n \"certificate\": {\n \"common_name\": \"Lock Cole\",\n \"emails\": [\n \"locke.cole@example.com\"\n ],\n \"signature_hash\": \"sha256\",\n \"organization_units\": [\n \"Accounting\"\n ],\n \"csr\": \"<csr>\"\n },\n \"skip_approval\": true,\n \"organization\": {\n \"id\": 112233\n },\n \"container\": {\n \"id\": 445566\n },\n \"validity_years\": 1,\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/{{client_certificate_id}}',
headers:
{ 'Content-Type': 'application/json',
'X-DC-DEVKEY': '{{api_key}}' },
body:
{ certificate:
{ common_name: 'Lock Cole',
emails: [ 'locke.cole@example.com' ],
signature_hash: 'sha256',
organization_units: [ 'Accounting' ],
csr: '<csr>' },
skip_approval: true,
organization: { id: 112233 },
container: { id: 445566 },
validity_years: 1,
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
}
Nome | Obr/Opc | Tipo | Descrição |
---|---|---|---|
certificate | obrigatório | object | Detalhes do certificado. |
.. common_name | obrigatório | string | Nome a ser protegido. |
.. emails | obrigatório | array | E-mails a serem colocados no certificado. |
.. signature_hash | obrigatório | string |
Algoritmo de hash usado para assinar o certificado. Valores permitidos: sha256
|
.. organization_units | opcional | array | Departamento na sua organização associado ao certificado. |
.. csr | opcional | string | Solicitação de Assinatura de Certificado (CSR). |
auto_renew | opcional | int | Número de vezes que o certificado deve ser renovado automaticamente. |
renewal_of_order_id | opcional | int | Se o pedido for uma renovação, insira a ID do pedido anterior. |
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
|
organization | obrigatório | object | Organização a associar com o pedido. |
.. id | obrigatório | int | ID da organização. |
container | opcional | object | Se necessário, especifique o recipiente em que o pedido deve ser colocado. |
.. id | opcional | int | ID do recipiente. |
validity_years | obrigatório | int |
Número de anos que o certificado é válido. Pode ser substituído por 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_years Formato: yyyy-MM-dd
|
custom_fields | opcional* | object |
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. |
payment_method | opcional | string |
Especifique o método de pagamento a usar. Valores permitidos: balance , card , profile Padrão: balance
|
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 .
|