Esterno

/v1/certificates/external

Utilizza questo segmento per caricare, recuperare, eliminare e reimpostare i certificati delle autorità di certificazione (CA).

Prima di iniziare

Devi usare un account admin per caricare ed eliminare tutti i certificati.

Recupero

Effettua chiamate GET a questo endpoint per recuperare un certificato CA memorizzato nel client dell'API di WhatsApp Business.

Esempio

Richiesta:

GET /v1/certificates/external/ca

Risposta:

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

certificate

Se un certificato CA non viene trovato, viene restituito un codice di risposta 404 senza corpo.

Caricamento

Effettua chiamate POST per caricare un certificato CA. Assicurati che il certificato caricato contenga le seguenti sezioni in un file e nello stesso ordine mostrato qui:

1. Chiave privata
2. Certificato
3. Uno o più certificati CA intermedi: il client dell'API di WhatsApp Business necessita almeno di un certificato CA intermedio, altrimenti il caricamento non andrà a buon fine.

Esempio

Per caricare il certificato sul client dell'API di WhatsApp Business, utilizza la seguente richiesta API, che contiene il Content-Type di text/plain.

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

certificate

Se usi cURL, il comando sarà simile al seguente:

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 

Se un certificato esiste già, verrà sovrascritto. È necessario riavviare il server web, ovvero tutte le istanze del contenitore Webapp, una volta caricato il certificato.

Devi essere estremamente cauto nell'aggiornare il certificato solo con un certificato valido (ovvero, giusto e corretto). In caso contrario, il server web non si riavvierà (poiché l'endpoint dell'API è inattivo) e il ripristino dovrà essere effettuato mediante un intervento manuale.

La risposta alla tua chiamata API sarà simile alla seguente:

null

Reimpostazione

Quando carichi un certificato CA sul client dell'API di WhatsApp Business, se il certificato non è valido per qualche motivo, i contenitori Webapp non verranno avviati al riavvio poiché l'endpoint API sarà inattivo. Per ripristinare questa situazione, dovrai eliminare la tabella di database certs.

Per eliminare la tabella del database certs:

1. Interrompi il contenitore Webapp:
   

   docker stop your-webapp-container-id

2. Connettiti a MySQL tramite Docker nella riga di comando:

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

3. Inserisci la password MySQL quando richiesto (come da mysql.conf).
4. Controlla se esiste la tabella certs:

   show tables in waweb;

5. Elimina la tabella certs:

   drop table waweb.certs;

6. Esci da MySQL:

   exit;

7. Riavvia il contenitore Webapp:

   docker restart your-webapp-container-id

8. Accedi nuovamente a MySQL usando i passaggi precedenti per assicurarti che ora la tabella certs esista.

Eliminazione

L'eliminazione dei certificati non è supportata. Potremmo supportare questa funzionalità in futuro, se dovessimo individuare un caso d'uso non ancora considerato.