Wir empfehlen, für das Tracking über die eigene Domain ein neues Zertifikat zu verwenden, das mittels Zertifikatanforderung unter Einstellungen → Tracking Code → Website Code erstellt und hochgeladen werden kann.
Alternativ kann ein vorhandenes Zertifikat (bestehend aus Zertifikat, Intermediate-Zertifikat und Key) an etracker gesendet werden.
Nutze hierzu einen POST-Request und Request-Body als JSON mit folgendem Inhalt:
| Attribut | Beschreibung | Pflichtfeld |
|---|---|---|
| cert | Zertifikat im Base64-Format | Ja |
| keyPrivate | Private-Key im Base64-Format | Ja |
| domain | Falls mehrere Domains im Zertifikat enthalten sind, kann über dieses Attribut eine Domain ausgewählt werden | Nein |
Die Route zum Upload lautet:
POST https://ws.etracker.com/api/v6/tracking/certificates/custom
Beispiel für einen vollständigen Payload (CURL):
curl --request POST \
--url https://ws.etracker.com/api/v6/tracking/certificates/custom \
--header 'Content-Type: application/json' \
--header 'X-ET-Token: f51a543h...7sd8765h' \
--data '{
"cert": "-----BEGIN CERTIFICATE-----\nMIICCA6Ggnldas8723QCqswDQYJKoZI...oOGmnlda87HfOx5+/VKBI=\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\nMIIDuTCCAqGgAwIBAgIUcgXVCtc8u...PItc1a4a1WiO7QIh2S\n-----END CERTIFICATE-----\n\n",
"keyPrivate": "-----BEGIN PRIVATE KEY-----\nKLkjdsMDANBgkqhkiG9w0BAQEFAASCCS0w=\n-----END PRIVATE KEY-----\n\n",
"domain": "test.example.com"
}'
Das Zugriffs-Token mit dem Zweck Zertifikate kann mit Administrations-Rechten unter Einstellungen → Account → Integrationen → Zugriffs-Token erstellt werden.
Bitte beachte: Die Key-Länge des Zertifikats ist auf 2048 Bit begrenzt. Bitte prüfe, dass die Zertifikatskette vollständig ist. Diese beinhaltet neben dem Zertifikat und dem Key auch das sogenannte Intermediate-Zertifikat. Besuche SSL-Labs, um zu überprüfen, ob die Zertifikatskette vollständig ist.
Bei erfolgreichem Upload des Zertifikats und des Keys erhältst du eine positive Server-Antwort (200 oder 204 Meldung). In deinem etracker Account siehst du dann unter Einstellungen → Tracking Code→Website Code deine hinterlegte Tracking Domain mit dem entsprechenden Ablaufdatum.