Externos

/v1/certificates/external

Utiliza este perímetro para subir, recuperar, eliminar y restablecer los certificados de la entidad de certificación (CA).

Antes de empezar

Debes usar una cuenta de tipo admin para subir y eliminar todos los certificados.

Recuperación

Realiza llamadas GET a este extremo para recuperar un certificado de CA almacenado en el cliente de la API de WhatsApp Business.

Ejemplo

Solicitud:

GET /v1/certificates/external/ca

Respuesta:

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

certificate

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

Subida

Realiza llamadas POST para subir un certificado de CA. Asegúrate de que el certificado subido contenga las secciones siguientes en un archivo y en el mismo orden que se muestra a continuación:

1. Clave privada
2. Certificado
3. Uno o varios certificados de CA intermedios: el cliente de la API de WhatsApp Business necesita como mínimo un certificado de CA intermedio; de lo contrario, se producirá un error de subida.

Ejemplo

Para subir el certificado al cliente de la API de WhatsApp Business, utiliza la siguiente solicitud a la API, en la que el valor de Content-Type es text/plain.

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

certificate

Si se usa cURL, el comando tiene el aspecto siguiente:

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

Si ya existe un certificado, se sobrescribe. Después de subir el certificado, debes reiniciar el servidor web, es decir, todas las instancias de contenedor de la aplicación web.

Debes tener especial cuidado para actualizar el certificado solo con uno válido (es decir, adecuado y correcto). De lo contrario, el servidor web no se reinicia (porque el extremo de la API está inactivo) y se requiere una intervención manual para resolver la situación.

La respuesta a la llamada a la API tiene el aspecto siguiente:

null

Restablecimiento

Al subir un certificado de CA al cliente de la API de WhatsApp Business, si el certificado no es válido por algún motivo, no se iniciarán los contenedores de la aplicación web tras el reinicio porque el extremo de la API estará inactivo. Para resolver esta situación, debes eliminar la tabla de base de datos certs.

Para eliminar la tabla de base de datos certs, haz lo siguiente:

1. Detén el contenedor de la aplicación web:
   

   docker stop your-webapp-container-id

2. Conéctate a MySQL mediante Docker en la línea de comandos:

   docker exec -it your-mysql-container-id mysql -uroot -p

3. Escribe la contraseña de MySQL cuando el sistema la solicite (de acuerdo con mysql.conf).
4. Comprueba si la tabla certs existe:

   show tables in waweb;

5. Elimina la tabla certs:

   drop table waweb.certs;

6. Sal de MySQL:

   exit;

7. Reinicia el contenedor de la aplicación web:

   docker restart your-webapp-container-id

8. Vuelve a iniciar sesión en MySQL siguiendo los pasos anteriores para comprobar que la tabla certs ahora exista.

Eliminación

No se admite la eliminación de certificados. Es posible que esta acción se admita en el futuro si hay algún caso de uso que hayamos omitido.