> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Todennus

> Valitse integraatiollesi API-avain tai OAuth-asiakastunnistetiedot ja selvitä, miten kumpikin käyttää palvelutiliä.

**Public API:n käyttö ei edellytä OAuthia.** Yksityisessä, palvelinpuolen
integraatiossa kannattaa aloittaa rajatulla API-avaimella ja noudattaa
[pikaopasta](/fi/developers/v1/quickstart). Valitse OAuth-asiakastunnistetiedot,
kun tietoturvakäytäntösi edellyttää lyhytikäisiä käyttöoikeustunnisteita tai
integraatioalustasi tukee jo kyseistä kulkua.

Molemmat vaihtoehdot käyttävät palvelutiliä. Palvelutili on integraation
identiteetti, ei kolmas todennustapa.

## Miten osat liittyvät toisiinsa

| Kohde | Tarkoitus | Mitä integraatiosi lähettää |
| - | - | - |
| **Palvelutili** | Nimeää työkuorman ja määrittää sen käyttöoikeuksien enimmäistason. | Sen tunnus yksilöi tilin; se ei todenna pyyntöä. |
| **API-avain** | Todentaa suoraan kyseisenä palvelutilinä valitulla käyttöoikeusjoukolla ja vanhenemisajalla. | Avaimen salaisuus HTTP Basic -todennuksella tai `Authorization: Bearer <api_key_secret>`. |
| **OAuth-asiakas** | Todentautuu tunnuspalveluun saadakseen kyseiselle palvelutilille rajattuja käyttöoikeustunnisteita. | Käyttöoikeustunniste käyttäen `Authorization: Bearer <access_token>`. |

Luo yksi [palvelutili](/fi/developers/developer-hub/service-accounts) kutakin
integraatiota kohden. Valitse kyseiselle tilille joko API-avain tai
OAuth-asiakas; molempia tapoja ei tarvita jokaisessa API-pyynnössä. Kumpikaan
tunniste ei voi ylittää tilin nykyisiä käyttöoikeuksia.

Pikaopas käyttää Basic-todennusta. API-avaimille tuetaan myös Bearer-otsaketta;
tämän otsakkeen käyttö ei tarkoita, että tarvitsisit OAuth-asiakkaan.

## Valitse API-avain yksinkertaiseen integraatioon

Käytä API-avainta omiin ajastettuihin ajoihisi, raportointiskripteihisi,
datavirtoihisi tai muihin taustapalveluihisi, kun salaisuuden tallentaminen
salaisuuksienhallintaan täyttää tietoturvavaatimuksesi.

* Lähetä todennetut pyynnöt suoraan; tunnisteen vaihtoa ei tarvita.
* Valitse vain työkuorman tarvitsemat käyttöoikeudet ja aseta vanhenemisaika.
* Vaihda avain käyttämällä sen päällekkäisyysaikaa tai peruuta se heti, jos se on paljastunut.

API-avainta käyttävä integraatio ei tarvitse OAuth-asiakasta. Aloita
[pikaoppaasta](/fi/developers/v1/quickstart) ja katso luonti ja vaihto
ohjeesta [API-avaimet](/fi/developers/developer-hub/api-keys).

## Valitse OAuth lyhytikäisiä käyttöoikeustunnisteita varten

Käytä OAuth-asiakastunnistetietoja luottamukselliseen taustapalveluun, kun
organisaatiosi edellyttää vanhenevia käyttöoikeustunnisteita tai
integraatiotyökalu odottaa `client_credentials`-myöntötyyppiä.

1. Luo palvelutilille rajattu OAuth-asiakas.
2. Todenna asiakas alueelliseen tunnuspalvelun päätepisteeseesi käyttämällä
   asennuksen yhteydessä annettua asiakkaan todennustapaa.
3. Lähetä saatu käyttöoikeustunniste API-pyyntöjesi mukana. Hanki uusi
   tunniste ennen kuin nykyinen vanhenee.

OAuth lisää integraatioosi tunnisteiden hankinnan ja vanhenemisen käsittelyn.
Asiakkaan salaisuus on edelleen tallennettava turvallisesti ja vaihdettava
säännöllisesti; lyhytikäiset tunnisteet eivät poista tätä vastuuta. Client
credentials -kulku ei käytä päivitystunnisteita: todenna asiakas uudelleen
saadaksesi uuden käyttöoikeustunnisteen.

OAuth-käyttö on otettava käyttöön organisaatiollesi. Jos sitä ei ole otettu
käyttöön, käytä API-avainta tai ota yhteyttä Living Securityn tukeen
vaatimuksistasi. Katso asiakkaan luonti, kertaluonteiset salaisuudet,
peruuttaminen ja palautus ohjeesta
[OAuth-asiakastunnistetiedot](/fi/developers/v1/oauth).

## Pidä tunnistetiedot taustajärjestelmässäsi

Palvelutilin API-avaimet ja OAuth-asiakkaan salaisuudet kuuluvat
palvelinpuolen salaisuuksien tallennukseen. Älä sijoita niitä selaimessa
suoritettavaan koodiin, mobiilisovelluksiin, versionhallintaan tai lokeihin.
Palvelutilin tunniste toimii työkuormana; se ei kirjaa henkilöä sisään eikä
tarjoa asiakkaan suostumuskulkua.

Käytä kummassakin tavassa organisaatiosi [alueellista API-isäntää](/fi/developers/v1/regions).
Todennustavan vaihtaminen ei muuta resurssin URL-osoitetta, API-versiota eikä
toiminnon vaatimia käyttöoikeuksia.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.