Skip to Content

Quickstarts

Uw eigen applicatie aansluiten voor aanmelding via OpenID Connect, met kopieerklare handleidingen voor de generieke flow, Node, Python en React.

Deze handleidingen zorgen dat een applicatie gebruikers via OpenID Connect (OIDC) door het platform laat aanmelden. Begin met de generieke flow om de afzonderlijke bouwstenen te begrijpen en spring dan naar de handleiding die bij uw stack past.

HandleidingWaarvoor u ze gebruikt
OpenID Connect (Authorization Code + PKCE)Het protocol zelf, met kale HTTP en curl. Lees deze eerst; de andere bouwen erop voort.
Node/Express-backendEen servergerenderde of door een API ondersteunde webapp in Node.js.
Python/Flask-backendEen servergerenderde webapp in Python.
React single-page-appEen browserapp zonder eigen backend.
Financial-grade API-client (FAPI 2.0)Een applicatie met een FAPI 2.0-beveiligingsprofiel: private key JWT, pushed authorization requests, DPoP.
Een API beschermenDe andere kant: de access tokens van het platform in uw eigen API valideren en scopes afdwingen.

Om de management-REST-API van het platform vanuit een backendservice aan te roepen (geen gebruikersaanmelding), gebruikt u in plaats daarvan de machine-to-machine-quickstart onder API's.

Voordat u begint

  1. Registreer uw applicatie. Voeg in de Admin Console een applicatie toe en kies het OIDC-type dat bij uw deployment past: een confidential client voor alles met een backend dat een secret geheim kan houden (Node/Express, Python/Flask), of een public client voor een single-page- of native app die dat niet kan. Zie Applicaties.

  2. Noteer de aanmeldgegevens. Een confidential client heeft een client ID en een client secret; een public client heeft alleen een client ID en steunt op PKCE. Bewaar het secret op de server, nooit in browsercode.

  3. Voeg uw redirect-URI toe. Registreer de exacte URL waarnaar het platform de gebruiker na de aanmelding terugstuurt (bijvoorbeeld https://app.example.com/callback). Redirect-URI's worden teken voor teken vergeleken: schema, host, poort, pad en een afsluitende schuine streep moeten identiek zijn; jokertekens worden niet ondersteund.

  4. Ken uw eindpunten. Alles hieronder is vindbaar via het OpenID-configuratiedocument van uw instantie:

    https://<your-domain>/.well-known/openid-configuration

    Vervang <your-domain> door het aanmelddomein van uw instantie (uw aangepaste domein als u er een hebt, anders de host van het platform). Dit document noemt de authorization_endpoint, het token_endpoint, het userinfo_endpoint, de jwks_uri en het end_session_endpoint. Behandel het discovery-document als de maatgevende bron en laat uw bibliotheek het inlezen in plaats van paden hard te coderen.

De eindpunten in één oogopslag

Ter oriëntatie de standaardpaden:

DoelPad
Discovery/.well-known/openid-configuration
Autorisatie/authorize
Token/oauth/token
UserInfo/userinfo
Ondertekeningssleutels (JWKS)/.well-known/jwks
Afmelden (end session)/logout

PKCE is vereist voor public clients en voor applicaties met een Financial-grade API-beveiligingsprofiel, en S256 is de enige geaccepteerde challenge-methode. Gebruik altijd authorization code met PKCE; de implicit flow wordt afgeraden.

Op deze pagina