SSL/TLS-Anbieter-Zugangsdaten anhand der angegebenen ID abrufen¶

Note

Diese Anfrage steht nur Mitgliedern der Root-Gruppe und Organisationsadministratoren zur Verfügung. Gelöschte oder nicht vorhandene Zugangsdaten liefern immer eine 403-Antwort anstelle einer 404-Antwort, sodass ihre Existenz nicht aus der Antwort abgeleitet werden kann.

Senden einer GET-Anfrage an den Endpunkt /ssl/providers/{id}.

Beschreibung¶

Mit der Get-Ssl-Provider-Credentials-Anfrage rufen Sie einen einzelnen Satz von SSL/TLS-Anbieter-Zugangsdaten der Organisation ab.

Voraussetzungen¶

Werte der Anfrage: Provider-ID {id}

Objekte: keine

Anfrage¶

Um einen Satz von SSL/TLS-Anbieter-Zugangsdaten abzurufen, muss die Provider-ID {id} dem Pfad der Anfrage hinzugefügt werden. Als Ergebnis wird das Objekt SslProviderCredentialsVO mit den angefragten Informationen zurückgegeben.

Das Objekt liefert die folgenden Informationen:

Attribut	Beschreibung	Werte
`id`	Die ID des Zugangsdaten-Eintrags.	`integer`
`name`	Der Name des Zugangsdaten-Eintrags.	`string`
`provider`	Der ACME-Anbieter, zu dem diese Zugangsdaten gehören.	`SECTIGO` `DTRUST`
`email`	Die Kontakt-E-Mail-Adresse des ACME-Kontos. Bei dem Anbieter `DTRUST` immer leer.	`string`
`endpoint`	Die ACME-Endpunkt-URL. Erforderlich für den Anbieter `SECTIGO`.	`string`
`eabKid`	Die EAB-Schlüsselkennung (External Account Binding) des ACME-Kontos.	`string`
`eabHmac`	Der EAB-HMAC-Schlüssel des ACME-Kontos. Nur für Myra-Superadmins sichtbar, wird nie an Kundenadministratoren zurückgegeben.	`string`
`cert`	Das ACME-Kontozertifikat. Nur für Myra-Superadmins sichtbar, wird nie an Kundenadministratoren zurückgegeben.	`string`
`privateKey`	Der private Schlüssel, der zu `cert` gehört. Nur für Myra-Superadmins sichtbar, wird nie an Kundenadministratoren zurückgegeben.	`string`
`comment`	Ein individueller Kommentar für den Eintrag.	`string`
`modified`	Das Datum der letzten Änderung, im ISO-8601-Format.	`string($date-time)`
`created`	Das Erstellungsdatum, im ISO-8601-Format.	`string($date-time)`

Beispiel¶

Beispiel-Antwort:

{
  "id": 0,
  "name": "string",
  "provider": "SECTIGO",
  "email": "string",
  "endpoint": "string",
  "eabKid": "string",
  "eabHmac": "string",
  "cert": "string",
  "privateKey": "string",
  "comment": "string",
  "modified": "2026-01-01T00:00:00+00:00",
  "created": "2026-01-01T00:00:00+00:00"
}

Antworten¶

Die folgenden Antworten sind möglich:

STATUSCODE	BESCHREIBUNG
200	Die Anfrage war erfolgreich.
401	Die Anfrage war nicht erfolgreich, da die Authentifizierung fehlerhaft war.
403	Die Anfrage war nicht erfolgreich, da die erforderlichen Berechtigungen fehlen.