Zum Ende der Metadaten springen
Zum Anfang der Metadaten

Digicert API Doku hier abrufbar: https://www.digicert.com/services/v2/documentation

Mittels API können gescripted mehrere Requests relativ schnell, im Vergleich zu vielen manuellen Requests, abgesetzt werden.

 

Digicert's API documentation is available under: https://www.digicert.com/services/v2/documentation

The API for example provides the possibility to have bulk requests scripted instead of manually requests.

Inhalt/Content

Voraussetzung ist ein API Key/Precondition is a API Key

Voraussetzung für den Zugriff ohne Web-GUI ist ein "API Key". Diese können nur von Administratoren für die jeweilige Organisation auf folgendem Weg vergeben werden.

Hinweis: Wenn für jemanden anderen ein API Key erstellt wird, so ist dieser am besten auf sicherem Wege (zB. verschlüsselte Übertragung, Übertragung in 2 Teilen, etc.) zu übermitteln

Precondition to access Digicert without the web GUI is a API key. Only an administrative account can generate them.

Remark: A generated API key has to be transmitted in a secure way (encrypted, in two parts,...).

 

Hinzufügen eines API Keys/Add a API key:

Account -> Account Access

  • API Key hinzufügen/Add API Key:

  • API Key für bestimmten User hinzufügen (Beschreibung zur Übersicht eintragen)/Add a new API Key for a user (fill in a description to keep overview):

API Key Übersicht/API Key overview:

API Key Verwaltung/Handling of a API key

Der Wert des erzeugten Schlüssels ist - ähnlich einem Passwort - sicher zu verwahren bzw. abzuspeichern. Dieser Wert wird für den Zugriff via API benötigt! Der API Key ist auch von Administratoren nicht zu restoren, d.h. wenn der Key einmal verloren gegangen ist, muss dies gemeldet werden, der API Key widerrufen  und einer neuer ausgestellt werden! Daher aufpassen auf den Key, sicher verwahren, zB. in einem Passwortsafe.

An API key is similar to a password. Better keep it confidential (keep it in a password safe) and make sure to have it backed up as neither you nor the administrator can restore it if you loose it. If you fear that your API key is accessed unauthorized please notify your administrator and let the API key be revoked with undue delay.

API Zugriff/API Access

Beispiele/Examples

Container (=Divsion) abfragen/Request your Container (=Division)

Hinweis: Die Container ID (5 stellige Zahl) steht am Ende URL wenn man im Digicert Portal eingeloggt und unter Account -> My Division ist.

Remark: The container ID (5 digit number) can be found (you've to be logged in) at the very end of the URL under: Account -> My Division.

oder die Ausgabe in XML und leserlicher dargestellt (mittels xmllint)/output in XML format via xmllint

Domains anlegen/Add Domains

Mit der oben gezeigten for-Schleife werden alle Domains aus domains.txt (dort in der Form "domain.ac.at") für die Zertifikatstypen OV & EV unter der Organisation (anstatt 123456 ist die ID der entsprechenden Organisation einzusetzen) im Container (=ID der Division) mit dem User, hier durch den Wert des API Keys dargestellt, zur Validierung angelegt.

With this for-loop you can request domains within "domain.txt" for the certificate types OV & EV for the organisation (which is the parend_id see above) for the User (it is your API key).

 

Stichwörter
  • Keine
Schreiben Sie einen Kommentar...