Auth-gereedheid voor agents

Waarom het belangrijk is

Agents hebben een gedocumenteerde manier nodig om inloggegevens te verkrijgen met machtigingen die passen bij de taak. Dat kan met zelf aan te maken API-sleutels met scopes, of met gedelegeerde OAuth met vindbare metadata en PKCE. Documentatie bewijst niet dat authenticatie slaagt.

Zo los je het op

Documenteer een API-sleutelflow met scopes of een OAuth-flow met vindbare metadata en PKCE S256.

1. Leg bij API-sleutels uit waar je zonder handmatige goedkeuring een sleutel aanmaakt en benoem de beschikbare scopes. Publiceer bij OAuth de metadata van de autorisatieserver en de beschermde resource.

2. Leg uit wat elke scope toestaat. Vermeld bij OAuth scopes_supported en voeg S256 toe aan code_challenge_methods_supported.

3. Publiceer /auth.md met het instellen van inloggegevens, de minimaal benodigde scope en een voorbeeld van een geauthenticeerd verzoek voor de ondersteunde flow.

   # Authentication for agents
   
   Create an API key in the [dashboard](https://example.com/settings/api-keys) without manual approval.
   
   ## Scopes
   - `catalog:read`: Read the catalog. Select this scope for catalog queries.
   
   Send the key in the Authorization header as a bearer token.
   
   Example: `curl -H "Authorization: Bearer $API_KEY" https://example.com/api/catalog`

Controleren

Start een nieuwe scan voor dit checkpoint: