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.
| Handleiding | Waarvoor 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-backend | Een servergerenderde of door een API ondersteunde webapp in Node.js. |
| Python/Flask-backend | Een servergerenderde webapp in Python. |
| React single-page-app | Een 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 beschermen | De 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
-
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.
-
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.
-
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. -
Ken uw eindpunten. Alles hieronder is vindbaar via het OpenID-configuratiedocument van uw instantie:
https://<your-domain>/.well-known/openid-configurationVervang
<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 deauthorization_endpoint, hettoken_endpoint, hetuserinfo_endpoint, dejwks_urien hetend_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:
| Doel | Pad |
|---|---|
| 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.