OAuth client của không gian làm việc
Settings → Developers → MCP OAuth Clients, tạo và quản lý các OAuth client của không gian làm việc cho cổng MCP công khai của Entergram.
Cần quyền quản trị không gian làm việc. Chỉ chủ sở hữu và quản trị viên của không gian làm việc mới có thể quản lý các MCP OAuth client dùng chung.
Client của không gian làm việc và client cá nhân
Phần tiêu đề “Client của không gian làm việc và client cá nhân”Client của không gian làm việc hỗ trợ cả client PKCE công khai lẫn client bảo mật dùng
client_secret_posthoặcclient_secret_basic. Hãy đặt các tích hợp dùng chung ở đây, còn các agent của riêng bạn, giới hạn theo seat, thì dùng phần client cá nhân.
Thành viên không trực tiếp nhìn thấy client của không gian làm việc, vì chúng tồn tại để phục vụ tự động hóa cho cả nhóm.
Tạo client
Phần tiêu đề “Tạo client”Create client, đăng ký một OAuth client của không gian làm việc có thể cấp quyền với cổng MCP của Entergram.
| Trường | Ghi chú |
|---|---|
| Client name | Ví dụ: Entergram Workspace Agent |
| Platform | Chọn một nền tảng, hoặc Custom |
| Token endpoint auth | Công khai (none), hoặc bảo mật (client_secret_post / client_secret_basic) |
| Require PKCE | Bắt buộc với client công khai; nên bật cho client bảo mật để tăng thêm một lớp bảo vệ |
| Description | Giải thích ngắn hiển thị trên màn hình đồng ý |
| Redirect URIs | Mỗi dòng một URI. Bắt buộc HTTPS ngoài localhost |
| Allowed scopes | Các scope này giới hạn những gì client của không gian làm việc có thể yêu cầu khi cấp quyền |
Dùng
nonecho client PKCE chạy cục bộ. Dùngclient_secret_*cho tích hợp được lưu trữ trên máy chủ hoặc chạy phía máy chủ.
Client của không gian làm việc có thể yêu cầu toàn bộ tập scope, xem bảng scope trong MCP connectors.
Client secret
Phần tiêu đề “Client secret”Client bảo mật nhận được một secret chỉ hiển thị một lần:
One-time reveal, Entergram chỉ lưu bản băm của secret này. Sau khi đóng hộp thoại, bạn chỉ có thể xoay vòng secret, không thể xem lại.
Client công khai không có secret và phải xác thực bằng PKCE.
Quản lý client
Phần tiêu đề “Quản lý client”Danh sách hiển thị Active clients (client đang hoạt động) và Total clients (tổng số client), cùng với thông tin của từng client:
- Public client / Confidential client, PKCE on / PKCE off
- Created, Created by, Last used, Last used by
- Active grants
- Phần Client details có thể mở rộng: Client ID, phương thức xác thực, bản xem trước của secret, yêu cầu PKCE, và Ban reason nếu có
| Thao tác | Tác động |
|---|---|
| Edit | Đổi tên, scope, redirect URI |
| Disable | Dừng các lần cấp quyền mới và việc làm mới token cho đến khi bật lại |
| Enable | Cho phép cấp quyền và làm mới token trở lại |
| Rotate secret | Cấp một secret mới, chỉ hiển thị một lần; secret cũ ngừng hoạt động |
| Archive | ”Archiving disables the client and revokes active grants and refresh tokens for this workspace client.” (Lưu trữ sẽ vô hiệu hóa client và thu hồi các grant đang hoạt động cùng refresh token của client này.) |
Khi danh sách trống: “Create the first shared MCP OAuth client for this workspace.” (Tạo MCP OAuth client dùng chung đầu tiên cho không gian làm việc này.)
Chọn giữa vô hiệu hóa, xoay vòng và lưu trữ
Phần tiêu đề “Chọn giữa vô hiệu hóa, xoay vòng và lưu trữ”| Tình huống | Thao tác |
|---|---|
| Tạm dừng một tích hợp | Disable |
| Secret có thể đã bị lộ | Rotate secret (ngay lập tức) |
| Tích hợp không còn dùng nữa | Archive |
| Bạn đang xử lý sự cố và chưa chắc chắn | Archive, vì nó thu hồi luôn cả grant và refresh token |
Lưu ý vận hành
Phần tiêu đề “Lưu ý vận hành”- Đặt tên client theo hệ thống, không theo người. Zapier CRM bridge vẫn còn nguyên nghĩa khi người thiết lập nó rời đi.
- Cấp tập scope hẹp nhất đủ để tích hợp hoạt động. Bạn luôn có thể mở rộng sau.
- Xem lại Last used mỗi quý. Một client lâu không dùng nhưng vẫn còn grant đang hoạt động chính là thứ dễ bị khai thác một cách lặng lẽ.
- Các sự kiện trong vòng đời của client được ghi lại trong nhật ký hoạt động.
- Xóa không gian làm việc sẽ xóa luôn các connector và API key của nó.
Liên quan
Phần tiêu đề “Liên quan”Tùy chọn cookie
Chúng tôi tôn trọng quyền riêng tư của bạn. Hãy chọn cookie muốn cho phép, lựa chọn của bạn áp dụng cho toàn bộ trang web. Chính sách cookie
Cần thiết để trang web hoạt động, gồm cả việc ghi nhớ lựa chọn riêng tư của bạn. Luôn bật.
Giúp chúng tôi hiểu cách trang web được sử dụng và ghi nhận lượt đăng ký cho đối tác giới thiệu. Tùy chọn.