Certificados de la entidad de certificación de webhooks

Utiliza este extremo para administrar los certificados si la URL del webhook, tal como está definida en la configuración de la aplicación, utiliza un certificado de una entidad de certificación (CA) interna.

Recuperación

Utiliza este extremo para recuperar el certificado de la CA del webhook.

Ejemplo

Solicitud:

GET /v1/certificates/webhooks/ca

Respuesta:

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

certificate

Si no se encuentra ningún certificado, se devuelve el código de respuesta 404 sin cuerpo.

Subida

Si la URL del webhook, tal como está definida en la configuración de la aplicación, utiliza un certificado de una CA interna, debes subirlo al cliente de la API de WhatsApp Business para que dicha API lo admita. Si utilizas un certificado de una CA conocida externamente, puedes omitir esta sección sin que ello suponga un problema.

Para generar un certificado autofirmado en formato PEM, ejecuta lo siguiente:

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

El archivo del certificado debe estar en formato PEM. Si tienes que subir más de un certificado, primero debes concatenarlos para combinarlos en un solo archivo:

cat cert1.pem cert2.pem > bundle.pem

Ejemplo

Solicitud:

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

certificate

Si tienes que enviar el certificado mediante cURL, debe tener el aspecto siguiente:

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 ya existe un certificado, se sobrescribe. Todos los nodos de la aplicación principal deben reiniciarse después de subir el certificado para que se apliquen los cambios.

La respuesta tiene el aspecto siguiente:

null or {}

Eliminación

Realiza una solicitud DELETE a este extremo para eliminar el certificado de la CA.

Ejemplo

Solicitud:

DELETE /v1/certificates/webhooks/ca

Respuesta:

null or {}