Klien OAuth workspace
Settings → Developers → MCP OAuth Clients, buat dan kelola klien OAuth workspace untuk gateway MCP publik Entergram.
Memerlukan akses admin workspace. Hanya pemilik dan admin workspace yang bisa mengelola klien OAuth MCP bersama.
Workspace vs pribadi
Bagian berjudul “Workspace vs pribadi”Klien workspace mendukung klien PKCE publik maupun klien confidential dengan
client_secret_postatauclient_secret_basic. Simpan integrasi bersama di sini, dan gunakan bagian klien pribadi untuk agen Anda sendiri yang cakupannya terbatas pada seat Anda.
Anggota tidak melihat klien workspace secara langsung, karena klien ini ada untuk otomatisasi seluruh tim.
Membuat klien
Bagian berjudul “Membuat klien”Create client, daftarkan klien OAuth workspace yang bisa melakukan otorisasi ke gateway MCP Entergram.
| Field | Catatan |
|---|---|
| Client name | misalnya Entergram Workspace Agent |
| Platform | Pilih salah satu, atau Custom |
| Token endpoint auth | Publik (none), atau Confidential (client_secret_post / client_secret_basic) |
| Require PKCE | Wajib untuk klien publik; disarankan untuk klien confidential sebagai perlindungan tambahan |
| Description | Penjelasan singkat yang ditampilkan di layar persetujuan |
| Redirect URIs | Satu per baris. Wajib HTTPS di luar localhost |
| Allowed scopes | Scope ini membatasi apa yang bisa diminta klien workspace saat otorisasi |
Gunakan
noneuntuk klien PKCE lokal. Gunakanclient_secret_*untuk integrasi yang di-hosting atau berjalan di sisi server.
Klien workspace bisa meminta set scope lengkap, lihat tabel scope di Konektor MCP.
Client secret
Bagian berjudul “Client secret”Klien confidential mendapat secret yang ditampilkan sekali saja:
Ditampilkan satu kali, Entergram hanya menyimpan hash dari secret ini. Setelah dialog ini ditutup, Anda hanya bisa merotasinya, bukan menampilkannya lagi.
Klien publik tidak mendapat secret dan harus melakukan autentikasi dengan PKCE.
Mengelola klien
Bagian berjudul “Mengelola klien”Daftar ini menampilkan Active clients dan Total clients, serta untuk setiap klien:
- Public client / Confidential client, PKCE on / PKCE off
- Created, Created by, Last used, Last used by
- Active grants
- Client details yang bisa dibuka: Client ID, metode autentikasi, pratinjau secret, persyaratan PKCE, dan Ban reason jika ada
| Tindakan | Efek |
|---|---|
| Edit | Ubah nama, scope, redirect URI |
| Disable | Menghentikan otorisasi baru dan refresh token sampai diaktifkan lagi |
| Enable | Mengizinkan kembali otorisasi dan refresh |
| Rotate secret | Menerbitkan secret baru yang ditampilkan sekali; secret lama berhenti berfungsi |
| Archive | ”Archiving disables the client and revokes active grants and refresh tokens for this workspace client.” (Pengarsipan menonaktifkan klien dan mencabut grant aktif serta refresh token untuk klien workspace ini.) |
Tampilan kosong: “Create the first shared MCP OAuth client for this workspace.” (Buat klien OAuth MCP bersama pertama untuk workspace ini.)
Memilih antara disable, rotate, dan archive
Bagian berjudul “Memilih antara disable, rotate, dan archive”| Situasi | Tindakan |
|---|---|
| Menjeda integrasi untuk sementara | Disable |
| Secret mungkin bocor | Rotate secret (segera) |
| Integrasi sudah tidak dipakai | Archive |
| Anda sedang menangani insiden dan ragu | Archive, karena tindakan ini juga mencabut grant dan refresh token |
Catatan operasional
Bagian berjudul “Catatan operasional”- Beri nama klien sesuai sistemnya, bukan orangnya. Zapier CRM bridge tetap bermakna meski orang yang menyiapkannya sudah keluar.
- Berikan set scope sesempit mungkin yang membuat integrasi tetap berjalan. Anda selalu bisa memperluasnya.
- Tinjau Last used setiap kuartal. Klien yang lama tidak dipakai tetapi masih punya grant aktif adalah jenis celah yang diam-diam dieksploitasi.
- Peristiwa siklus hidup klien dicatat di log aktivitas.
- Menghapus workspace juga menghapus konektor dan API key-nya.
Terkait
Bagian berjudul “Terkait”Preferensi cookie
Kami menghormati hak privasi Anda. Pilih cookie mana yang diizinkan, pilihan Anda berlaku di seluruh situs. Kebijakan Cookie
Dibutuhkan agar situs berfungsi, termasuk mengingat pilihan privasi Anda. Selalu aktif.
Membantu kami memahami penggunaan situs dan mengaitkan pendaftaran dengan mitra referal. Opsional.