Ga naar inhoud

Servicesleutels

Een servicesleutel is voor je eigen applicatie, van server naar server. Een mens die de CLI gebruikt of een assistent via MCP logt in met Keycloak, niet met een sleutel.

Terminal window
curl -s https://api.prudai.com/v1/account \
-H "Authorization: Bearer prudai_sk_live_..."
VoorvoegselWerkt opGegevens
prudai_sk_live_https://api.prudai.com/v1productie
prudai_sk_test_https://api.staging.prudai.com/v1staging, testgegevens

Een sleutel op de verkeerde omgeving krijgt 401 key_environment_mismatch.

  • Eén organisatie. De organisatie komt uit de sleutel, nooit uit de aanvraag.
  • Scopes. Een sleutel kan alleen wat op de sleutel staat. Stel hem samen per product, object en werkwoord. Zie Scopes en rechten.
  • Verlopen. Optioneel een verloopdatum; daarna 401 api_key_expired.
  • IP-lijst. Optioneel; andere adressen krijgen 403 ip_not_allowed.
  • Schrijven wacht op een mens. Een schrijfscope op een sleutel slaat de goedkeuring niet over.

Dat doe je in de Prudai Console, onder Sleutels. Via de API en de CLI (prudai keys) is het binnenkort.

  • De volledige sleutel zie je één keer. Prudai bewaart alleen een hash.
  • Roteren geeft een nieuwe sleutel; je ziet de nieuwe waarde eenmalig.
  • Intrekken werkt direct; daarna 401 api_key_revoked.

Zet een sleutel nooit in frontendcode of in een repository.