การตั้งค่า Console Options และ OpenAPI – บริษัท ซังฟอร์ เทคโนโลยี (ประเทศไทย) จำกัด

บทนำ

Console Options และ OpenAPI เป็นฟีเจอร์ด้าน System Administration บน Sangfor aDesk (VDI) VDC v5.9.6 ที่ช่วยให้ผู้ดูแลระบบสามารถปรับแต่งการแสดงผลของ Console (ความละเอียดหน้าจอ, Protocol Settings) และเปิดใช้งาน OpenAPI สำหรับการเชื่อมต่อกับระบบภายนอกหรือพัฒนา Automation Script ฟีเจอร์ OpenAPI ช่วยให้สามารถจัดการ VDC ผ่าน RESTful API ได้ เหมาะสำหรับการ Integrate กับระบบ IT Service Management หรือ Orchestration Platform ขององค์กร

ข้อกำหนดเบื้องต้น

VDC v5.9.6 ติดตั้งและใช้งานได้ปกติ
สิทธิ์ Administrator ในการเข้าถึง VDC Console
สำหรับ OpenAPI: ความรู้พื้นฐานเกี่ยวกับ RESTful API และ HTTP Methods
เครื่องมือสำหรับทดสอบ API เช่น Postman, curl หรือ Python requests

ขั้นตอนการตั้งค่า

ส่วนที่ 1: Console Options

1. เข้าสู่หน้าตั้งค่า Console

ไปที่ System > Console Options บน VDC Console เพื่อเข้าสู่หน้าตั้งค่าการแสดงผล

2. ตั้งค่า Display Resolution

ในส่วน Display Settings กำหนดค่าความละเอียดหน้าจอ:

Default Resolution — กำหนดความละเอียดเริ่มต้นสำหรับ Console เช่น 1920x1080, 2560x1440
Auto Adjust — เปิดใช้งานเพื่อให้ Console ปรับความละเอียดตามหน้าจอของ Client อัตโนมัติ
Multi-Monitor Support — เปิดรองรับการใช้งานหลายหน้าจอ กำหนดจำนวน Monitor สูงสุดได้

3. ตั้งค่า Protocol Settings

ในส่วน Protocol กำหนดการตั้งค่า Display Protocol:

Protocol Type — เลือก SRAP (Sangfor Remote Access Protocol) หรือ Protocol อื่นที่รองรับ
Video Quality — ปรับคุณภาพวิดีโอ: Low, Medium, High หรือ Auto
Frame Rate — กำหนด Frame Rate สูงสุด เช่น 30 FPS หรือ 60 FPS
Compression — เลือกระดับการบีบอัด: Higher Compression (ใช้ Bandwidth น้อย) หรือ Lower Compression (ภาพคมชัดกว่า)

ส่วนที่ 2: OpenAPI

4. เปิดใช้งาน OpenAPI

ไปที่ System > OpenAPI แล้วคลิก Enable OpenAPI ระบบจะเปิดให้เข้าถึง API Endpoint ผ่าน HTTPS

5. สร้าง API Credentials

คลิก Generate API Key เพื่อสร้าง Credentials สำหรับการเชื่อมต่อ:

API Key — Token สำหรับ Authentication
API Secret — Secret Key สำหรับ Signing Request
Allowed IPs — กำหนด IP Address ที่อนุญาตให้เข้าถึง API (แนะนำให้จำกัดเฉพาะ IP ที่จำเป็น)

6. ทดสอบ API Endpoint

API Endpoint หลักที่ใช้งานบ่อย:

GET /api/v1/desktops — ดูรายการ Virtual Desktop ทั้งหมด
POST /api/v1/desktops/{id}/power — เปิด/ปิด/Restart Desktop
GET /api/v1/users — ดูรายการผู้ใช้ในระบบ
POST /api/v1/users/{id}/assign — กำหนด Desktop ให้ผู้ใช้
GET /api/v1/monitor/resources — ดูสถานะทรัพยากรของระบบ

ตัวอย่างการเรียก API ด้วย curl:

curl -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" https://VDC_IP/api/v1/desktops

การตรวจสอบ

สำหรับ Console Options: เข้าสู่ Virtual Desktop ผ่าน aDesk Client แล้วตรวจสอบว่าความละเอียดและคุณภาพภาพตรงกับที่ตั้งค่าไว้
สำหรับ OpenAPI: ทดสอบเรียก API Endpoint ด้วย Postman หรือ curl แล้วตรวจสอบว่าได้รับ Response ที่ถูกต้อง (HTTP 200)
ตรวจสอบ Log > API Access Log เพื่อดูประวัติการเรียกใช้ API

หมายเหตุ

การเปลี่ยน Console Options บางรายการจะมีผลหลังจากผู้ใช้ Reconnect เข้า Desktop ใหม่
OpenAPI มี Rate Limit สำหรับป้องกันการเรียกใช้มากเกินไป ตรวจสอบ Limit ได้จาก Response Header X-RateLimit-Remaining
ควรเก็บ API Key และ Secret ไว้อย่างปลอดภัย หากสงสัยว่าถูก Compromise ให้ Regenerate ทันที
สามารถดูเอกสาร API Reference ฉบับเต็มได้ที่ System > OpenAPI > API Documentation บน VDC Console
สำหรับการ Integrate กับระบบ Third-Party แนะนำให้ใช้ Service Account แยกต่างหากจากบัญชีผู้ดูแลระบบหลัก