Commander un certificat GeoTrust SSL DV

POST

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

Appelez ce point de terminaison pour demander un certificat GeoTrust DV SSL.

Ce certificat GeoTrust DV SSL plus flexible permet d'obtenir plus facilement le certificat GeoTrust DV adapté à vos besoins. Ce certificat remplace les produits GeoTrust Standard DV, GeoTrust Cloud DV et GeoTrust Wildcard DV.

cURL

curl -X POST \
  'https://www.digicert.com/services/v2/order/certificate/ssl_dv_geotrust_flex' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "certificate": {
        "common_name": "example.com",
        "dns_names": [
        	"sub.example.com",
        	"log.example.com"
        ],
        "csr": "<csr>",
        "server_platform": {
            "id": 2
        }
    },
    "custom_expiration_date": "",
    "comments": "Message for the approver.",
    "container": {
        "id": 69748
    },
    "custom_renewal_message": "Renew me.",
    "skip_approval": true,
    "disable_ct": 0,
    "validity_years": 1,
    "custom_fields": [
        {
            "metadata_id": 12,
            "value": "Invoice #12345"
        }
    ],
    "payment_method": "balance",
    "dcv_method": "email",
    "dcv_emails": [
    	{
    		"dns_name": "example.com",
    		"email_domain": "example.com",
    		"email": "admin@example.com"
    	},
    	{
    		"dns_name": "sub.example.com",
    		"email_domain": "example.com",
    		"email": "jim.smith@example.com"
    	},
    	{
    		"dns_name": "log.example.com",
    		"email_domain": "example.com",
    		"email": "it@example.com"
    	}
    ],
    "locale": "en",
    "technical_contact": {
        "first_name": "Jim",
        "last_name": "Smith",
        "telephone": "555-555-5555",
        "job_title": "IT Admin",
        "email": "jim.smith@example.com"
    }
}'

Python

import requests

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

payload = "{\n    \"certificate\": {\n        \"common_name\": \"example.com\",\n        \"dns_names\": [\n        \t\"sub.example.com\",\n        \t\"log.example.com\"\n        ],\n        \"csr\": \"<csr>\",\n        \"server_platform\": {\n            \"id\": 2\n        }\n    },\n    \"custom_expiration_date\": \"\",\n    \"comments\": \"Message for the approver.\",\n    \"container\": {\n        \"id\": 69748\n    },\n    \"custom_renewal_message\": \"Renew me.\",\n    \"skip_approval\": true,\n    \"disable_ct\": 0,\n    \"validity_years\": 1,\n    \"custom_fields\": [\n        {\n            \"metadata_id\": 12,\n            \"value\": \"Invoice #12345\"\n        }\n    ],\n    \"payment_method\": \"balance\",\n    \"dcv_method\": \"email\",\n    \"dcv_emails\": [\n    \t{\n    \t\t\"dns_name\": \"example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"admin@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"sub.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"jim.smith@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"log.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"it@example.com\"\n    \t}\n    ],\n    \"locale\": \"en\",\n    \"technical_contact\": {\n        \"first_name\": \"Jim\",\n        \"last_name\": \"Smith\",\n        \"telephone\": \"555-555-5555\",\n        \"job_title\": \"IT Admin\",\n        \"email\": \"jim.smith@example.com\"\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/ssl_dv_geotrust_flex"

	payload := strings.NewReader("{\n    \"certificate\": {\n        \"common_name\": \"example.com\",\n        \"dns_names\": [\n        \t\"sub.example.com\",\n        \t\"log.example.com\"\n        ],\n        \"csr\": \"<csr>\",\n        \"server_platform\": {\n            \"id\": 2\n        }\n    },\n    \"custom_expiration_date\": \"\",\n    \"comments\": \"Message for the approver.\",\n    \"container\": {\n        \"id\": 69748\n    },\n    \"custom_renewal_message\": \"Renew me.\",\n    \"skip_approval\": true,\n    \"disable_ct\": 0,\n    \"validity_years\": 1,\n    \"custom_fields\": [\n        {\n            \"metadata_id\": 12,\n            \"value\": \"Invoice #12345\"\n        }\n    ],\n    \"payment_method\": \"balance\",\n    \"dcv_method\": \"email\",\n    \"dcv_emails\": [\n    \t{\n    \t\t\"dns_name\": \"example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"admin@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"sub.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"jim.smith@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"log.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"it@example.com\"\n    \t}\n    ],\n    \"locale\": \"en\",\n    \"technical_contact\": {\n        \"first_name\": \"Jim\",\n        \"last_name\": \"Smith\",\n        \"telephone\": \"555-555-5555\",\n        \"job_title\": \"IT Admin\",\n        \"email\": \"jim.smith@example.com\"\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/ssl_dv_geotrust_flex',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { certificate: 
      { common_name: 'example.com',
        dns_names: [ 'sub.example.com', 'log.example.com' ],
        csr: '<csr>',
        server_platform: { id: 2 } },
     custom_expiration_date: '',
     comments: 'Message for the approver.',
     container: { id: 69748 },
     custom_renewal_message: 'Renew me.',
     skip_approval: true,
     disable_ct: 0,
     validity_years: 1,
     custom_fields: [ { metadata_id: 12, value: 'Invoice #12345' } ],
     payment_method: 'balance',
     dcv_method: 'email',
     dcv_emails: 
      [ { dns_name: 'example.com',
          email_domain: 'example.com',
          email: 'admin@example.com' },
        { dns_name: 'sub.example.com',
          email_domain: 'example.com',
          email: 'jim.smith@example.com' },
        { dns_name: 'log.example.com',
          email_domain: 'example.com',
          email: 'it@example.com' } ],
     locale: 'en',
     technical_contact: 
      { first_name: 'Jim',
        last_name: 'Smith',
        telephone: '555-555-5555',
        job_title: 'IT Admin',
        email: 'jim.smith@example.com' } },
  json: true };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

201 201 Created (email)

{
  "id": 6484932,
  "certificate_id": 6079436
}

201 201 Created (dns-txt-toke or http-token)

{
  "id": 6484932,
  "certificate_id": 6079436
  "dcv_random_value": "icru1984rnekfj"
}

Paramètres de demande

Pour obtenir des informations sur les valeurs autorisées des champs du certificat, consultez la page Certificats publics – Entrées de données non conformes aux normes en vigueur dans 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).
.. organization_units	Facultatif	array	Service de votre organisation auquel le certificat est destiné.
.. server_platform	Facultatif	object	Type de plate-forme serveur. Par défaut : `-1` (autre)
.. .. id	Obligatoire	int	Identificateur de la plate-forme serveur. Consultez le Glossaire — Plateformes serveurs.
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`.
validity_days	Facultatif	int	Nombre de jours pendant lesquels le certificat est valide une fois émis. Remplace `validity_years`
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é. 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. 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.).
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` Par défaut : `balance`
dcv_method	Obligatoire	string	Méthode DCV à utiliser pour vérifier le contrôle d’un domaine. Consultez le Glossaire — Méthodes DCV.
dcv_emails	Facultatif	array	Liste spécifiant l’étendue des adresses électroniques auxquelles les courriers DCV sont envoyés. Vous pouvez ajouter une entrée pour chaque nom DNS protégé par le certificat.
.. dns_name	Obligatoire	string	Nom DNS du certificat auquel cette étendue doit s’appliquer.
.. email_domain	Obligatoire	string	Enregistrement de domaine WHOIS à utiliser pour vérifier les adresses électroniques. Cette valeur doit correspondre au `dns_names` domaine de base.
.. email	Facultatif	string	Adresse électronique utilisée pour envoyer les courriers DCV. Cette adresse électronique doit apparaître sur l’enregistrement WHOIS du domaine spécifié dans le `email_domain` paramètre.
locale	Facultatif	string	Langue à utiliser dans le courrier électronique DCV. Consultez le Glossaire — Codes de paramètres régionaux.
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. 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. Par défaut : `false`
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.
technical_contact	Facultatif	object	Détails du contact technique.
.. first_name	Obligatoire	string
.. last_name	Obligatoire	string
.. telephone	Obligatoire	string
.. job_title	Facultatif	string
.. email	Obligatoire	string

Paramètres de réponse

Nom	Type	Description
id	int	ID de la commande
certificate_id	int	ID du certificat
dcv_random_value	string	Valeur aléatoire utilisée pour valider le contrôle d’un domaine. Renvoyée seulement si la méthode DCV utilisée est `dns-txt-token` ou `http-token` .

Paramètres de demande

Paramètres de réponse

À propos de