องค์กรที่มีระบบของตัวเอง เช่น Dashboard กลาง ระบบ Ticket หรือแพลตฟอร์มที่ทีมนักพัฒนาของพาร์ทเนอร์ดูแล สามารถเรียกใช้ Sangfor Athena XDR (SaaS) ผ่าน REST API ได้ ทุกระบบที่เชื่อมเข้ามาใช้ API Key ที่ผู้ดูแลสร้างและควบคุมเองในหน้า API Keys บทความนี้อธิบายว่า API ใช้ทำอะไรได้ วิธีสร้างและลบ Key และแนวทางดูแล Key อย่างปลอดภัย เหมาะสำหรับผู้ดูแลระบบและทีมนักพัฒนาที่จะเชื่อมระบบกับ XDR
สารบัญ
REST API ของ Athena XDR ใช้ทำอะไร
ข้อมูลจากอุปกรณ์เข้าสู่ XDR ทาง Native Device, XDR Broker และ Syslog ส่วนการสั่งอุปกรณ์ให้ตอบสนองใช้แอปใน SOAR สำหรับระบบอื่นขององค์กรที่ต้องการดึงข้อมูลจาก XDR หรืออัปเดตสถานะกลับมา ให้ใช้ REST API ซึ่งครอบคลุมงานหลักดังนี้
| ข้อมูล | อ่านข้อมูล | แก้ไขข้อมูล |
|---|---|---|
| Security Incidents / Security Alerts | รายการ Incident และ Alert, Entity ที่เกี่ยวข้อง, หลักฐาน (Forensics) | ปรับสถานะการจัดการ (Fixing Status) |
| Assets | รายการ Asset, กลุ่ม, ผู้รับผิดชอบ, Asset ที่รออนุมัติ | อนุมัติหรือข้าม Asset ใหม่ |
| Weaknesses | ข้อมูลช่องโหว่และ Baseline | ปรับสถานะการแก้ไข |
| Whitelist | รายการ Whitelist | เพิ่ม แก้ไข เปิด/ปิด และลบ |
| Responses, SOAR, Ticket, Monitors | กฎการแยกเครื่อง, ประวัติการรัน Playbook, รายการ Ticket, ข้อมูลกราฟและคะแนน | ยกเลิกการแยกเครื่อง |
ขอบเขตและวิธีเรียกของแต่ละ API ให้ยึดเอกสาร API เป็นหลัก และปรึกษาทีม Sangfor หรือพาร์ทเนอร์ก่อนเริ่มพัฒนา
หน้า API Keys
ไปที่ Configuration › Integration › API Keys ข้อความด้านบนแนะนำให้ทบทวน Key ที่เข้าถึงข้อมูลอ่อนไหว และไม่ให้สิทธิ์เกินจำเป็น ตารางแสดงคอลัมน์ต่อไปนี้
| คอลัมน์ | ความหมาย |
|---|---|
| Name | ชื่อ Key ตั้งตามระบบที่ใช้ เช่น SOC_Dashboard
|
| API Key | ค่า Key (แสดงแบบย่อ) |
| References | แอปและ REST API ที่ใช้ Key นี้อยู่ |
| Time Created / Created By | ใครสร้าง Key และเมื่อไร |
| Remarks | บันทึกเพิ่มเติม แนะนำให้จดเจ้าของระบบและวันที่ควรทบทวน |
ผู้ที่เข้าหน้านี้ได้กำหนดผ่าน Role (สิทธิ์ของหน้า Configuration › Integration) ให้เหลือเฉพาะคนที่ดูแลการเชื่อมระบบ ดู จัดการผู้ใช้ Role และ TOTP บน Athena XDR
สร้าง แก้ไข และลบ Key
-
กด Add กรอก Name และ Remarks แล้วยืนยัน ระบบจะสร้างค่า Key ให้ทันทีและแสดงในตาราง
แก้ชื่อหรือบันทึกได้ด้วย Edit ในคอลัมน์ Operation (ช่องที่แก้ไขได้คือ Name และ Remarks)
ก่อนลบ Key ใด ให้ตรวจคอลัมน์ References ทุกครั้ง เมื่อกด Delete ระบบจะเตือนว่าแอปและ RESTful API ที่อ้างถึง Key นี้จะใช้งานไม่ได้ทันที
ข้อควรระวัง: API Key เปรียบเหมือนบัตรผ่าน ใครถือไว้ก็เรียก API ในนามของระบบนั้นได้ เก็บ Key ไว้ในที่เก็บรหัสผ่านขององค์กร แยกจากโค้ดและไฟล์ที่แชร์กัน และห้ามส่ง Key ทางช่องทางที่ไม่ปลอดภัย การลบ Key มีผลกับทุกระบบที่ใช้ Key นั้นทันที
ส่งมอบให้ทีมนักพัฒนา
- เอกสาร: เอกสารสำหรับนักพัฒนามี 2 ชุด คือ Data Access API และ OpenAPI ซึ่งบอกว่าแต่ละ API ทำอะไรและเรียกอย่างไร ดาวน์โหลดได้จากเว็บไซต์เอกสารของ Athena XDR หรือขอรับจากทีม Sangfor
- โดเมน: โดเมนของ API คือโดเมน XDR SaaS ของ Tenant เอง (โดเมนเดียวกับที่ใช้เปิด Console ตาม Data Center ของ Tenant) ตามด้วย Path ในเอกสาร
- การลงลายเซ็น: ทุกคำขอต้องลงลายเซ็นด้วย Key คำขอที่ลงลายเซ็นแล้วนำไปแก้ไขหรือส่งซ้ำไม่ได้ ทีมพัฒนาจึงควรใช้ SDK ภาษา Go, Java หรือ Python ที่ Sangfor ให้มาพร้อมตัวอย่างการเรียก
- ส่งเอกสาร Key และโดเมนให้นักพัฒนาผ่านช่องทางที่ปลอดภัยเพียงครั้งเดียว
แนวทางดูแล Key
ระบบละหนึ่ง Key ตั้งชื่อตามระบบนั้น หากระบบใดมีปัญหา ลบ Key ของระบบนั้นได้ทันทีโดยระบบอื่นทำงานต่อตามปกติ
ใช้ข้อมูลเท่าที่จำเป็น ระบบที่ดึงข้อมูลไปแสดงอย่างเดียว ให้เรียกเฉพาะ API ที่อ่านข้อมูล ส่วนระบบที่ต้องอัปเดตสถานะกลับมาจึงใช้ API ที่แก้ไขข้อมูล และจดไว้ว่าแต่ละระบบเรียก API ใดบ้าง เพื่อตรวจย้อนได้เมื่อมีเหตุ
ทบทวนเป็นรอบ เช่น ทุกไตรมาส เปิดหน้า API Keys ทบทวนทีละแถว เริ่มจาก References, Created By และ Remarks
ลบ Key ที่เลิกใช้ เมื่อระบบเลิกใช้หรือเปลี่ยนเจ้าของ ให้ลบ Key นั้นทันที Key ที่ไม่มีเจ้าของเปรียบเหมือนประตูที่เปิดทิ้งไว้
การทบทวน API Key เป็นหนึ่งในงานประจำสัปดาห์ ดู งานประจำวันและประจำสัปดาห์บน Athena XDR
ข้อคิดเห็น
0 ข้อคิดเห็น
โปรด ลงชื่อเข้าใช้ เพื่อแสดงข้อคิดเห็น