Client-Zertifikat bestellen

POST
https://www.digicert.com/services/v2/order/certificate/{{client_certificate_id}}

Diese Seite beschreibt die Produkte mit dem client_certificate-Gruppennamen (siehe Glossar – Produkt-ID).

Verwenden Sie diesen Endpunkt, um einen Client-Zertifikatsauftrag unter Verwendung von client_premium_sha2, client_email_security_plus, client_authentication_plus oder client_digital_signature_plus_sha2 als client_certificate_id zu erteilen.

cURL
curl -X POST \
  'https://www.digicert.com/services/v2/order/certificate/{{client_certificate_id}}' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
  "certificate": {
    "common_name": "Lock Cole",
    "emails": [
      "locke.cole@example.com"
    ],
    "signature_hash": "sha256",
    "organization_units": [
      "Accounting"
    ],
    "csr": "<csr>"
  },
  "skip_approval": true,
  "organization": {
    "id": 112233
  },
  "container": {
    "id": 445566
  },
  "validity_years": 1,
  "payment_method": "balance"
}'
Python
import requests

url = "https://www.digicert.com/services/v2/order/certificate/{{client_certificate_id}}"

payload = "{\n  \"certificate\": {\n    \"common_name\": \"Lock Cole\",\n    \"emails\": [\n      \"locke.cole@example.com\"\n    ],\n    \"signature_hash\": \"sha256\",\n    \"organization_units\": [\n      \"Accounting\"\n    ],\n    \"csr\": \"<csr>\"\n  },\n  \"skip_approval\": true,\n  \"organization\": {\n    \"id\": 112233\n  },\n  \"container\": {\n    \"id\": 445566\n  },\n  \"validity_years\": 1,\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/{{client_certificate_id}}"

	payload := strings.NewReader("{\n  \"certificate\": {\n    \"common_name\": \"Lock Cole\",\n    \"emails\": [\n      \"locke.cole@example.com\"\n    ],\n    \"signature_hash\": \"sha256\",\n    \"organization_units\": [\n      \"Accounting\"\n    ],\n    \"csr\": \"<csr>\"\n  },\n  \"skip_approval\": true,\n  \"organization\": {\n    \"id\": 112233\n  },\n  \"container\": {\n    \"id\": 445566\n  },\n  \"validity_years\": 1,\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/{{client_certificate_id}}',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { certificate: 
      { common_name: 'Lock Cole',
        emails: [ 'locke.cole@example.com' ],
        signature_hash: 'sha256',
        organization_units: [ 'Accounting' ],
        csr: '<csr>' },
     skip_approval: true,
     organization: { id: 112233 },
     container: { id: 445566 },
     validity_years: 1,
     payment_method: 'balance' },
  json: true };

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

  console.log(body);
});
201 Created (one-step approval)
{
    "id": 112233,
    "requests": [
        {
            "id": 113,
            "status": "pending"
        }
    ]
}
201 Created (two-step approval)
{
    "id": 112233,
    "requests": [
        {
            "id": 113,
            "status": "submitted"
        }
    ]
}
201 Created (auto approval)
{
    "id": 112233,
    "requests": [
        {
            "id": 113,
            "status": "approved"
        }
    ],
    "certificate_id": 113
}

Antragsparameter

Name Antr./Opt. Typ Beschreibung
certificate erforderlich object Zertifikatsdetails
.. common_name erforderlich string Zu schützender Name
.. emails erforderlich array Auf dem Zertifikat zu platzierende E-Mails-Adressen
.. signature_hash erforderlich string Zum Signieren des Zertifikats verwendeter Hash-Algorithmus.
Zulässige Werte: sha256
.. organization_units optional array Abteilung in Ihrem Unternehmen, die mit dem Zertifikat verknüpft ist
.. csr optional string CSR (Certificate Signing Request)
auto_renew optional int Wie oft soll das Zertifikat automatisch verlängert werden
renewal_of_order_id optional int Falls der Auftrag eine Verlängerung betrifft, geben Sie die ID des vorherigen Auftrags ein.
skip_approval optional bool Soll der Auftrag den Genehmigungsschritt überspringen und sofort nach der unverzüglichen Validierung ausgestellt werden?
Standard: false
organization erforderlich object Mit dem Auftrag zu verknüpfende Organisation
.. id erforderlich int Organisations-ID
container optional object Geben Sie ggf. den Container an, unter dem der Auftrag platziert werden soll.
.. id optional int Container-ID
validity_years erforderlich int Die Laufzeit des Zertifikats in Jahren
Kann durch das 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_years außer Kraft
Format: yyyy-MM-dd
custom_fields optional* object 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.
payment_method optional string Geben Sie die zu verwendende Zahlungsmethode an.
Zulässige Werte: balance, card, profile
Standard: balance

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