Cloud Networking Management

Nebula Control Center

ในเดือนกันยายน ปี 2021 พร้อมกับการเปิดตัว P12, Nebula ได้เปิดตัวเวอร์ชันเริ่มต้นของ Nebula OpenAPI ซึ่งทำหน้าที่เป็นอินเตอร์เฟซสำหรับซอฟต์แวร์ในการติดต่อโดยตรงกับแพลตฟอร์มคลาวด์ของ Nebula และอุปกรณ์ที่จัดการโดย Nebula. API เหล่านี้ช่วยให้ผู้ใช้ Nebula สามารถจัดการเครือข่าย Nebula ได้อย่างมีประสิทธิภาพในระดับใหญ่ผ่านแอปพลิเคชันที่พัฒนาขึ้นเอง. หน้านี้เป็นเอกสารภาพรวมและคำถามที่พบบ่อยสำหรับ Zyxel Nebula OpenAPI

ภาพรวมของ Nebula OpenAPI
  • Zyxel Nebula API เป็น API แบบ RESTful และได้รับการป้องกันด้วย HTTPS
  • Zyxel Nebula API ใช้ API Key แทนการใช้ OAUTH2 ในการยืนยันตัวตน.
  • ขอบเขตของ API Key จะเป็นแบบผู้ดูแลระบบ (per-Admin) และจะมีสิทธิ์การเข้าถึงเหมือนกัน.
  • สำหรับการแนะนำเบื้องต้นเกี่ยวกับ Zyxel Nebula OpenAPI สามารถอ่านได้จากที่นี่.
Support API List

คุณสามารถหาวิธีการดาวน์โหลดเวอร์ชันล่าสุดได้ที่นี่ และขณะนี้เวอร์ชันล่าสุดคือ 0.1.30

คำถามที่พบบ่อย
ข้อกำหนดเบื้องต้น:

โปรดตรวจสอบให้แน่ใจว่าอุปกรณ์ Nebula ของคุณได้ลงทะเบียนภายใต้การอนุญาต Nebula Professional Pack เนื่องจากการผสานรวม Nebula OpenAPI มีให้ใช้งานเฉพาะใน Pro Pack เท่านั้น.

การสร้าง API key ใน Nebula Control Center (NCC):

Wเมื่อมีการเปิดตัว Nebula 18.20, Zyxel ได้ปรับปรุงกระบวนการจัดการ API key ให้มีความสะดวก รวดเร็ว และปลอดภัยยิ่งขึ้น ผู้ใช้สามารถสร้างและสร้างใหม่ API key ได้โดยตรงจาก NCC เพื่อสร้าง API key ใหม่ ให้ล็อกอินเข้าสู่ NCC และไปที่ "API Key Management" ภายใต้ "My Devices and Services". จจากนั้นให้ทำตามคำแนะนำเพื่อสร้าง ยอมรับมาตรการความปลอดภัย คัดลอก และบันทึก API key ของคุณ.

กรุณาส่งอีเมลเคสไปยังฝ่ายขายหรือวิศวกรฝ่ายขายของ Zyxel ในพื้นที่ของคุณ เพื่อยืนยันคำขอฟีเจอร์ของคุณในแง่ของผลกระทบทางธุรกิจ ซึ่งจะช่วยทีมการจัดการผลิตภัณฑ์ Nebula ในการกำหนดลำดับความสำคัญของคำขอนั้น

ก่อนที่คุณจะเริ่มต้น โปรดตรวจสอบให้แน่ใจว่าคุณมีข้อกำหนดดังต่อไปนี้:

  1. 1.เครื่องมือ APP เช่น Postman.
  2. API key.
ขั้นตอน:
  1. ไปที่เว็บไซต์ Postman และลงทะเบียนเพื่อสร้างบัญชีผู้ใช้
  2. หลังจากลงชื่อเข้าใช้สำเร็จ ให้ไปที่ส่วน "My workspace" หากคุณไม่มี workspace คุณสามารถสร้างใหม่ได้
  3. ภายใน workspace ให้หาปุ่ม "+" ซึ่งมักจะอยู่ที่มุมซ้ายบนของอินเทอร์เฟซ แล้วคลิกเพื่อดำเนินการต่อ
  4. 4.หาส่วน "Headers" ภายในส่วนนี้คุณจะเห็นสองคอลัมน์ที่มีชื่อว่า "Key" และ "Value" ในฟิลด์ "Key" ให้พิมพ์ "X-ZyxelNebula-API-Key" แล้วในฟิลด์ "Value" ที่ตรงกัน ให้วาง API key ที่คุณได้รับจากการสนับสนุนของ Zyxel
    Tคำเตือน: API key จะเชื่อมโยงกับบัญชีของคุณ ดังนั้นจึงสำคัญมากที่จะต้องเก็บรักษาไว้ให้ปลอดภัยและเป็นความลับ เนื่องจากมันให้สิทธิ์การเข้าถึงองค์กรของคุณ หากคุณมีข้อกังวลเกี่ยวกับความปลอดภัยของ API key กรุณาติดต่อการสนับสนุนของ Zyxel เพื่อขอ API key ใหม่และยกเลิก API key เก่า
  5. 5.ใส่ URL ของ API endpoint: https://api.nebula.zyxel.com/v1/nebula. Aหลังจากเพิ่ม endpoint URL แล้ว ให้ใส่ข้อมูลเฉพาะที่คุณต้องการดึงข้อมูล เช่น หากคุณต้องการข้อมูลรายละเอียดขององค์กร
    1. ชื่อ: ชื่อขององค์กร
    2. OrgId: รหัสประจำองค์กรที่ไม่ซ้ำ
    3. Mode: โหมดใบอนุญาตขององค์กร

    URL ที่แก้ไขแล้วจะมีลักษณะดังนี้: https://api.nebula.zyxel.com/v1/nebula/organizations

    สุดท้าย คลิกที่ปุ่ม "Send" เพื่อดำเนินการส่งคำขอ

    การตอบกลับจะปรากฏผลลัพธ์ในรูปแบบดังนี้:

ใช้เฉพาะในการสร้าง API token สำหรับการผสานกับระบบภายนอกที่ใช้ DPPSK (Dynamic Pre-Shared Key)

หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับโซลูชัน DPPSK ของ Nebula และวิธีการผสานมันเข้ากับระบบการจัดการ WiFi onboarding ของบุคคลที่สาม สามารถเยี่ยมชมเว็บไซต์ของเราได้.