Certificats d’autorité de certification pour les Webhooks

Utilisez ce point de terminaison pour gérer vos certificats si l’URL de Webhook configurée dans les paramètres de l’application utilise un certificat d’autorité de certification (AC) interne.

Récupération

Utilisez ce point de terminaison pour récupérer votre certificat d’AC pour le Webhook.

Exemple

Requête :

GET /v1/certificates/webhooks/ca

Réponse :

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

certificate

Si aucun certificat n’est trouvé, un code de réponse 404 est renvoyé sans corps de message.

Importation

Si l’URL de Webhook configurée dans les paramètres de l’application utilise un certificat d’AC interne, vous devez l’importer dans le client de l’API WhatsApp Business afin qu’il puisse être pris en charge par cette API. Si vous utilisez un certificat d’AC connu de l’extérieur, vous pouvez ignorer cette section sans problème.

Vous pouvez générer un certificat auto-signé au format PEM en exécutant :

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

Le fichier de certificat doit être enregistré au format PEM. Si vous devez importer plusieurs certificats, il est nécessaire de les combiner préalablement dans un même fichier en les concaténant :

cat cert1.pem cert2.pem > bundle.pem

Exemple

Requête :

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

certificate

Si vous devez envoyer le certificat sur cURL, l’adresse doit ressembler à ceci :

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

Si un certificat existe déjà, il est écrasé. Tous les nœuds Coreapp doivent être redémarrés après l’importation du certificat afin que les modifications prennent effet.

La réponse se présente comme suit :

null or {}

Suppression

Envoyez une requête DELETE à ce point de terminaison pour supprimer votre certificat d’AC.

Exemple

Requête :

DELETE /v1/certificates/webhooks/ca

Réponse :

null or {}