Secure Site Pro SSL bestellen

POST

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

Verwenden Sie diesen Endpunkt, um ein Secure Site Pro SSL-Zertifikat zu beantragen.

cURL

curl -X POST \
  https://www.digicert.com/services/v2/order/certificate/ssl_securesite_flex \
  -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": "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"
}'

Python

import requests

url = "https://www.digicert.com/services/v2/order/certificate/ssl_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\": 2\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                \"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_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\": 2\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                \"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))

}

NodeJS

var request = require("request");

var options = { method: 'POST',
  url: 'https://www.digicert.com/services/v2/order/certificate/ssl_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: 2 } },
     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',
             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);
});

201 (one-step)

{
  "id": 112233,
  "requests": [
    {
      "id": 113,
      "status": "pending"
    }
  ]
}

201 (two-step)

{
  "id": 112233,
  "requests": [
    {
      "id": 113,
      "status": "submitted"
    }
  ]
}

201 (auto)

{
  "id": 112233,
  "requests": [
    {
      "id": 113,
      "status": "approved"
    }
  ],
  "certificate_id": 113
}

201 (skip)

{
  "id": 112233,
  "certificate_id": 113
}

201 (immediate)

{
  "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>"
    }
  ]
}

Antragsparameter

Informationen über zulässige Werte für die Zertifikatsfelder: Öffentlich vertrauenswürdige 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)
.. signature_hash	erforderlich	string	Zum Signieren des Zertifikats verwendeter Hash-Algorithmus. Code Signing-Zertifikate unterstützen nur SHA-256.
.. 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
.. profile_option	optional	string	Falls Sie benutzerdefinierte Zertifikatsprofile verwenden, geben Sie den Namen des Profils an.
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 durch `validity_days` oder `custom_expiration_date` ersetzt werden. Zulässige Werte: `1`, `2`
custom_expiration_date	optional	string	Benutzerdefiniertes Ablaufdatum für das Zertifikat. Das Datum muss weniger als 825 Tage in der Zukunft liegen. Setzt `validity_days` und `validity_years` außer Kraft Format: `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.).
locale	optional	string	Sprache, die in der DCV-E-Mail verwendet werden soll Siehe Glossar – Gebietsschemacodes
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: `balance`, `card`, `profile` Standard: `balance`
dcv_method	optional	string	Zu verwendende DCV-Methode zur Bestätigung der Domänenkontrolle Siehe Glossar – DCV-Methoden
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`
organization	erforderlich	object	Container für Organisationsdetails.
.. id	erforderlich	int	ID der mit dem Auftrag zu verknüpfenden Organisation. Alternativ können Sie ein „Organisation“-Objekt einreichen, um eine neue Organisation hinzuzufügen, wenn Sie den Auftrag erteilen. Siehe Organisation erstellen, um die Anforderungen an die Objektstruktur zu erfahren.
.. contacts	optional	array	Liste der Organisationskontakte für den Auftrag. Hinweis: Falls er fehlt, wird der Standardkontakt für die angegebene Organisation verwendet.
.. .. contact_type	erforderlich	string	Anzugebender Kontakttyp. Zulässige Werte: `organization_contact`, `technical_contact`, `ev_approver`
.. .. user_id	erforderlich^*	int	ID des vorhandenen Benutzers oder Kontakts für das Konto. * Kann bei Hinzufügen eines neuen Kontakts weggelassen werden.
.. .. first_name	optional	string	Vorname des neuen Kontakts. Hinweis: Erforderlich, wenn `user_id` weglassen. Falls `user_id` nicht weggelassen wurde, werden die Informationen des angegebenen Benutzers mit dem neuen Wert aktualisiert.
.. .. last_name	optional	string	Nachname des neuen Kontakts. Hinweis: Erforderlich, wenn `user_id` weglassen. Falls `user_id` nicht weggelassen wurde, werden die Informationen des angegebenen Benutzers mit dem neuen Wert aktualisiert.
.. .. job_title	optional	string	Funktion des neuen Kontakts. Hinweis: Erforderlich, wenn `user_id` weglassen. Falls `user_id` nicht weggelassen wurde, werden die Informationen des angegebenen Benutzers mit dem neuen Wert aktualisiert.
.. .. telephone	optional	string	Telefonnummer des neuen Kontakts. Hinweis: Erforderlich, wenn `user_id` weglassen. Falls `user_id` nicht weggelassen wurde, werden die Informationen des angegebenen Benutzers mit dem neuen Wert aktualisiert.
.. .. email	optional	string	E-Mail-Adresse des neuen Kontakts. Hinweis: Erforderlich, wenn `user_id` weglassen. Falls `user_id` nicht weggelassen wurde, werden die Informationen des angegebenen Benutzers mit dem neuen Wert aktualisiert.
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.

Reaktionsparameter

Name	Typ	Beschreibung
id	int	Auftrags-ID
organization	object	Container für Details einer neuen Organisation. Wird nur zurückgegeben, falls mit dem Auftrag eine neue Organisation erstellt wurde.
.. id	int	ID für die neue Organisation.
requests	array	Enthält Informationen zu dem Antrag
.. id	int	Antrags-ID.
.. status	string	Antragsstatus Mögliche Werte: `pending`, `submitted`, `approved`, `rejected`
certificate_id	int	Zertifikats-ID Wird zurückgegeben, falls der Antragsstatus `approved` ist

Antragsparameter

Reaktionsparameter

Über