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.
curl -s https://api.prudai.com/v1/account \ -H "Authorization: Bearer prudai_sk_live_..."Omgevingen
Section titled “Omgevingen”| Voorvoegsel | Werkt op | Gegevens |
|---|---|---|
prudai_sk_live_ | https://api.prudai.com/v1 | productie |
prudai_sk_test_ | https://api.staging.prudai.com/v1 | staging, testgegevens |
Een sleutel op de verkeerde omgeving krijgt 401 key_environment_mismatch.
Eigenschappen
Section titled “Eigenschappen”- 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.
Aanmaken, roteren, intrekken
Section titled “Aanmaken, roteren, intrekken”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.