Clientit
Clientit-osio listaa tenantin kaikki OAuth-clientit: client-tunnus, nimi, tyyppi, tila, redirect-URIt ja luontipäivä.
Uuden clientin luonti
Osio nimeltä “Uuden clientin luonti”| Kenttä | Kuvaus |
|---|---|
| Sovelluksen nimi | Vapaa teksti, näytetään admin-paneelissa ja mahdollisesti consent-näytöllä |
| Client-tyyppi | confidential (palvelinpuolen sovellus) tai public (SPA / mobiili) |
| Redirect-URIt | Yksi per rivi tai välilyönnein eroteltuna. Tarkka merkkijonovastaavuus vaaditaan kirjautumisessa |
| Sallitut scopet | Välilyönnein eroteltu lista. Tunnetut: openid profile email phone address groups orgs. Oletus: openid profile email |
| Post-logout redirect-URIt | Valinnainen, käytetään RP-Initiated Logoutissa |
| Backchannel logout URI | Valinnainen, kutsutaan backchannel-uloskirjautumisessa |
Grant-tyypit ovat kiinteät kaikille clienteille (authorization_code + refresh_token) — niitä ei
valita lomakkeella. public-tyyppiselle clientille PKCE on aina pakollinen; confidential-tyypille
se ei ole.
Luonnin jälkeen client-tunnus ja -salaisuus näytetään vain kerran. Tallenna ne heti — salaisuus
generoidaan ja tallennetaan tiivisteenä myös public-tyyppisille clienteille, mutta selain- ja
mobiilisovellusten ei tule sisällyttää sitä koodiin: julkinen client tunnistautuu PKCE:llä, ei
salaisuudella.
Olemassa olevan clientin hallinta
Osio nimeltä “Olemassa olevan clientin hallinta”Clientin omalla sivulla (/admin/clients/{id}) voi muokata:
- nimeä, redirect-URIeja, sallittuja scopeja, post-logout- ja backchannel-URIa
- Active-lippua (pois päältä kytkettynä client ei voi enää autentikoida)
- First-party client -lippua — kytkettynä consent-näyttö ohitetaan automaattisesti tämän clientin kirjautumisissa
Secretin rotaatio vaatii client-tunnuksen kirjoittamisen vahvistuskenttään. Vanha secret mitätöityy välittömästi rotaation yhteydessä, ja uusi näytetään vain kerran.
Poisto on pysyvä eikä palautettavissa — client lakkaa autentikoimasta välittömästi.
Ei vielä admin-paneelissa
Osio nimeltä “Ei vielä admin-paneelissa”Kaksi ominaisuutta on olemassa tietomallissa mutta ei tämän hetken admin-paneelin lomakkeissa:
- Client-kohtaiset token-elinajat (access/refresh/ID token) — tietokannassa on sarakkeet näille, mutta admin-paneelin muokkauslomake ei tällä hetkellä muuta niitä.
- Client-kohtainen brändäys — yksittäiselle clientille voi asettaa oman kirjautumissivun ulkoasun, joka ohittaa tenantin oletusbrändäyksen kyseisen clientin kirjautumisissa. Tämä asetetaan tällä hetkellä ylläpidon toimesta, ei admin-paneelista — ks. Brändäys.