Ga naar inhoud
Entergram openen

OAuth-clients voor de workspace

Settings → Developers → MCP OAuth Clients: maak en beheer OAuth-clients voor de workspace voor de publieke Entergram MCP-gateway.

Beheerdersrechten voor de workspace vereist. Alleen eigenaren en beheerders van de workspace kunnen gedeelde MCP OAuth-clients beheren.


Workspace-clients ondersteunen zowel publieke PKCE-clients als vertrouwelijke clients met client_secret_post of client_secret_basic. Beheer gedeelde integraties hier, en gebruik het gedeelte voor persoonlijke clients voor je eigen agents die aan je seat gebonden zijn.

Leden zien workspace-clients niet rechtstreeks. Ze zijn er voor teambrede automatisering.


Create client: registreer een OAuth-client voor de workspace die kan autoriseren bij de Entergram MCP-gateway.

VeldOpmerkingen
Client nameBijvoorbeeld Entergram Workspace Agent
PlatformKies er een, of Custom
Token endpoint authPubliek (none) of vertrouwelijk (client_secret_post / client_secret_basic)
Require PKCEVerplicht voor publieke clients; aanbevolen voor vertrouwelijke clients als extra bescherming
DescriptionKorte uitleg die op het toestemmingsscherm verschijnt
Redirect URIsEén per regel. HTTPS verplicht buiten localhost
Allowed scopesDeze scopes beperken wat de workspace-client tijdens de autorisatie kan aanvragen

Gebruik none voor lokale PKCE-clients. Gebruik client_secret_* voor gehoste of server-side integraties.

Workspace-clients kunnen de volledige set scopes aanvragen. Zie de scopetabel in MCP-connectors.


Vertrouwelijke clients krijgen een secret dat één keer wordt getoond:

Eenmalig zichtbaar: Entergram bewaart alleen een hash van dit secret. Nadat je dit venster sluit, kun je het alleen nog vernieuwen, niet opnieuw bekijken.

Publieke clients krijgen geen secret en moeten zich authenticeren met PKCE.


De lijst toont Active clients en Total clients, en per client:

  • Public client / Confidential client, PKCE on / PKCE off
  • Created, Created by, Last used, Last used by
  • Active grants
  • Uitklapbare Client details: client-ID, authenticatiemethode, voorbeeld van het secret, PKCE-vereiste, en waar van toepassing een Ban reason
ActieEffect
EditNaam, scopes en redirect-URI’s wijzigen
DisableStopt nieuwe autorisaties en het vernieuwen van tokens totdat de client weer is ingeschakeld
EnableStaat autorisatie en vernieuwen weer toe
Rotate secretGeeft een nieuw secret uit, dat één keer wordt getoond; het oude werkt niet meer
Archive”Archiving disables the client and revokes active grants and refresh tokens for this workspace client.” (Archiveren schakelt de client uit en trekt actieve grants en refresh tokens voor deze workspace-client in.)

Lege staat: “Create the first shared MCP OAuth client for this workspace.” (Maak de eerste gedeelde MCP OAuth-client voor deze workspace.)


Kiezen tussen uitschakelen, vernieuwen en archiveren

Sectie met de titel “Kiezen tussen uitschakelen, vernieuwen en archiveren”
SituatieActie
Een integratie tijdelijk pauzerenDisable
Het secret is mogelijk uitgelektRotate secret (direct)
De integratie wordt niet meer gebruiktArchive
Je zit midden in een incident en twijfeltArchive, want dat trekt ook grants en refresh tokens in

  • Vernoem clients naar het systeem, niet naar de persoon. Zapier CRM bridge blijft bruikbaar als de persoon die hem heeft ingesteld vertrekt.
  • Geef de kleinste set scopes waarmee de integratie werkt. Uitbreiden kan altijd nog.
  • Controleer Last used elk kwartaal. Een client die al lang niet is gebruikt maar wel actieve grants heeft, is precies het soort ding dat stilletjes wordt misbruikt.
  • Gebeurtenissen in de levenscyclus van een client worden vastgelegd in het activiteitenlog.
  • Als je de workspace verwijdert, worden ook de connectors en API-sleutels ervan verwijderd.