Utilisez ce point de terminaison pour soumettre une demande de certificat SSL Secure Site Pro EV.
curl -X POST \
https://www.digicert.com/services/v2/order/certificate/ssl_ev_securesite_pro \
-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": 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"
}'
import requests
url = "https://www.digicert.com/services/v2/order/certificate/ssl_ev_securesite_pro"
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_securesite_pro"
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_securesite_pro',
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>"
}
]
}
Pour obtenir des informations sur les valeurs autorisées des champs du certificat, consultez la page Publicly Trusted Certificates – Data Entries that Violate Industry Standards (Certificats publiquement approuvés – Entrées de données non conformes aux normes de l’industrie).
Nom | Obligatoire/facultatif | Type | Description |
---|---|---|---|
certificate | Obligatoire | object | Détails du certificat |
.. common_name | Obligatoire | string | Domaine à protéger |
.. dns_names | Facultatif | array |
Domaines supplémentaires à protéger Peut entraîner des coûts supplémentaires. (consultez la page Bonnes pratiques — Obtenir gratuitement les deux versions d’un domaine.) |
.. csr | Obligatoire | string | Demande de signature de certificat (Certificate Signing Request, CSR) |
.. signature_hash | Obligatoire | string |
Algorithme de hachage utilisé pour signer le certificat. Les certificats de signature de code n’acceptent que l’algorithme SHA-256. |
.. organization_units | Facultatif | array | Service de votre organisation auquel le certificat est destiné. |
.. server_platform | Facultatif | object |
Type de plate-forme serveur Valeur par défaut : -1 (autre)
|
.. .. id | Obligatoire | int |
Identificateur de la plate-forme serveur Consultez le Glossaire — Plateformes serveurs. |
.. profile_option | Facultatif | string | Si vous utilisez des profils de certificat personnalisés, spécifiez le nom de profil. |
renewed_thumbprint | Facultatif | string | Si la commande est un renouvellement, saisir l’empreinte SHA-1 du certificat principal de la commande précédente. |
validity_years | Obligatoire | int |
Nombre d’années pendant lesquelles le certificat est valide Peut être remplacé par validity_days ou custom_expiration_date .Valeurs autorisées : 1 , 2
|
custom_expiration_date | Facultatif | string |
Date d’expiration personnalisée du certificat La date ne doit pas être ultérieure de 825 jours. Remplace validity_days et validity_years Format : yyyy-MM-dd
|
comments | Facultatif | string | Commentaires relatifs à la commande à l’attention de l’approbateur. |
auto_renew | Facultatif | int |
Spécifier si le certificat doit automatiquement être renouvelé. Valeur par défaut : 0 Valeurs autorisées : 0 (désactivé), 1 (activé)
|
custom_renewal_message | Facultatif | string | Message personnalisé à inclure dans les notifications de renouvellement |
disable_renewal_notifications | Facultatif | bool |
Spécifier si les notifications électroniques de renouvellement doivent être désactivées. Valeur par défaut : false
|
additional_emails | Facultatif | array | Adresses électroniques supplémentaires pour recevoir les courriers électroniques de notification des certificats (par exemple, émission du certificat, duplicata du certificat, renouvellement du certificat, etc.) |
locale | Facultatif | string |
Langue à utiliser dans le courrier électronique DCV Consultez le Glossaire — Codes de paramètres régionaux. |
renewal_of_order_id | Facultatif | int | Si la commande est un renouvellement, saisir l’ID de la commande précédente. |
payment_method | Facultatif | string |
Indique le mode de paiement à utiliser Valeurs autorisées : balance , card , profile Valeur par défaut : balance
|
dcv_method | Facultatif | string |
Méthode DCV à utiliser pour vérifier le contrôle d’un domaine Consultez le Glossaire — Méthodes DCV |
skip_approval | Facultatif | bool |
Spécifier si la commande peut immédiatement être envoyée pour validation et émise une fois finalisée sans passer par l’étape d’approbation. Valeur par défaut : false
|
disable_ct | Facultatif | bool |
Spécifier si la journalisation CT doit être désactivée pour le certificat. La journalisation CT spécifique à la commande doit être activée sinon cette fonction sera ignorée. Consultez la page Autoriser les utilisateurs à exclure des certificats de la journalisation CT. Valeur par défaut : false
|
organization | Obligatoire | object | Conteneur destiné aux détails de l’organisation |
.. id | Obligatoire | int |
ID de l’organisation à associer à la commande. Pour ajouter une nouvelle organisation lors de l’envoi d’une commande, vous pouvez aussi transmettre un objet Organisation. Consultez la page Créer une organisation pour connaître les exigences relatives à la structure d’objet. |
.. contacts | Obligatoire | array |
Liste des contacts de l'organisation associés à la commande. Remarque : Vous devez inclure un contact ev_approver . Pour obtenir les approbateurs potentiels EV, consultez la page Liste des approbateurs.
|
.. .. contact_type | Obligatoire | string |
Type de contact à ajouter à la commande. Valeurs autorisées : organization_contact , technical_contact , ev_approver
|
.. .. user_id | obligatoire* | int |
ID de l'utilisateur existant ou du contact pour le compte. * Peut être omis si l'on ajoute un nouveau contact. |
.. .. first_name | Facultatif | string |
Prénom du nouveau contact. Remarque : Requis en cas d'omission user_id . Si user_id n'est pas omis(e), les informations de l'utilisateur spécifié seront mises à jour avec la nouvelle valeur.
|
.. .. last_name | Facultatif | string |
Nom du nouveau contact. Remarque : Requis en cas d'omission user_id . Si user_id n'est pas omis(e), les informations de l'utilisateur spécifié seront mises à jour avec la nouvelle valeur.
|
.. .. job_title | Facultatif | string |
Intitulé de poste du nouveau contact. Remarque : Requis en cas d'omission user_id . Si user_id n'est pas omis(e), les informations de l'utilisateur spécifié seront mises à jour avec la nouvelle valeur.
|
.. .. telephone | Facultatif | string |
Numéro de téléphone du nouveau contact. Remarque : Requis en cas d'omission user_id . Si user_id n'est pas omis(e), les informations de l'utilisateur spécifié seront mises à jour avec la nouvelle valeur.
|
Facultatif | string |
Adresse électronique du nouveau contact. Remarque : Requis en cas d'omission user_id . Si user_id n'est pas omis(e), les informations de l'utilisateur spécifié seront mises à jour avec la nouvelle valeur.
|
|
container | Facultatif | object | Si besoin, spécifier le conteneur sous lequel la commande doit être passée. |
.. id | Obligatoire | int | ID du conteneur |
custom_fields | facultatif* | array |
Champs personnalisés en fonction du compte * Le caractère obligatoire ou facultatif de ces champs dépend des paramètres de champ personnalisé définis. |
.. metadata_id | Obligatoire | int | ID de champ personnalisé |
.. value | Obligatoire | string |
Valeur du champ personnalisé Le type de validation des données dépend des paramètres de champ personnalisé que vous avez définis. |
Nom | Type | Description |
---|---|---|
id | int | ID de la commande |
organization | object |
Conteneur destiné aux nouveaux détails de l’organisation Retourné seulement si une nouvelle organisation a été créée avec la commande. |
.. id | int | ID de la nouvelle organisation |
requests | array | Contient les informations relatives à la demande. |
.. id | int | ID de la demande |
.. status | string |
Statut de la demande Valeurs possibles : pending , submitted , approved , rejected
|
certificate_id | int |
ID du certificat Renvoyé si le statut de la demande est approved .
|