> ## 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.

# SAML
- URL: https://blog.esadax.com/fi/saml-fi/
- Published: 2026-11-15T04:21:29.000Z
- Updated: 2026-11-15T04:21:29.000Z
- Author: Esadax 
- Tags: #tr-platform-02-accounts-03-auth-saml, #fi, #mdx-imported, Platform

Ymmärrä, miten **SAML** mahdollistaa kertakirjautumisen (SSO) yrityksille sallimalla käyttäjien todentamisen keskitetyn tunnistetietojen toimittajan (IdP) kautta.

---

## Sisällysluettelo

1. Mikä on SAML?
2. Miten SAML toimii
3. SAML vastaan OIDC
4. SAML:n hyödyt
5. SAML-vahvistukset selitetty
6. SAML SSO:n käyttöönotto
7. Turvallisuusnäkökohdat
8. Vianmääritys
9. Sanasto

---

### Mikä on SAML?

**SAML** (Security Assertion Markup Language) on XML-pohjainen avoin standardi, jota käytetään useiden verkkotunnusten väliseen **kertakirjautumiseen (SSO)**. Sen avulla käyttäjät voivat kirjautua sisään kerran käyttämällä **keskitettyä tunnistetietojen toimittajaa (IdP)** ja saada pääsyn useisiin sovelluksiin (palveluntarjoajat tai SP: t) antamatta tunnistetietoja uudelleen.

- Kehittäjä: **OASIS consortium**
- Yleisesti käytetty yritysympäristöissä
- Yhteensopiva tunnistetietojen toimittajien, kuten Oktan, Azure AD:n ja OneLoginin, kanssa

---

### Miten SAML toimii

1. **Käyttäjä yrittää käyttää** suojattua resurssia (Palveluntarjoaja).
2. **SP uudelleenohjaa** käyttäjän Identity Providerille (IdP).
3. **Käyttäjä todentaa itsensä** IdP:llä (esim. yritystunnisteilla).
4. **IdP lähettää SAML-vastauksen**, joka sisältää vahvistuksen, takaisin SP: lle.
5. **SP vahvistaa vastauksen**, poimii identiteettitiedot ja kirjaa käyttäjän sisään.

---

### SAML vastaan OIDC

| Ominaisuus            | SAML                                        | OpenID-yhteys (OIDC)                      |
| --------------------- | ------------------------------------------- | ----------------------------------------- |
| Protokollan tyyppi    | XML                                         | JSON + REST (OAuth 2.0)                   |
| Suosittu käyttötapaus | Enterprise SSO -tuki                        | Verkko-/mobiilisovellukseen kirjautuminen |
| Kuljetusmekanismi     | Selaimen uudelleenohjaukset (POST/Redirect) | JSON HTTPS:n kautta                       |
| Merkin tyyppi         | SAML-vahvistus (XML)                        | ID-tunnus (JWT)                           |
| Monimutkaisuus        | Korkeampi                                   | Alempi                                    |
| Nykyaikainen käyttö   | Laskeva                                     | Lisääntyvä                                |

> ✅ Käytä SAML: ää yrityksen SSO: lle, OIDC: lle nykyaikaisille sovelluksille ja API: lle.

---

### SAML:n hyödyt

- **Kertakirjautuminen eri sovelluksiin** yhdellä kirjautumisella
- **Vähentynyt salasanaväsymys** ja tunnistetietojen uudelleenkäytön riski
- **Keskitetty käyttäjähallinta** yrityksen IdP:n kautta
- **Tukee MFA:ta** ja vahvoja todennuskäytäntöjä
- **Yritystason yhteensopivuus** HR-järjestelmien ja sisäisten sovellusten kanssa

---

### SAML-vahvistukset selitetty

**SAML-vahvistus** on IdP:n myöntämä XML-dokumentti, joka sisältää henkilöllisyys- ja valtuutustiedot. Se on digitaalisesti allekirjoitettu ja valinnaisesti salattu.

#### Yhteiset väittämäelementit:

- `<Subject>` – Todennettava käyttäjä
- `<AttributeStatement>` – Käyttäjän tiedot (esim. sähköposti, rooli)
- `<Conditions>` – Vanhenemisaika, yleisörajoitukset
- `<AuthnStatement>` – Kirjautumista koskevat tiedot (esim. aikaleima)

Esimerkki (yksinkertaistettu):

```xml
<saml:Assertion>
  <saml:Subject>
    <saml:NameID>jane@esadax.com</saml:NameID>
  </saml:Subject>
  <saml:AttributeStatement>
    <saml:Attribute Name="email">
      <saml:AttributeValue>jane@esadax.com</saml:AttributeValue>
    </saml:Attribute>
    <saml:Attribute Name="role">
      <saml:AttributeValue>admin</saml:AttributeValue>
    </saml:Attribute>
  </saml:AttributeStatement>
</saml:Assertion>

```

---

### SAML SSO:n käyttöönotto

1. **Rekisteröi sovelluksesi** tunnistetietojen toimittajan (IdP) kanssa.
2. **Määritä metatietojen vaihto**:
  - App tarjoaa SAML palveluntarjoaja (SP) metatietoja.
  - IdP jakaa IdP-metatietoja (varmenteet, päätelaitteet).
3. **Määritä Assertion Consumer Service (ACS)**:
  - Tämä on sovelluksen päätepiste SAML-vastausten vastaanottamista varten.
4. **Käsittele SAML-vastaus**:
  - Vahvista allekirjoitus ja jäsennä attribuutit.
  - Luo istunto vahvistustietojen perusteella.

---

### Turvallisuusnäkökohdat

- ✅ **Varmista aina** SAML-vastauksen digitaalinen allekirjoitus
- **Käytä HTTPS:ää** estääksesi väittämien sieppaamisen
- **Hyväksy yleisö** varmistaaksesi, että tunnus on tarkoitettu sovelluksellesi
- ⌛ **Tarkista vanhentumisajat** (`NotBefore`, `NotOnOrAfter`)
- 🚫 **Hylkää allekirjoittamattomat tai peukaloidut väitteet**

---

### Vianmääritys

- **Virheellinen allekirjoitus?**
  - Tarkista, että käytät oikeaa IdP-varmennetta
- **SAML-vastausta ei jäsennetty?**
  - Varmista oikea koodaus (Base64) ja kelvollinen XML-rakenne
- **Virheellinen yleisö?**
  - Varmista, että palveluntarjoajan entiteettitunnus vastaa IdP:ssä määritettyä tunnusta
- **Käyttäjää ei löytynyt?**
  - Tarkista, onko attribuutin kartoitus oikein (esim. sähköposti, nameID)

---

### Sanasto

- SAML (Security Assertion Markup Language) on tietoturvamerkintäkieli.
- **SSO**: Kertakirjautuminen
- **IdP**: Identity Provider (tunnistaa käyttäjän)
- **SP**: Palveluntarjoaja (sovelluksesi)
- **ACS**: Assertion Consumer Service – SAML-vastauksia käsittelevä päätelaite
- **Väite**: IdP: n myöntämä identiteettihyötykuorma
- **Metatiedot**: XML-tiedosto, joka kuvaa SP/IdP-ominaisuuksia ja päätelaitteita

---