Zertifikate der Zertifizierungsstelle für Webhooks

Verwende diesen Endpunkt, um deine Zertifikate zu verwalten, wenn die in den Anwendungseinstellungen konfigurierte Webhook-URL ein internes CA(Certificate Authority)-Zertifikat verwendet.

Abrufen

Verwende diesen Endpunkt, um dein Webhook-CA-Zertifikat abzurufen.

Beispiel

Anfrage:

GET /v1/certificates/webhooks/ca

Antwort:

Content-Type: text/plain
Content-Length: content-size

certificate

Wenn kein Zertifikat vorhanden ist, wird ein 404-Antwortcode ohne Text zurückgegeben.

Hochladen

Wenn die in den Anwendungseinstellungen konfigurierte Webhook-URL ein internes CA-Zertifikat verwendet, musst du das Zertifikat auf den WhatsApp Business API-Client hochladen, damit es von der WhatsApp Business API unterstützt werden kann. Wenn du mit einem extern bekannten CA-Zertifikat arbeitest, kannst du diesen Abschnitt überspringen.

Mit dem folgenden Befehl kannst du ein selbstsigniertes Zertifikat im PEM-Format erstellen:

openssl req -newkey rsa:2048 -nodes -keyout key.pem -x509 -days 365 -out certificate.pem

Die Zertifikatdatei muss im PEM-Format vorliegen. Wenn du mehrere Zertifikate hochladen möchtest, solltest du sie zunächst zu einer einzigen Datei zusammenfügen:

cat cert1.pem cert2.pem > bundle.pem

Beispiel

Anfrage:

POST /v1/certificates/webhooks/ca
Content-Type: text/plain
Content-Length: content-size

certificate

Mit dem folgenden Befehl kannst du das Zertifikat über cURL hochladen:

curl -X POST \
  https://your-webapp-hostname:your-webapp-port/v1/certificates/webhooks/ca \
  -H 'Authorization: Bearer your-auth-token' \
  -H 'Cache-Control: no-cache' \
  -H 'Content-Type: text/plain' \
  --data-binary @your-path-to-certificate.pem \
  -k

Wenn bereits ein Zertifikat vorhanden ist, wird es überschrieben. Nach dem Zertifikatupload müssen alle Coreapp-Nodes neu gestartet werden, um die Änderungen zu übernehmen.

Die Antwort sieht folgendermaßen aus:

null or {}

Löschen

Starte eine DELETE-Anfrage an diesen Endpunkt, um dein CA-Zertifikat zu löschen.

Beispiel

Anfrage:

DELETE /v1/certificates/webhooks/ca

Antwort:

null or {}