GeoTrust DV-SSL bestellen

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

Verwenden Sie diesen Endpunkt, um ein GeoTrust DV SSL-Zertifikat zu beantragen.

Dieses flexiblere GeoTrust DV SSL-Zertifikat erleichtert es Ihnen, das GeoTrust DV-Zertifikat zu erhalten, das Sie benötigen. Dieses Zertifikat ersetzt die GeoTrust Standard DV-, GeoTrust Cloud DV- und GeoTrust Wildcard DV-Produkte.

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)
Go
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"
}

Antragsparameter

Welche Werte für die Zertifikatsfelder zulässig sind, erfahren Sie hier: Öffentlich Zertifikate – Dateneinträge, die gegen Branchenstandards verstoßen.

Name Antr./Opt. Typ Beschreibung
certificate erforderlich object Zertifikatsdetails.
.. common_name erforderlich string Zu schützende Domäne.
.. dns_names optional array Weitere zu schützende Domänen.
Kann zusätzliche Kosten verursachen. (Siehe Best Practices – Beide Versionen einer Domäne kostenlos erhalten.)
.. csr erforderlich* string CSR (Certificate Signing Request)
.. organization_units optional array Abteilung in Ihrem Unternehmen, für die das Zertifikat bestimmt ist.
.. server_platform optional object Serverplattformtyp.
Standard: -1 (Andere)
.. .. id erforderlich int Serverplattform-ID.
Siehe  Glossar – Serverplattformen.
renewed_thumbprint optional string Falls der Auftrag eine Verlängerung betrifft, geben Sie den SHA-1-Fingerabdruck des primären Zertifikats des vorherigen Auftrags ein.
validity_years erforderlich int Die Laufzeit des Zertifikats in Jahren.
Kann ersetzt werden durch validity_days oder custom_expiration_date.
Zulässige Werte: 12.
validity_days optional int Die Laufzeit des Zertifikats nach Aussstellung in Tagen.
Setzt validity_years außer Kraft.
custom_expiration_date optional string Benutzerdefiniertes Ablaufdatum für das Zertifikat.
Das Datum muss weniger als 825 Tage in der Zukunft liegen.
Setzt das validity_days - und das validity_years
-Format außer Kraft: yyyy-MM-dd
comments optional string Anmerkungen zum Auftrag für den Genehmiger.
auto_renew optional int Soll das Zertifikat automatisch erneuert werden?
Standard: 0
Zulässige Werte:  0 (deaktiviert), 1  (aktiviert)
custom_renewal_message optional string Benutzerdefinierte Nachricht, die in die Verlängerungsbenachrichtigungen aufgenommen werden soll.
disable_renewal_notifications optional bool Sollen Verlängerungsbenachrichtigungen per E-Mail deaktiviert werden?
Standard: false
additional_emails optional array Zusätzliche E-Mail-Adressen, die Zertifikatsbenachrichtigungen erhalten sollen (z. B. Zertifikatsausstellung, Zweitzertifikat, Zertifikatsverlängerung usw.).
renewal_of_order_id optional int Falls der Auftrag eine Verlängerung betrifft, geben Sie die ID des vorherigen Auftrags ein.
payment_method optional string Geben Sie die zu verwendende Zahlungsmethode an.
Zulässige Werte: balancecardprofile
Standard: balance
dcv_method erforderlich string Zu verwendende DCV-Methode zur Bestätigung der Domänenkontrolle.
Siehe Glossar – DCV-Methoden.
dcv_emails optional array Liste der E-Mail-Empfänger beim Senden von DCV-E-Mails.
Sie können für jeden DNS-Namen, der durch das Zertifikat geschützt werden soll, einen Eintrag hinzufügen.
.. dns_name erforderlich string DNS-Name auf dem Zertifikat, für den dieser Empfängerkreis gelten soll.
.. email_domain erforderlich string Für die Bestätigung der E-Mail-Adressen zu verwendender WHOIS-Domäneneintrag.
Dieser Wert muss mit der dns_names Basisdomäne übereinstimmen.
.. email optional string Zum Senden von DCV-E-Mails verwendete E-Mail-Adresse.
Diese E-Mail Adresse muss auf dem WHOIS-Eintrag für die im email_domain Parameter angegebene Domäne erscheinen.
locale optional string Sprache, die in der DCV-E-Mail verwendet werden soll.
Glossar  – Gebietsschemacodes.
skip_approval optional bool Soll der Auftrag den Genehmigungsschritt überspringen und sofort nach der unverzüglichen Validierung ausgestellt werden?
Standard: false
disable_ct optional bool Soll die CT-Protokollierung für das Zertifikat deaktiviert werden?
Die auftragsspezifische CT-Protokollierung muss aktiviert sein, sonst wird dieser Punkt ignoriert.
Siehe Benutzern gestatten, Zertifikate von der CT-Protokollierung auszuschließen.
Standard: false
container optional object Geben Sie ggf. den Container an, unter dem der Auftrag platziert werden soll.
.. id erforderlich int Container-ID
custom_fields optional* array Kontospezifische benutzerdefinierte Felder.
* Ob diese Felder erforderlich sind, hängt von den Einstellungen Ihrer benutzerdefinierten Felder ab.
.. metadata_id erforderlich int ID des benutzerdefinierten Felds
.. value erforderlich string Wert für das benutzerdefinierte Feld.
Der Datenvalidierungstyp hängt von den Einstellungen Ihrer benutzerdefinierten Felder ab.
technical_contact optional object Daten des technischen Kontakts.
.. first_name erforderlich string
.. last_name erforderlich string
.. telephone erforderlich string
.. job_title optional string
.. email erforderlich string

Reaktionsparameter

Name Typ Beschreibung
id int Auftrags-ID
certificate_id int Zertifikats-ID
dcv_random_value string Zufallswert zur Validierung der Domänenkontrolle
Wird nur zurückgegeben, wenn entweder  dns-txt-token  oder  http-token  als DCV-Methode verwendet wird.