Admin API สำหรับองค์กร Enterprise

Admin API ของ Notion ช่วยให้องค์กรของคุณจัดการงานผู้ดูแลด้วยโค้ด ซึ่งรวมถึงงานทั่วไป เช่น การเริ่มส่งออกพื้นที่ทำงาน, การสร้างและยกเลิกการบล็อค, และการออกจากระบบผู้ใช้ที่มีการจัดการใน Notion

คุณสามารถตั้งค่านี้ได้ในการตั้งค่าองค์กร โดยสร้างบอทผู้ดูแลสำหรับองค์กร จากนั้นกำหนดโทเค็นที่มีเฉพาะสิทธิ์ที่จำเป็นให้บอทนั้น

• องค์กรของคุณจำเป็นต้องใช้แพ็คเกจ Enterprise

• คุณต้องเป็นเจ้าขององค์กร

• สิ่งนี้สร้างขึ้นสำหรับทีมผู้ดูแลระบบ ทีมไอที ทีมรักษาความปลอดภัย และทีมปฏิบัติตามกฎระเบียบ สมาชิกและผู้ใช้ชั่วคราวจะไม่สังเกตเห็นการเปลี่ยนแปลงใดๆ ในการทำงานประจำวันของพวกเขา

1. เปิดตัวสลับพื้นที่ทำงานของคุณแล้วเลือก จัดการองค์กร

2. ไปที่ ทั่วไป จากนั้นเปิด จัดการโทเค็น Admin API ระดับองค์กร

3. เลือก สร้างการเชื่อมต่อ

4. ตั้งชื่อการเชื่อมต่อที่ทีมของคุณจะจดจำได้ เช่น “ระบบอัตโนมัติเพื่อการปฏิบัติตามกฎระเบียบ” และเลือกเฉพาะสิทธิ์ที่จำเป็นเท่านั้น หากการเชื่อมต่อใช้สำหรับการส่งออกเพียงอย่างเดียว อย่าให้สิทธิ์ในการบล็อคแก่การเชื่อมต่อนั้น

5. เลือก สร้างโทเค็น จากนั้นคัดลอกโทเค็นและบันทึกไว้ในตัวจัดการความลับ (secrets manager) ที่ทีมของคุณใช้งานอยู่แล้ว

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

• เลือกชุดสิทธิ์การเข้าถึงที่น้อยที่สุดที่ยังคงสามารถทำงานได้ตามต้องการ

• หมุนเวียนโทเค็นตามกำหนดเวลาที่ทีมรักษาความปลอดภัยของคุณกำหนด

• ลบโทเค็นทันทีหากมีการแชร์โดยไม่ได้ตั้งใจหรือบุคคลที่เป็นเจ้าของโทเค็นมีการเปลี่ยนบทบาท สคริปต์ใดๆ ที่ใช้โทเค็นนั้นจะหยุดทำงานทันที

• คุณไม่สามารถจำกัดโทเค็นผู้ดูแลระบบให้ใช้เฉพาะที่อยู่ IP หรือเครือข่ายที่ระบุได้ ให้ใช้การควบคุมที่คุณมีอยู่แล้ว เช่น การจัดเก็บโทเค็นไว้ในตัวจัดการความลับและการเรียกใช้งานจากระบบที่คุณเชื่อถือ

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

• การเรียกนี้ถูกปฏิเสธ ตรวจสอบว่าองค์กรของคุณอยู่ในแพ็คเกจ Enterprise

• คุณได้รับข้อผิดพลาดเกี่ยวกับสิทธิ์ ตรวจสอบว่าโทเค็นมีสิทธิ์เข้าถึงการดำเนินการที่คุณเรียกใช้ โดยโทเค็นที่จำกัดไว้สำหรับการส่งออกไม่สามารถสร้างการบล็อคได้

• การเรียกออกจากระบบไม่ทำงาน ตรวจสอบว่าบัญชีนั้นเป็น ผู้ใช้ที่มีการจัดการ บัญชีที่อยู่นอกโดเมนที่ยืนยันแล้วของคุณจะไม่ได้รับความคุ้มครอง

สำหรับรูปแบบคำขอ พารามิเตอร์ และตัวอย่างโค้ด โปรดดู ข้อมูลอ้างอิงผู้ดูแล API ในเอกสารสำหรับนักพัฒนา