Secure Site EV bestellen

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

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

Dieses flexiblere Secure Site EV SSL-Zertifikat erleichtert es Ihnen, das Secure Site EV SSL-Zertifikat zu erhalten, das Sie benötigen. Dieses Zertifikat ersetzt die Secure Site EV SSL- und Secure Site Multi-Domain-Produkte.

cURL
curl -X POST \
  https://www.digicert.com/services/v2/order/certificate/ssl_ev_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": "ev_approver",
                "user_id": 565622
            },
            {
                "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_ev_securesite_flex"

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)
Go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

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

	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))

}
NodeJS
var request = require("request");

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

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 erforderlich array Liste der Organisationskontakte für den Auftrag.
Hinweis: Sie müssen einen ev_approver-Kontakt angeben. Für potenzielle EV-Genehmiger, siehe Genehmigerliste.
.. .. contact_type erforderlich string Zum Auftrag hinzuzufügender 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