Resurssit · 43
OAuth ja OpenID Connect: integraation varmistaminen päästä päähän
Erota sisäänkirjautumis-, delegointi- ja dataoikeudet, testaa sitten uudelleenohjaukset, tunnukset, istunnot ja peruutukset.
Päivitetty · 8 min
Mitä tämä opas auttaa saavuttamaan
- Erota identiteetti valtuutuksesta.
- Hylkää tahattomat uudelleenohjaukset ja tunnukset.
- Testaa hylkäykset yhtä huolellisesti kuin onnistumiset.
- Tarkista käyttöoikeuden poisto poistumisen tai tapahtuman jälkeen.
Pikatarkistus
- Mitä palveluntarjoajaa ja myöntäjää odotetaan?
- Onko uudelleenohjauksen URI rekisteröity tarkasti?
- Käytetäänkö tunnistetunnusta virheellisesti käyttöoikeustunnuksena?
- Tarkistaako jokainen resurssi omistajuuden?
- Mikä käyttöoikeus säilyy peruuttamisen jälkeen?
Vaiheittainen menetelmä
- 1
Piirrä käyttöönotettu työnkulku.
Tunnista julkinen tai luottamuksellinen asiakas, selain, valtuutuspalvelin, API ja OIDC-palveluntarjoaja. Kirjaa muistiin, minne koodit ja tunnukset kulkevat, kuka niitä tallentaa ja mitkä roolit on myönnetty. Myyntikaavio ei määritä varsinaista käyttöönottoa.
Toimitettava: työnkulku, luottamusrajat ja komponenttien omistajat.
- 2
Tarkista kirjautumistapahtuma.
Käytä asiakkaalle sopivaa koodinkulkua PKCE:n kanssa. Tarkista S256, tapahtumasidonta, rekisteröidyt uudelleenohjaukset ja suojaus väärennettyjä pyyntöjä vastaan. Testaa odottamatonta URI:tä, virheellistä varmentajaa, toistettua koodia ja odottamatonta myöntäjää. RFC 9700 erottelee vaatimukset ja suositukset asiakastyypin mukaan.
Toimitettava: sallittujen ja kiellettyjen testien tulokset.
- 3
Vahvista oikea token.
API vahvistaa käyttöoikeustunnuksensa muodon ja tarjoajan sääntöjen mukaisesti: allekirjoitus tai itsetarkastelu, myöntäjä, yleisö, vanheneminen ja käyttöoikeudet. OIDC-asiakasohjelma vahvistaa identiteettitunnuksen erikseen. Kelvollinen allekirjoitus ei vahvista, että tunnus kuuluu tähän API:in.
Toimitettava: sopimuksen ja yleisön sekä vanhenemisen testit.
- 4
Tarkista liiketoimintaoikeudet.
Testaa toisen tilin omistama objekti, alempi rooli, yksityinen kenttä ja hallinnollinen toiminto. Soveltamisala tai todennettu yhdyskäytävä ei korvaa pyydetyn resurssin palvelinpuolen tarkistuksia. Käytä valtuutettuja testitilejä ja -tietoja.
Toimitettava: rooli, objekti, toiminto ja odotettu hylkäysmatriisi.
- 5
Vanhenemisen ja peruutuksen harjoitus
Erota paikallinen istunto, palveluntarjoajan istunto, käyttöoikeustunnus ja päivitystunnus. Testaa lähtö, kadonnut laite, roolin vaihto, allekirjoitusavaimen kierto ja palveluntarjoajan käyttökatkos. Dokumentoi jäljellä oleva käyttöaika sen sijaan, että oletetaan, että uloskirjautuminen peruuttaa kaiken välittömästi.
Toimitettava: käyttöoikeuksien poiston aikajana ja poikkeukset.
- 6
Tarkkaile paljastamatta salaisuuksia
Kirjaa tapahtumaviite, validointipäätös, virheluokka ja konfiguraatioversio. Sulje pois koodit, tunnukset ja salaisuudet. Valmistele diagnoosi, integraation sulkeminen ja palautus validoituun konfiguraatioon; toista testit palveluntarjoajan vaihtojen jälkeen.
Toimitettava: toimintamenettely ja regressiotarkistukset.
Kuvitteellinen esimerkki
Havainnollistava tilanne
Havainnollistava tilanne: kaksi asiakasta käyttää yhtä identiteetintarjoajaa. Ensimmäiselle kelvollinen token esitetään toisen asiakkaan API:lle.
Päätös ja odotettu näyttö
API hylkää väärän yleisön, tallentaa token-vapaan jäljen eikä palauta tietoja. Hylkäämisestä tulee regressiotesti.
Mekanismien erottaminen
| Mekanismi | Tarkoitus | Vahvistus tai rajoitus |
|---|---|---|
| OAuth 2.0 | Resurssin käyttöoikeuden delegointi | Palvelinpuolen objektien käyttöoikeudet |
| OpenID Connect | Henkilöllisyyden varmistaminen validoidun tunnistetunnuksen avulla | Myöntäjän, yleisön ja tapahtuman validointi |
| Sovellusistunto | Sovelluskirjautumisen ylläpito | Vanheneminen, mitätöinti ja istunnon suojaus |
Johdon indikaattorit
| Indikaattori | Mitä se mittaa | Ensimmäinen toimenpide |
|---|---|---|
| Hylkäysten korjaaminen | Kielletyt tapaukset on tosiasiallisesti estetty | Kaikkien odottamattomien hyväksyntöjen korjaaminen |
| Peruutusviive | Aika, kunnes asiaankuuluva käyttöoikeus katoaa | Istuntojen ja tunnisteiden tarkistaminen erikseen |
| Validointivirheet | Hylkäykset syyn ja version mukaan | Hyökkäysten erottaminen määritysvirheistä |
Yleisiä virheitä
- Todennuksen ja valtuutuksen sekoittaminen
- Minkä tahansa yleisön hyväksyminen allekirjoituksen tarkistamisen jälkeen
- Laajojen uudelleenohjaus-URIen rekisteröinti
- Tunnusmerkkien kirjaaminen lokiin helpompi virheenkorjaus
Usein kysytyt kysymykset
Korvaako PKCE kaikki kontrollit?
Ei. Se suojaa koodinvaihtoa aiotussa työnkulussa; tokenin validointi, uudelleenohjaukset, liiketoiminnan valtuutus ja istunnot on edelleen tarkistettava.
Onko JWT käyttöoikeus?
JWT on formaatti. Vaatimukset tulevat käyttökelpoisiksi vasta validoinnin ja API-sääntöjen soveltamisen jälkeen.
Pitäisikö validointi rakentaa alusta alkaen?
Suosi ylläpidettyä kirjastoa ja tarjoajan dokumentaatiota ja testaa sitten kokoonpanoasi. Oikea kirjasto voidaan silti konfiguroida väärin.
Mitä näyttöä hyödyllisestä tarkistuksesta säilytetään?
Säilytä tilin konteksti, roolit, resurssi ja API-vastaukset. Onnistunut kirjautuminen ei todista oikeita kohdekohtaisia oikeuksia; älä tallenna istuntosalaisuuksia.
OAuth/OIDC: kohde ja oikeudet
Tämän kieliversion tarkemmat lähdekuvaukset ovat englanniksi.
Which token belongs to which recipient? A testable validation contract
A secure OAuth/OIDC integration connects each token to its purpose, issuer and intended recipient. An ID token tells the OIDC client about authentication; an access token is presented to a protected resource. Successful sign-in alone does not authorise a read, a change or an AI agent’s tool call.
This reference covers a specific profile: an API consuming JWT access tokens under RFC 9068. OAuth 2.0 does not require every access token to use JWT. Clients must treat their access tokens as opaque; the resource server owns the validation contract. The examples below are fictional, with no secret or usable signature.
Four objects with distinct purposes
| Object | Recipient and purpose | Boundary to retain |
|---|---|---|
| Authorisation code | Authorisation server token endpoint: redeem the code within the intended transaction. | The code is not an API permission; check binding to the client, redirect and PKCE. |
| ID token | OIDC client: validate identity and transaction; aud contains its client_id. | Do not reuse it as an API access credential; apply the OIDC rules for the relevant flow. |
| Access token | Resource server: access within the grant; its audience identifies the intended resource. | Validate the token, then operation and object permissions. The client must not depend on its internal content. |
| Refresh token | Authorisation server token endpoint: obtain new access tokens. | Do not send it to the resource server; its lifecycle differs from the local session. |
Eight controls for the validation contract
| Control | Rule and scope | Evidence without tokens |
|---|---|---|
| Profile and typ | For RFC 9068, check typ = at+jwt or application/at+jwt. Other profiles need their own rules; “any signed JWT” is too broad a contract. | Configured profile and a rejected ID/access token confusion case. |
| Algorithm and keys | Verify the signature with the expected issuer’s keys and algorithms allowed by configuration. RFC 9068 excludes alg = none; a received value does not set policy by itself. | Cryptographic policy version and result, with no secret material. |
| Issuer iss | Compare exactly with the expected issuer. A similar host, path or suffix does not establish trust. | Configuration reference and issuer_mismatch reason. |
| Audience aud | The expected recipient must appear in aud. An audience array is possible; finding the recipient does not replace other checks. | Expected resource and a test using a token intended for another API. |
| Expiry exp | Current time must precede exp; any small clock leeway is an explicit policy. The teaching fixture uses zero seconds of leeway. | Test clock, configured leeway and an exercised expiry boundary. |
| Scopes and object | Bind each scope to the resource and operation. Then check ownership, tenant and business policy on the server. RFC 9068 does not define all this authorisation. | Action, test object, applied rule and a cross-tenant denial. |
| OIDC transaction and PKCE | If nonce was sent, verify its presence and equality in the ID token. RFC 9700 requires PKCE for public clients and recommends it for confidential clients; bind the challenge to the transaction, with S256 recommended. | Wrong nonce, replayed code and wrong code_verifier tests in the authorised flow. |
| Access lifetime and removal | Separate access-token expiry, renewal and application session. RFC 9700 requires sender constraint or rotation to detect refresh-token replay for public clients. | Residual access timeline, user departure and an exercised revocation procedure. |
Read fictional claims without treating them as proof
Teaching clock: 2026-10-22 at 10:00:00 UTC. The JSON contains a readable header and claims only; no signed JWT serialization is supplied. exp is 10:05:00 UTC and iat is 09:59:00 UTC. The .example domains and identifiers belong solely to this scenario.
{
"header": {
"typ": "at+jwt",
"alg": "RS256",
"kid": "training-key-01"
},
"claims": {
"iss": "https://identity.example/",
"sub": "training-subject-17",
"aud": "https://api.example/evidence",
"exp": 1792663500,
"iat": 1792663140,
"jti": "training-event-001",
"client_id": "training-console",
"scope": "evidence:read"
}
}Decoding JSON does not validate a signature or establish trust in keys. Where stated, cryptography is an exercise assumption, never a check performed by this page. The profile also has required claims including sub, client_id, iat and jti: the eight-control table is not a complete validator. A subject does not necessarily identify a person; jti alone does not implement replay protection.
Ten review cases: decision, limit and expected evidence
01 · Token intended for the API: continue to business checks
Situation: iss, aud, typ and exp match the fictional contract; evidence:read is present. Signature verification is assumed solely for the exercise.
Decision: continue to operation and object checks, without automatically declaring “access allowed”. Expected evidence: business rule and test object reviewed separately.
02 · Assumed correct signature, wrong audience
Change: aud targets https://api.example/billing rather than the evidence resource. Other assumptions remain the same.
Decision: reject this token for this API. A correct signature does not change its recipient. Expected evidence: no resource content returned and a token-free audience failure record.
03 · Different issuer with plausible claims
Change: iss is https://other-identity.example/. An HTTPS URL does not make it equivalent to the configured issuer.
Decision: reject the issuer match. Expected evidence: exact comparison with https://identity.example/ and a regression test.
04 · Expiry reached at the exact second
Change: exp equals the test clock, 10:00:00 UTC, with zero seconds of leeway in this fixture.
Decision: reject as expired. “Now is before exp” is false at equality; this example does not establish a universal clock policy. Expected evidence: tests before, at and after the boundary under the real policy.
05 · ID token presented as an access token
Change: a fictional ID token has typ = JWT and aud = training-console. It targets the OIDC client.
Decision: reject it as an RFC 9068 JWT access token. Validating it at the OIDC client does not turn it into an access token. Expected evidence: separate validation rules for each token type.
06 · Write scope presented for a read operation
Change: scope is evidence:write while the call requires evidence:read.
Decision: deny the read under the exercise policy, which defines no write → read implication. Scope names and relationships belong to the contract. Expected evidence: an explicit operation/scope matrix, without inferring permissions from names.
07 · Readable JSON, unverified cryptography
Situation: the JSON is readable and values appear to match, but cryptographic validation and trusted keys are not established.
Decision: stop acceptance; the state is unverified. Expected evidence: configured library output and trust-contract checks. Reading claims alone must not release protected data.
08 · Correct token, another tenant’s object
Situation: test token checks are assumed to pass. The requested object belongs to another tenant and business policy denies this read.
Decision: deny the object. evidence:read does not grant access to every account’s evidence. Expected evidence: server-side cross-tenant test and no leakage through content or returned fields.
09 · Audience array containing the expected resource
Change: aud contains https://api.example/evidence and https://api.example/archive. The expected resource is listed.
Decision: this audience check can pass; continue all other checks. An array is not a wildcard. Expected evidence: scopes remain meaningful for the resource, with no ambiguous grant.
10 · ID token nonce differs from the transaction
Separate OIDC transaction, outside the API cases: sent nonce = training-transaction-A; received nonce = training-transaction-B.
Decision: reject the ID token for this transaction under OIDC Core §3.1.3.7. This does not replace PKCE or API rules. Expected evidence: compare with the original transaction and test missing nonce when one was sent.
Six useful acceptance-review records
- Map clients, issuers, APIs and expected audiences, with an owner for each boundary.
- Versioned validation contract: format, libraries, trusted keys, algorithms and clock leeway.
- Action, scope, tenant and object matrix; state denials and the permission implications actually defined.
- Synthetic fixtures, a fixed clock, negative variants and observed results in the authorised environment.
- Separate session, access-token and refresh-token timelines during departure, revocation and provider outage.
- Redacted log: internal transaction reference, policy version, decision reason and date; exclude tokens, codes and secrets.
Primary sources and reading scope
- IETF · RFC 9700 · OAuth 2.0 Security BCP · BCP 240 · January 2025
§2.1.1 PKCE · §2.2 replay · §2.3 privilege restriction · §4.14 refresh tokens - IETF · RFC 9068 · JWT access token profile · Standards Track · October 2021
§2.1 typ · §2.2 claims · §4 validation · §6 client treats access tokens as opaque - OpenID Foundation · OpenID Connect Core 1.0 · Final · incorporating errata set 2 · 2023-12-15
§2 ID Token · §3.1.3.7 issuer, audience, expiry and nonce - IETF · RFC 8725 · JWT Best Current Practices · BCP 225 · February 2020
§3.1 algorithms · §3.8–3.9 issuer and audience · §3.11–3.12 token type separation - IETF · RFC 6749 · OAuth 2.0 framework · Standards Track · October 2012 · read with RFC 9700
§1.3.1 authorization code · §1.4 access token · §1.5 refresh token · §3.3 scope
Sources reviewed on
Viralliset viitteet
Viitteet tukevat menetelmää. Sovita tarkastukset kontekstiisi; ne eivät ole sertifiointia. Alkuperäiset viitteiden otsikot ja lähdeasiakirjat voivat olla toisella kielellä.
Lähteet tarkistettu .
