외부

/v1/certificates/external

이 에지를 사용하여 인증서 기관(CA) 인증서를 업로드, 검색, 삭제 및 재설정합니다.

시작하기 전에

모든 인증서를 업로드하고 삭제하는 데 반드시 admin 계정을 사용해야 합니다.

검색

이 엔드포인트로 GET 호출을 보내서 WhatsApp Business API 클라이언트에 저장된 CA 인증서를 검색합니다.

예

요청:

GET /v1/certificates/external/ca

응답:

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

certificate

CA 인증서를 찾을 수 없는 경우 본문 없는 404 응답 코드가 반환됩니다.

업로드

POST 호출을 보내서 CA 인증서를 업로드합니다. 업로드된 인증서에 다음 섹션이 단일 파일로 여기에 표시된 순서와 동일하게 포함되어 있는지 확인합니다.

1. 개인 키
2. 인증서
3. 하나 이상의 ICA 인증서 — WhatsApp Business API 클라이언트에는 하나 이상의 ICA가 필요하며, 그렇지 않은 경우 업로드에 실패합니다.

예

WhatsApp Business API 클라이언트에 인증서를 업로드하려면 다음 API 요청을 사용하세요. 여기에는 text/plain의 Content-Type이 포함됩니다.

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

certificate

cURL을 사용할 때는 다음과 같은 명령을 사용합니다.

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 

기존에 존재하는 인증서는 덮어씁니다. 인증서가 업로드 된 후에는 웹 서버(즉, 모든 Webapp 컨테이너 인스턴스)를 재시작해야 합니다.

유효한(적절하고 올바른) 인증이 있는 인증서만 업데이트하도록 극히 주의해야 합니다. 그렇지 않으면 (API 엔드포인트가 다운되므로) 웹 서버가 재시작되지 않으며, 이 상황을 해결하기 위해 직접 개입해야 할 수 있습니다.

API 호출에 대한 응답은 다음과 같습니다.

null

재설정

CA 인증서를 WhatsApp Business API 클라이언트에 업로드할 때 어떤 이유로든 인증서가 유효하지 않을 경우, API 엔드포인트가 사용 중단되므로 Webapp 컨테이너도 다시 시작하지 못합니다. 이 상황을 복구하려면 certs 데이터베이스 테이블을 가져옵니다.

certs 데이터베이스 테이블을 가져오는 방법:

1. Webapp 컨테이너를 정지합니다.
   

   docker stop your-webapp-container-id

2. 명령줄에서 Docker를 통해 MySQL에 연결:

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

3. 프롬프트가 나오면 MySQL 비밀번호를 입력합니다(mysql.conf 참조).
4. certs 테이블이 있는지 확인:

   show tables in waweb;

5. certs 테이블 가져오기:

   drop table waweb.certs;

6. MySQL 종료:

   exit;

7. Webapp 컨테이너를 다시 시작합니다.

   docker restart your-webapp-container-id

8. 위의 절차에 따라 다시 한번 MySQL에 로그인해서 certs 테이블이 있는지 확인합니다.

삭제

인증서 삭제는 지원되지 않습니다. Facebook에서 간과한 사용 사례가 있다면 나중에 지원할 수 있습니다.