SSL-Anfrage aktualisieren¶

Note

algorithm kann nach dem Erstellen der Anfrage nicht mehr geändert werden; ein Änderungsversuch wird mit einer 400-Antwort abgelehnt. Das Hinzufügen eines Subject Alternative Name, der noch nicht von einem ausgestellten Zertifikat abgedeckt ist, oder das Ändern von provider, renewalInterval oder signatureAlgorithm, während die Anfrage noch in Bearbeitung ist, löst eine neue asynchrone Zertifikatsausstellung aus.

Senden einer PUT-Anfrage an den Endpunkt /ssl/requests/{id}.

Beschreibung¶

Mit der UpdateSslRequest-Anfrage aktualisieren Sie eine bestehende SSL-Anfrage der Organisation, zum Beispiel um Subject Alternative Names hinzuzufügen oder zu entfernen, den Anbieter zu ändern oder das Erneuerungsintervall zu ändern.

Voraussetzungen¶

Werte der Anfrage: Request-ID {id}

Objekte: SslCertRequestVO

Anfrage¶

Um eine SSL-Anfrage zu aktualisieren, fügen Sie die Request-ID {id} dem Pfad der Anfrage und das Objekt SslCertRequestVO dem Body der Anfrage hinzu. Die folgenden Attribute sind erforderlich:

Attribut	Beschreibung	Werte
`algorithm`	Der für das Zertifikat verwendete Schlüsselalgorithmus.	`RSA2048` `RSA4096` `RSA8192` `ECDSA256` `ECDSA384`
`provider`	Der SSL/TLS-Anbieter, der das Zertifikat ausstellt.	`LETS_ENCRYPT` `SECTIGO` `DTRUST`
`subjectAlternativeNames`	Ein Array von `SslCertRequestSanVO`-Objekten, jeweils mit dem Attribut `name` (`string`), dem vollqualifizierten Domainnamen, der vom Zertifikat abgedeckt werden soll. Mindestens ein Eintrag ist erforderlich, maximal 100 Einträge sind zulässig.	`array`

Die folgenden Attribute sind optional:

Attribut	Beschreibung	Werte
`assignments`	Ein Array von `SslCertRequestAssignmentVO`-Objekten, jeweils mit dem Attribut `subDomainName` (`string`), der Subdomain, der die Anfrage das resultierende Zertifikat zuweist.	`array`
`sslProviderCredentialsId`	Die ID des `SslProviderCredentials`-Objekts, das zum Ausstellen des Zertifikats verwendet werden soll.	`integer`
`renewalInterval`	Die Anzahl der Tage vor Ablauf des Zertifikats, zu der das Zertifikat erneuert wird. Nur verfügbar für die Anbieter `SECTIGO` und `DTRUST`.	`integer`
`signatureAlgorithm`	Der für das Zertifikat verwendete Signaturalgorithmus. Nur verfügbar für die Anbieter `SECTIGO` und `DTRUST`.	`SHA256` `SHA384` `SHA512`

Die folgenden Attribute werden vom System gesetzt und können nicht von Ihnen angegeben werden: id, status, multiDomain, created, modified.

Beispiel¶

Beispiel-Request-Body:

{
  "algorithm": "RSA2048",
  "provider": "LETS_ENCRYPT",
  "subjectAlternativeNames": [
    {
      "name": "www.example.com"
    }
  ],
  "assignments": [
    {
      "subDomainName": "www.example.com"
    }
  ],
  "sslProviderCredentialsId": 1,
  "renewalInterval": 30,
  "signatureAlgorithm": "SHA256"
}

Antworten¶

Die folgenden Antworten sind möglich:

STATUSCODE	BESCHREIBUNG
200	Die Anfrage war erfolgreich.
400	Die Anfrage war nicht erfolgreich. Die Anfrage war fehlerhaft oder es fehlen Informationen.
401	Die Anfrage war nicht erfolgreich, da die Authentifizierung fehlerhaft war.
403	Die Anfrage war nicht erfolgreich, da die erforderlichen Berechtigungen fehlen.
404	Die Anfrage war nicht erfolgreich, da die angeforderte Ressource nicht gefunden wurde.