> ## Content Index
> Fetch the complete content index at: https://blog.esadax.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# OpenID-yhteys (OIDC)
- URL: https://blog.esadax.com/fi/openid-yhteys-oidc-2/
- Published: 2025-05-04T00:00:00.000Z
- Updated: 2026-11-15T05:36:02.000Z
- Author: Esadax 
- Tags: #tr-platform-02-accounts-03-auth-oidc, #fi, #mdx-imported, Platform

Lue, miten OpenID Connect parantaa todennusta rakentamalla OAuth 2.0 -protokollan päälle tarjotakseen turvallisen, vakioidun tavan todentaa käyttäjät.

## Sisällysluettelo

1. Mikä on OpenID Connect?
2. Miten OIDC toimii
3. Mikä on OAuth 2.0?
4. OIDC:n hyödyt
5. ID-tunnukset selitetty
6. OIDC: n toteuttaminen
7. Turvallisuusnäkökohdat
8. Vianmääritys
9. Sanasto

---

### Mikä on OpenID Connect?

**OpenID Connect (OIDC)** on identiteettikerros, joka on rakennettu OAuth 2.0 -protokollan päälle. Sen avulla asiakkaat (kuten Esadax) voivat tarkistaa käyttäjien henkilöllisyyden valtuutuspalvelimen suorittaman todennuksen perusteella.

- Kehittäjä: OpenID Foundation.
- Laajalti otettu käyttöön nykyaikaisissa verkko- ja mobiilisovelluksissa.
- Käytössä Google, Microsoft, Auth0, Okta, ja enemmän.

---

### Miten OIDC toimii

1. **Käyttäjä yrittää kirjautua sisään** asiakassovelluksessa.
2. **Client ohjaa** käyttäjän Identity Provideriin (IdP).
3. **Käyttäjä tunnistautuu** IdP:n kanssa (esim. käyttäjätunnus + salasana, 2FA).
4. **IdP ohjaa takaisin** asiakkaalle **ID-tunnuksen** ja (valinnaisesti) **pääsytunnuksen** avulla.
5. **Asiakas tarkistaa** ID-tunnuksen allekirjoituksen ja väitteet.
6. **Käyttäjä todennetaan** ja istunto luodaan.

---

### Mikä on OAuth 2.0?

| Ominaisuus               | OAuth 2.0                       | OpenID-yhteys (OIDC)    |
| ------------------------ | ------------------------------- | ----------------------- |
| Tarkoitus                | Valtuutus                       | Todentaminen            |
| Merkin tyyppi            | Pääsytunnus                     | ID-tunnus + pääsytunnus |
| Käyttäjän henkilöllisyys | Ei ole taattu                   | Nimenomaan annettu      |
| Profiilitietojen käyttö  | Vaatii ylimääräisiä kaukoputkia | Tuettu openid\-alueella |
| Standardoidut väitteet   | Ei.                             | Kyllä.                  |

> ✅ OIDC = OAuth 2.0 + identiteetti + standardoitu käyttäjäinfo.

---

### OIDC:n hyödyt

- **Yhteentoimivuus**: Vakiona monilla palveluntarjoajilla ja alustoilla.
- **Turvallisuus**: Käyttää allekirjoitettuja tunnuksia ja todistettuja virtoja.
- **Joustavuus**: Toimii verkkosovelluksissa, mobiilisovelluksissa ja ohjelmointirajapinnoissa.
- **Skaalautuvuus**: Ihanteellinen hajautettuihin tai usean vuokraajan järjestelmiin.
- **Federated Identity**: Yksi kirjautuminen toimii useissa palveluissa.

---

### ID-tunnukset selitetty

**ID Token** on JWT (JSON Web Token), joka sisältää tietoja käyttäjästä.

- **Yhteiset väitteet**:
  - `sub`: Aihe (käyttäjätunnus)
  - `email`Käyttäjän sähköpostiosoite
  - `name`Koko nimi
  - `iat`: Myönnetty klo
  - `exp`: Vanheneminen
  - `iss`: Liikkeeseenlaskija
  - `aud`: Yleisö (sovelluksesi)

Esimerkki dekoodatusta ID-tunnuksen hyötykuormasta:

```json
{
  "sub": "1234567890",
  "name": "Jane Doe",
  "email": "jane@esadax.com",
  "iat": 1692547200,
  "exp": 1692550800,
  "iss": "https://auth.provider.com",
  "aud": "esadax-app"
}

```

---

### OIDC: n toteuttaminen

1. **Valitse palveluntarjoaja**: Google, Auth0, Okta tai itse isännöity (esim. Keycloak).
2. **Rekisteröi hakemuksesi**: Hanki asiakastunnus ja asiakasalaisuus.
3. **Ohjaa käyttäjät palveluntarjoajalle**:
  - Sisällytä `response_type=code` ja `scope=openid`.
4. **Käsittele takaisinkutsu**:
  - Vaihda koodi rahakkeisiin käyttämällä palveluntarjoajan `/token`\-päätepistettä.
5. **Varmista tunnusmerkki**:
  - Tarkista allekirjoitus, `aud`, `exp` ja muut väitteet.
6. **Luo istunto**:
  - Käytä tunnustietoja käyttäjän todentamiseen järjestelmässäsi.

---

### Turvallisuusnäkökohdat

- **Vahvista aina** ID-tunnukset palvelimen puolella.
- **Käytä HTTPS:ää** välttääksesi tunnuksen sieppaamisen.
- **Aseta lyhyet tunnuksen käyttöajat** ja kierrä salaisuuksia.
- **Varmista `nonce`** estääksesi uudelleentoistohyökkäykset.
- **Käytä PKCE:tä** (Proof Key for Code Exchange) julkisille asiakkaille, kuten SPA:t ja mobiilisovellukset.

---

### Vianmääritys

- **Virheellinen tunnuksen allekirjoitus?**
  - Varmista, että käytät oikeaa julkista avainta (JWKS).
- **Virheellinen yleisö (aud)?**
  - Tarkista, että tunnus on myönnetty asiakasnumeroasi varten.
- **Token vanhentunut?**
  - Päivitä tunnus tai todenna käyttäjä uudelleen.
- **Palveluntarjoaja ei uudelleenohjaudu?**
  - Varmista, että uudelleenohjauksen URI vastaa rekisteröityä osoitetta.

---

### Sanasto

- **OIDC**: OpenID Connect, identiteettikerros OAuth 2.0:n päällä.
- **OAuth 2.0**: Resursseihin pääsyn valtuuttamiseen käytettävä protokolla.
- **IdP**: Identity Provider (esim. Google, Okta), joka todentaa käyttäjän.
- **ID Token**: JWT, joka vahvistaa käyttäjän henkilöllisyyden.
- **Pääsytunnus**: Tunnus, jota käytetään suojattujen ohjelmointirajapintojen käyttämiseen.
- **PKCE**: OAuth 2.0:n tietoturvalaajennus julkisille asiakkaille.

---