Zertifikate der angegebenen SSL/TLS-Anbieter-Zugangsdaten auflisten¶

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.

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

Beschreibung¶

Mit der List-Ssl-Provider-Certificates-Anfrage rufen Sie alle SSL/TLS-Zertifikate ab, die mit bestimmten SSL/TLS-Anbieter-Zugangsdaten ausgestellt wurden.

Voraussetzungen¶

Werte der Anfrage: Provider-ID {id}

Objekte: keine

Anfrage¶

Um die Zertifikate von SSL/TLS-Anbieter-Zugangsdaten abzurufen, fügen Sie die Provider-ID {id} in den Pfad der Anfrage ein. Die Anfrage unterstützt die optionalen Query-Parameter search, page, pageSize und language zum Filtern und Paginieren des Ergebnisses. Als Ergebnis wird eine Liste von Objekten SslCertSummaryVO mit den angefragten Informationen zurückgegeben.

Das Objekt liefert die folgenden Informationen:

Attribut	Beschreibung	Werte
`id`	Die ID des Zertifikats.	`integer`
`subject`	Der Subject des Zertifikats.	`string`
`subjectAlternatives`	Ein Array aller Subdomains, für die das Zertifikat gültig ist.	`array`
`algorithm`	Der Algorithmus, mit dem das Zertifikat verschlüsselt wird.	`string`
`validFrom`	Das Datum im ISO-8601-Format, ab dem das Zertifikat gültig ist.	`string($date-time)`
`validTo`	Das Datum im ISO-8601-Format, bis zu dem das Zertifikat gültig ist.	`string($date-time)`
`fingerprint`	Der Fingerprint des Zertifikats.	`string`
`serialNumber`	Die Seriennummer des Zertifikats.	`string`
`wildcard`	Definiert, ob das Zertifikat für mehrere Subdomains einer Domain gültig ist. Das Zertifikat muss einen `*.domain.tld`-Subject haben, damit `true` zurückgegeben wird.	`true` `false`
`extendedValidation`	`true`, wenn der Browser das Zertifikat als Extended Validation behandelt. Myra verwendet die OIDs von Google Chrome, um den Extended-Validation-Level zu ermitteln.	`true` `false`
`managed`	Definiert, ob das Zertifikat von Myra verwaltet wird. Ein verwaltetes Zertifikat kann nicht über die API bearbeitet werden und ist schreibgeschützt.	`true` `false`
`multidomain`	Definiert, ob das Zertifikat zu einer Multi-Domain-SSL-Anfrage gehört.	`true` `false`
`sslConfigurationName`	Der Konfigurationsname aus der Tabelle `SslConfiguration`.	`string`
`requestId`	Die ID der SSL-Anfrage, für die das Zertifikat ausgestellt wurde, sofern vorhanden.	`integer`
`domainId`	Die ID der Domain, der das Zertifikat zugewiesen ist, sofern vorhanden.	`integer`
`subdomains`	Ein Array aller Subdomains, die aktuell von dem Zertifikat bedient werden.	`array`
`modified`	Das Datum der letzten Änderung im ISO-8601-Format.	`string($date-time)`
`created`	Das Erstellungsdatum im ISO-8601-Format.	`string($date-time)`

Aus Sicherheitsgründen enthält dieses Summary-Objekt niemals das Zertifikats-PEM, den privaten Schlüssel oder die Zwischenzertifikate.

Beispiel¶

Beispiel-Antwort:

[
  {
    "id": 0,
    "subject": "string",
    "subjectAlternatives": [],
    "algorithm": "string",
    "validFrom": "2026-01-01T00:00:00+00:00",
    "validTo": "2026-01-01T00:00:00+00:00",
    "fingerprint": "string",
    "serialNumber": "string",
    "wildcard": true,
    "extendedValidation": true,
    "managed": true,
    "multidomain": true,
    "sslConfigurationName": "string",
    "requestId": 0,
    "domainId": 0,
    "subdomains": [],
    "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.