ภายนอก

/v1/certificates/external

ใช้จุดเชื่อมโยงนี้เพื่ออัพโหลด เรียกดู ลบ และรีเซ็ตใบรับรอง Certificate Authority (CA)

ก่อนเริ่มต้น

คุณต้องใช้บัญชี admin เพื่ออัพโหลดและลบใบรับรองทั้งหมด

การเรียกดู

เรียก GET ไปยังตำแหน่งข้อมูลนี้เพื่อเรียกดูใบรับรอง CA ที่จัดเก็บในไคลเอ็นต์ WhatsApp Business API

ตัวอย่าง

คำขอ:

GET /v1/certificates/external/ca

การตอบกลับ:

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

certificate

หากไม่พบใบรับรอง CA ระบบจะส่งคืนรหัสการตอบกลับ 404 โดยไม่มีเนื้อความ

การอัพโหลด

เรียก POST เพื่ออัพโหลดใบรับรอง CA ตรวจสอบให้แน่ใจว่าใบรับรองที่อัพโหลดมีส่วนต่อไปนี้รวมอยู่ในไฟล์เดียวและในลำดับเดียวกันกับที่แสดงที่นี่:

1. คีย์ส่วนตัว
2. ใบรับรอง
3. ใบรับรอง CA ระดับกลาง 1 ใบขึ้นไป - ไคลเอ็นต์ WhatsApp Business API ต้องมีใบรับรองระดับกลางอย่างน้อย 1 ใบ ไม่เช่นนั้นการอัพโหลดจะไม่สำเร็จ

ตัวอย่าง

หากต้องการอัพโหลดใบรับรองไปยังไคลเอ็นต์ WhatsApp Business API ให้ใช้คำขอ API ต่อไปนี้ ซึ่งมี Content-Type เป็น text/plain

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 

หากมีใบรับรองอยู่แล้ว ระบบจะเขียนทับใบรับรองที่มีอยู่ เมื่ออัพโหลดใบรับรองแล้ว คุณต้องรีสตาร์ทเว็บเซิร์ฟเวอร์ ซึ่งจะเป็นการรีสตาร์ทอินสแตนซ์คอนเทนเนอร์เว็บแอพทั้งหมดไปด้วย

คุณควรระมัดระวังเป็นพิเศษในการอัพเดตใบรับรอง โดยให้อัพเดตด้วยใบรับรองที่ใช้ได้เท่านั้น (กล่าวคือ ใบรับรองที่เหมาะสมและถูกต้อง) ไม่เช่นนั้น เว็บเซิร์ฟเวอร์จะรีสตาร์ทไม่สำเร็จ (เนื่องจากตำแหน่งข้อมูล API ขัดข้อง) และจำเป็นจะต้องให้ผู้ปฏิบัติการเข้าแก้ไขสถานการณ์ด้วยตนเอง

การตอบสนองต่อการเรียก API ของคุณจะมีลักษณะดังนี้

null

การรีเซ็ต

เมื่ออัพโหลดใบรับรอง CA ไปยังไคลเอ็นต์ WhatsApp Business API หากใบรับรองไม่สามารถใช้ได้ด้วยเหตุผลบางประการ คอนเทนเนอร์เว็บแอพจะเริ่มต้นการรีบูตไม่สำเร็จเพราะตำแหน่งข้อมูล API จะขัดข้อง หากต้องการแก้ไขสถานการณ์นี้ คุณต้องทิ้งตารางฐานข้อมูล certs

วิธีทิ้งตารางฐานข้อมูล certs มีดังนี้

1. หยุดคอนเทนเนอร์ Webapp:
   

   docker stop your-webapp-container-id

2. เชื่อมต่อ MySQL ผ่าน Docker ในบรรทัดคำสั่ง:

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

3. ป้อนรหัส MySQL ของคุณเมื่อได้รับการแจ้งเตือน (ตาม mysql.conf)
4. ตรวจสอบว่ามีตาราง users หรือไม่

   show tables in waweb;

5. ทิ้งตาราง users:

   drop table waweb.certs;

6. ออกจาก MySQL:

   exit;

7. รีสตาร์ทคอนเทนเนอร์ Webapp:

   docker restart your-webapp-container-id

8. เข้าสู่ระบบ MySQL อีกครั้งโดยใช้ขั้นตอนข้างต้นเพื่อให้แน่ใจว่ามีตาราง certs แล้วในตอนนี้

การลบ

ระบบไม่รองรับการลบใบรับรอง เราอาจรองรับฟีเจอร์นี้ในอนาคตหากมีกรณีใช้งานใดที่เรามองข้ามไป