Pika-aloitus

Kun tenantti on olemassa, ensimmäisen toimivan kirjautumisen saa käyttöön noin kymmenessä minuutissa. Alla vaiheet.

1. Tenantin käyttöönotto

Uusi tenant provisioidaan tunnuspalvelun ylläpidon toimesta pyynnöstä — ota yhteyttä palvelureppu.fi:n kautta. Ylläpito luo tenantin, liittää sille identiteettidomainin (esim. id.esimerkki.fi) ja luo ensimmäisen admin-käyttäjän antamallasi sähköpostiosoitteella.

2. Clientin luonti admin-paneelissa

Kirjaudu sisään admin-käyttäjänä osoitteessa https://id.esimerkki.fi/login (magic link sähköpostiin) ja avaa admin-paneeli (/admin). Luo uusi OAuth-client kohdassa Clients:

• client_id — esim. esimerkki-web
• Redirect URI(t) — sovelluksesi callback-osoite, esim. https://app.esimerkki.fi/auth/callback
• Post-logout redirect URI(t)
• Sallitut grantit ja scopet tarpeen mukaan

client_secret näytetään vain kerran clientin luonnin yhteydessä — tallenna se heti sovelluksesi secret-varastoon.

3. Discovery-URL ja PKCE-integraatio

Hae tenantin discovery-dokumentti:

GET https://id.esimerkki.fi/.well-known/openid-configuration

Se sisältää kaikki tarvittavat endpointit (authorization_endpoint, token_endpoint, jwks_uri jne.). Useimmat OIDC-kirjastot osaavat konfiguroitua suoraan tällä URL:lla — anna kirjastolle issuer, client_id, client_secret (jos julkiselle clientille ei käytetä julkisen clientin PKCE-only-tilaa) ja pyydetyt scopet. PKCE (S256) on pakollinen julkisille clienteille.

Täysi esimerkki: Web-sovelluksen kirjautuminen.

4. Testaus

Kokeile kirjautumisvuota selaimessa /authorize-endpointista lähtien. Varmista, että palautuva ID-token sisältää odotetut claimit — ks. Tokenit ja claimit.

Jos jokin epäonnistuu, tarkista rajapinnan tarkka kuvaus kohdasta Endpointit.