Naar inhoud
instellect.ai
Beveiliging & regie

API-sleutels voor AI-agents: secrets buiten de modelcontext

Een agent hoeft een geheime sleutel meestal niet te kennen om een tool te gebruiken. De uitvoerende service kan authenticatie afhandelen buiten de modelcontext.

In het kort

Bewaar secrets in een daarvoor ingerichte geheime opslag en laat alleen de benodigde runtime ze gebruiken. Geef het model een toolcontract en een resultaat, geen toegangstoken. Houd sleutels afgebakend per omgeving en functie en ontwerp rotatie en intrekking mee.

Volg de sleutel door de hele route

Controleer niet alleen de broncode. Secrets kunnen belanden in configuratieexports, foutmeldingen, requestlogs en toolresultaten. Teken waar de sleutel wordt opgehaald en aan welke externe dienst hij wordt aangeboden. De modelprovider hoeft die waarde niet te ontvangen wanneer de authenticatie door jouw toolservice wordt afgehandeld. Een verborgen veld in een prompt is nog steeds modelinput.

Scheid omgevingen en bevoegdheden

Een testworkflow mag geen productiecredential gebruiken omdat dat gemakkelijker is. Kies aparte sleutels of identiteiten met beperkte rechten. Bewaar bij elke secret een eigenaar, doel en rotatieafspraak. Als een connector slechts één brede sleutel ondersteunt, benoem die beperking expliciet en compenseer waar mogelijk met beperkingen in de service en het netwerk. Noem zo’n sleutel niet fijnmazig alleen omdat de toolnaam specifiek is.

Oefen intrekken voordat er een incident is

Een sleutel vervangen is pas afgerond wanneer nieuwe taken de nieuwe waarde gebruiken en oude waarden niet langer werken. Onderzoek caches en langlopende processen. Bepaal hoe een taak reageert op een ongeldige credential: een duidelijke beheerfout is beter dan herhaald proberen zonder eindpunt. Koppel dit aan incidentrespons voor agents.

Controlepunten voor secretbeheer

Controlepunten voor secretbeheer
PlaatsGewenst gedragPraktische test
ModelcontextGeen geheime authenticatiewaardenInspecteer fictieve testrequests
RuntimeAlleen noodzakelijke toegangAndere tool kan secret niet ophalen
LogsGevoelige headers en velden afgeschermdForceer een fout met testcredential
RotatieNieuwe waarde actief, oude ingetrokkenTest nieuwe en oude waarde apart
Illustratief scenario

Een connector die een fout teruggeeft

Een externe API weigert een request en de connector geeft de volledige requestheaders terug aan het model. Daarin staat een testtoken. De integratietest vindt de lekkage voordat productiegebruik start. De foutafhandeling wordt aangepast naar een veilige foutcode met een interne referentie; volledige headers worden niet naar de modelcontext doorgestuurd.

Neem mee naar je team.

  • Zoek naar secrets in prompts, logs en foutpaden.
  • Gebruik afzonderlijke waarden voor test en productie.
  • Leg een bewezen procedure voor rotatie en intrekking vast.
Download dit werkblad (.txt) ↓

Met ruimte voor je besluit, eigenaar en testbewijs. Geen e-mailadres nodig.

Bronnen & verantwoording

Technische achtergrond bij dit onderwerp. De keuzetabel, checklist en fictieve voorbeelden zijn een eigen redactionele uitwerking van Instellect. De beschreven patronen zijn geen overzicht van reeds beschikbare productfuncties.

Geraadpleegd op 11 oktober 2026. Een correctie doorgeven? Mail Instellect.

Van lezen naar je eigen workflow

Maak de volgende keuze concreet.

Gebruik het gratis hulpmiddel om de taak, bronnen en grenzen met je team te bespreken.

Doe de AI readiness check
Volg de ontwikkeling van Instellect.

Instellect is in ontwikkeling. Aanmelden geeft nog geen directe toegang tot het platform.

Naar de waitlist ↗