2.12 SSL-Abonnementinformationen ersetzen
2.12.1 API-Informationen
| Testumgebung | |
|---|---|
| Produktivumgebung | https://portal.racent.com/ssl/replace |
| Anfragemethode | POST |
| content-type | multipart/form-data |
| Beschreibung | Diese Schnittstelle dient zum Ersetzen von SSL-Abonnementinformationen. Sie bezieht sich ausschließlich auf SSL-Zertifikate. Nur wenn sich der SSL-Abonnementstatus auf „Ausgestellt“ befindet, ist das Ersetzen der SSL-Abonnementinformationen zulässig. |
2.12.2 Parameterdefinition
| Parametername | Parametertyp | Pflichtfeld | Beschreibung |
|---|---|---|---|
| api_token | String | Y | Identitätsnachweis. Zur Erstellung eines Tokens wenden Sie sich bitte an den technischen Support von Racent. |
| certId | String | Y | racent-Zertifikat-ID |
| refId | String | N | Eindeutige Kundenbestellnummer, die vom Kunden bereitgestellt wird |
| domainVerificationPic | File | N | Wenn die Domainvalidierungsmethode VERIFY_DOCUMENT ist, ist dieses Feld Y. Wird für die Domain Control Validation (DCV) verwendet (derzeit nur CFCA unterstützt). |
| params | String | Y | Ersatzinformationen, wie unten beschrieben |
| csr | String | Y | Hinweis: Die Domains in den CSR-Informationen müssen mit den Domains im CSR des ursprünglichen SSL-Abonnements übereinstimmen. |
| uniqueValue | String | N | Nur für Sectigo-Produkte relevant. 1–20 Zeichen (a-z A-Z 0-9) für einen vom Distributor selbst generierten Validierungswert. |
| dcvMethod | String | N | Legt die Domainvalidierungsmethode für den Zertifikatsantrag einheitlich fest. Muss eine der folgenden vier Methoden sein: EMAIL (E-Mail-Validierung) HTTP_CSR_HASH (Dateivalidierung) CNAME_CSR_HASH (DNS-Validierung) HTTPS_CSR_HASH (HTTPS-Dateivalidierung) VERIFY_DOCUMENT (Domainzertifikatsnachweis, nur CFCA unterstützt) Für CFCA ist dieses Feld Y |
| domainInfo | String | Y | Domäneninformationen. Beispiel: [ { "dcvEmail": "admin@xxx.com", "dcvMethod": "EMAIL", "domainName": "www.xxx.com" }, { "dcvEmail": "admin@aaa.com", "dcvMethod": "EMAIL", "domainName": "aaa.com" }, "dcvEmail": "admin@racent.com", "dcvMethod": "EMAIL", "domainName": "racent.com" } ] Detaillierte Beschreibung wie folgt: |
| dcvMethod | String | Y | Methode zur Domänenvalidierung. Muss eine der folgenden vier Methoden sein: EMAIL (E-Mail-Validierung) HTTP_CSR_HASH (Dateivalidierung) CNAME_CSR_HASH (DNS-Validierung) HTTPS_CSR_HASH (HTTPS-Dateivalidierung) Wenn die übergeordnete dcvMethod nicht vorhanden ist, ist dieses Feld Y. Wenn die übergeordnete dcvMethod vorhanden ist und dieses Feld ebenfalls vorhanden ist, wird die übergeordnete dcvMethod priorisiert. |
| dcvEmail | String | N | E-Mail für die Domänenvalidierung. Wenn dieses Feld N ist, gelten folgende Standardwerte: racent.com : admin@racent.com www.racent.com : admin@racent.com *.racent.com : admin@racent.com |
| domainName | String | Y | Domäne |
| organizationInfo | String | N | Wenn Sie die Unternehmensinformationen ändern müssen, ist dieser Parameter Y. |
| organizationCity | String | N | Stadt des Unternehmens. |
| organizationName | String | N | Name des Unternehmens. |
| organizationMobile | String | N | Telefonnummer des Unternehmens. |
| organizationAddress | String | N | Adresse des Unternehmens. |
| organizationCountry | String | N | Land des Unternehmens (zweistelliger Ländercode nach ISO 3166-1). |
| organizationPostCode | String | N | Postleitzahl des Unternehmensstandorts. |
Rückgabewert der Funktion
| Parametername | Parametertyp | Pflicht | Beschreibung |
|---|---|---|---|
| code | Int | Y | Rückgabestatus, Details siehe Anhang 3.1 |
| errors | Object or String | N | Bei einem Fehlerstatus die spezifischen Fehlerinformationen. |
| data | Object | N | Bei erfolgreichem Status ist dieser Parameter Y. Details siehe unten: |
| certId | String | N | racent-Zertifikats-ID. Bitte sicher aufbewahren; dieser Parameter ist der eindeutige Nachweis der racent-Instanz. |
| vendorId | String | N | CA-Bestellnummer. |
| vendorCertId | String | N | CA-Zertifikatsnummer. |
| DCVfileName | String | N | Dateiname für die Dateivalidierung |
| DCVfileContent | String | N | Dateiinhalt für die Dateivalidierung |
| DCVdnsHost | String | N | Hostwert für die DNS-Validierung |
| DCVdnsValue | String | N | Recordwert für die DNS-Validierung |
| DCVdnsType | String | N | Recordtyp für die DNS-Validierung |
| DCVfilePath | String | N | Dateipfad für die Dateivalidierung |
| dcvInfo | Object | N | Wenn die Verifizierungswerte für jede Domain im Zertifikatsantrag unterschiedlich sind, ist dieser Wert Y. Jeder Eintrag ist vom Typ Object, der Objektname ist jeweils die beantragte Domain, z. B. racent.com. Details zu jedem Eintrag: |
| DCVfileName | String | N | Inhalt der Datei für die Dateivalidierung |
| DCVfileContent | String | N | Inhalt der Datei für die Dateivalidierung |
| DCVdnsHost | String | N | Hostwert für die DNS-Validierung |
| DCVdnsValue | String | N | Recordwert für die DNS-Validierung |
| DCVdnsType | String | N | Recordtyp für die DNS-Validierung |
| DCVfilePath | String | N | Pfad der Datei für die Dateivalidierung |