OAuth client ของเวิร์กสเปซ
Settings → Developers → MCP OAuth Clients สร้างและจัดการ OAuth client ของเวิร์กสเปซ สำหรับ MCP gateway สาธารณะของ Entergram
ต้องมีสิทธิ์แอดมินของเวิร์กสเปซ เฉพาะเจ้าของและแอดมินของเวิร์กสเปซเท่านั้นที่จัดการ MCP OAuth client ที่ใช้ร่วมกันได้
เวิร์กสเปซเทียบกับส่วนตัว
ส่วนหัวข้อ “เวิร์กสเปซเทียบกับส่วนตัว”client ของเวิร์กสเปซรองรับทั้ง client แบบ public PKCE และ client แบบ confidential ที่ใช้
client_secret_postหรือclient_secret_basicเก็บการเชื่อมต่อที่ใช้ร่วมกันไว้ที่นี่ และใช้ ส่วน client ส่วนตัวสำหรับเอเจนต์ของคุณเองที่จำกัดขอบเขตตามที่นั่ง
สมาชิกไม่เห็น client ของเวิร์กสเปซโดยตรง เพราะ client เหล่านี้มีไว้สำหรับระบบอัตโนมัติของทั้งทีม
การสร้าง client
ส่วนหัวข้อ “การสร้าง client”Create client ลงทะเบียน OAuth client ของเวิร์กสเปซที่ขออนุญาตกับ Entergram MCP gateway ได้
| ฟิลด์ | หมายเหตุ |
|---|---|
| Client name | เช่น Entergram Workspace Agent |
| Platform | เลือกหนึ่งรายการ หรือ Custom |
| Token endpoint auth | Public (none) หรือ Confidential (client_secret_post / client_secret_basic) |
| Require PKCE | บังคับสำหรับ client แบบ public แนะนำให้ใช้กับแบบ confidential เพื่อเพิ่มการป้องกัน |
| Description | คำอธิบายสั้นๆ ที่แสดงบนหน้ายินยอม |
| Redirect URIs | หนึ่งรายการต่อบรรทัด ต้องใช้ HTTPS ถ้าไม่ใช่ localhost |
| Allowed scopes | scope เหล่านี้จำกัดสิ่งที่ client ของเวิร์กสเปซขอได้ระหว่างการอนุญาต |
ใช้
noneสำหรับ client แบบ PKCE ในเครื่อง ใช้client_secret_*สำหรับการเชื่อมต่อแบบโฮสต์ หรือฝั่งเซิร์ฟเวอร์
client ของเวิร์กสเปซขอ scope ได้ครบทุกรายการ ดูตาราง scope ใน MCP connectors
client secret
ส่วนหัวข้อ “client secret”client แบบ confidential จะได้รับ secret ที่ แสดงเพียงครั้งเดียว:
แสดงครั้งเดียว Entergram เก็บเพียงค่าแฮชของ secret นี้ หลังจากปิดหน้าต่างนี้ คุณจะทำได้เพียงหมุนเวียน secret ใหม่ แต่จะดู secret เดิมอีกไม่ได้
client แบบ public ไม่มี secret และต้องยืนยันตัวตนด้วย PKCE
การจัดการ client
ส่วนหัวข้อ “การจัดการ client”รายการแสดง Active clients และ Total clients และสำหรับแต่ละ client:
- Public client / Confidential client, PKCE on / PKCE off
- Created, Created by, Last used, Last used by
- Active grants
- Client details ที่ขยายดูได้ ได้แก่ Client ID วิธียืนยันตัวตน ตัวอย่าง secret ข้อกำหนด PKCE และ Ban reason ในกรณีที่มี
| การดำเนินการ | ผล |
|---|---|
| Edit | เปลี่ยนชื่อ scope และ redirect URI |
| Disable | หยุดการอนุญาตใหม่และการรีเฟรชโทเค็นจนกว่าจะเปิดใช้อีกครั้ง |
| Enable | อนุญาตให้ขออนุญาตและรีเฟรชได้อีกครั้ง |
| Rotate secret | ออก secret ใหม่ซึ่งแสดงเพียงครั้งเดียว secret เดิมจะใช้ไม่ได้อีก |
| Archive | ”Archiving disables the client and revokes active grants and refresh tokens for this workspace client.” (การเก็บถาวรจะปิดใช้ client และเพิกถอนสิทธิ์ที่ใช้งานอยู่และ refresh token ของ client นี้) |
สถานะว่าง: “Create the first shared MCP OAuth client for this workspace.” (สร้าง MCP OAuth client ที่ใช้ร่วมกันรายการแรกของเวิร์กสเปซนี้)
เลือกระหว่าง disable, rotate และ archive
ส่วนหัวข้อ “เลือกระหว่าง disable, rotate และ archive”| สถานการณ์ | การดำเนินการ |
|---|---|
| หยุดการเชื่อมต่อชั่วคราว | Disable |
| secret อาจรั่วไหล | Rotate secret (ทันที) |
| เลิกใช้การเชื่อมต่อแล้ว | Archive |
| อยู่ระหว่างเหตุการณ์ด้านความปลอดภัยและไม่แน่ใจ | Archive เพราะเพิกถอนทั้งสิทธิ์และ refresh token ด้วย |
ข้อแนะนำในการใช้งาน
ส่วนหัวข้อ “ข้อแนะนำในการใช้งาน”- ตั้งชื่อ client ตามระบบ ไม่ใช่ตามบุคคล Zapier CRM bridge ยังใช้ต่อได้แม้คนที่ ตั้งค่าไว้จะลาออกไป
- ให้ scope แคบที่สุด เท่าที่การเชื่อมต่อจำเป็นต้องใช้ คุณขยายเพิ่มทีหลังได้เสมอ
- ตรวจ Last used ทุกไตรมาส client ที่ไม่ได้ใช้งานมานานแต่ยังมีสิทธิ์ที่ใช้งานอยู่ คือสิ่งที่ มักถูกใช้โจมตีอย่างเงียบๆ
- เหตุการณ์ในวงจรชีวิตของ client จะถูกบันทึกไว้ใน บันทึกกิจกรรม
- การลบเวิร์กสเปซจะลบคอนเนกเตอร์และ API key ของเวิร์กสเปซไปด้วย
ที่เกี่ยวข้อง
ส่วนหัวข้อ “ที่เกี่ยวข้อง”การตั้งค่าคุกกี้
เราเคารพสิทธิความเป็นส่วนตัวของคุณ เลือกคุกกี้ที่ต้องการอนุญาต ตัวเลือกของคุณจะมีผลทั่วทั้งเว็บไซต์ นโยบายคุกกี้
จำเป็นต่อการทำงานของเว็บไซต์ รวมถึงการจดจำตัวเลือกความเป็นส่วนตัวของคุณ เปิดใช้งานเสมอ
ช่วยให้เราเข้าใจการใช้งานเว็บไซต์และระบุการสมัครให้กับพันธมิตรผู้แนะนำ ไม่บังคับ