ข้ามไปยังเนื้อหา
เปิด Entergram

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 เหล่านี้มีไว้สำหรับระบบอัตโนมัติของทั้งทีม


Create client ลงทะเบียน OAuth client ของเวิร์กสเปซที่ขออนุญาตกับ Entergram MCP gateway ได้

ฟิลด์หมายเหตุ
Client nameเช่น Entergram Workspace Agent
Platformเลือกหนึ่งรายการ หรือ Custom
Token endpoint authPublic (none) หรือ Confidential (client_secret_post / client_secret_basic)
Require PKCEบังคับสำหรับ client แบบ public แนะนำให้ใช้กับแบบ confidential เพื่อเพิ่มการป้องกัน
Descriptionคำอธิบายสั้นๆ ที่แสดงบนหน้ายินยอม
Redirect URIsหนึ่งรายการต่อบรรทัด ต้องใช้ HTTPS ถ้าไม่ใช่ localhost
Allowed scopesscope เหล่านี้จำกัดสิ่งที่ client ของเวิร์กสเปซขอได้ระหว่างการอนุญาต

ใช้ none สำหรับ client แบบ PKCE ในเครื่อง ใช้ client_secret_* สำหรับการเชื่อมต่อแบบโฮสต์ หรือฝั่งเซิร์ฟเวอร์

client ของเวิร์กสเปซขอ scope ได้ครบทุกรายการ ดูตาราง scope ใน MCP connectors


client แบบ confidential จะได้รับ secret ที่ แสดงเพียงครั้งเดียว:

แสดงครั้งเดียว Entergram เก็บเพียงค่าแฮชของ secret นี้ หลังจากปิดหน้าต่างนี้ คุณจะทำได้เพียงหมุนเวียน secret ใหม่ แต่จะดู secret เดิมอีกไม่ได้

client แบบ public ไม่มี secret และต้องยืนยันตัวตนด้วย PKCE


รายการแสดง 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
secret อาจรั่วไหลRotate secret (ทันที)
เลิกใช้การเชื่อมต่อแล้วArchive
อยู่ระหว่างเหตุการณ์ด้านความปลอดภัยและไม่แน่ใจArchive เพราะเพิกถอนทั้งสิทธิ์และ refresh token ด้วย

  • ตั้งชื่อ client ตามระบบ ไม่ใช่ตามบุคคล Zapier CRM bridge ยังใช้ต่อได้แม้คนที่ ตั้งค่าไว้จะลาออกไป
  • ให้ scope แคบที่สุด เท่าที่การเชื่อมต่อจำเป็นต้องใช้ คุณขยายเพิ่มทีหลังได้เสมอ
  • ตรวจ Last used ทุกไตรมาส client ที่ไม่ได้ใช้งานมานานแต่ยังมีสิทธิ์ที่ใช้งานอยู่ คือสิ่งที่ มักถูกใช้โจมตีอย่างเงียบๆ
  • เหตุการณ์ในวงจรชีวิตของ client จะถูกบันทึกไว้ใน บันทึกกิจกรรม
  • การลบเวิร์กสเปซจะลบคอนเนกเตอร์และ API key ของเวิร์กสเปซไปด้วย