Ga naar inhoud

Inloggen

Er is één identiteit: je Prudai-account in Keycloak (login.prudai.com). De CLI en MCP loggen nooit in met een wachtwoord van Prudai, een persoonlijk token of een sleutel per product. Servicesleutels zijn er alleen voor je eigen applicaties.

  1. prudai login start de device-flow (RFC 8628) met de publieke client prudai-cli. De CLI print een koppel-URL en een code en opent de browser als die er is. Op een machine zonder browser gebruik je prudai login --no-browser.
  2. Je keurt de code goed op login.prudai.com, met je eigen account en de MFA die daar geldt. Dat kan op elk ander apparaat.
  3. De CLI bewaart de sessie in ~/.config/prudai/config.json met bestandsrechten 0600. Producttokens komen nooit op schijf.
  4. Per product wisselt de CLI het token. Voor elke aanroep vraagt de CLI de token-broker (https://mcp.prudai.com/oauth/exchange) om een token voor precies één product. De broker doet de standaard token-exchange (RFC 8693) bij Keycloak.
  5. Het product ziet alleen dat token. Het leeft 5 minuten, heeft één audience, heeft geen refreshtoken en blijft in het geheugen van het proces. Het product controleert uitgever, audience, verlooptijd en organisatie.
Terminal window
prudai login # device-login
prudai whoami # wie, organisatie, effectieve rechten
prudai auth status --online # bewijst dat de sessie nog leeft
prudai auth logout # beëindigt de sessie bij Keycloak, wist daarna lokaal

prudai auth logout beëindigt de sessie bij Keycloak. Een sessie intrekken werkt direct voor nieuwe tokens; een token dat al gewisseld is, verloopt binnen 5 minuten. Een sessie die is ingetrokken of 30 dagen stil lag, geeft not_authenticated met de stap om opnieuw in te loggen.

Een login hoort bij één organisatie. Voor een andere organisatie gebruik je een ander profiel:

Terminal window
prudai profile create klant-b
prudai auth login --profile klant-b

Automatisering van de CLI gebruikt dezelfde login. Een mens keurt de code goed; daarna verplaats je de sessie naar de runner:

Terminal window
prudai auth export --reveal | <secret store> # op de machine waar je inlogde
printf %s "$TOKEN" | prudai auth set --stdin # op de runner

De omgevingsvariabele PRUDAI_REFRESH_TOKEN werkt ook; die wint van het configbestand en schrijft niets weg. Een refreshtoken is een login: bewaar het zoals een wachtwoord.

Een assistent die MCP spreekt, logt in met OAuth bij dezelfde Keycloak. Zie MCP.