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

# Authenticatie

> Kies een API-sleutel of OAuth client credentials voor uw integratie en lees hoe elke methode gebruikmaakt van een serviceaccount.

**U hebt OAuth niet nodig om de Public API te gebruiken.** Begin voor een
privé-integratie aan de serverzijde met een API-sleutel met beperkt bereik en volg de
[quickstart](/nl/developers/v1/quickstart). Kies OAuth client credentials wanneer
uw beveiligingsbeleid kortlevende toegangstokens vereist of uw integratieplatform
die flow al ondersteunt.

Beide opties gebruiken een serviceaccount. Een serviceaccount is de identiteit
van de integratie en geen derde authenticatiemethode.

## Hoe de onderdelen samenhangen

| Item | Doel | Wat uw integratie verstuurt |
| - | - | - |
| **Serviceaccount** | Benoemt de workload en bepaalt de maximale machtigingen ervan. | De ID identificeert het account; deze authenticeert een verzoek niet. |
| **API-sleutel** | Authenticeert rechtstreeks als dat serviceaccount, met een gekozen set machtigingen en een vervaldatum. | Het sleutelgeheim via HTTP Basic-authenticatie of `Authorization: Bearer <api_key_secret>`. |
| **OAuth-client** | Authenticeert bij een tokenservice om toegangstokens met beperkt bereik voor dat serviceaccount te verkrijgen. | Een toegangstoken via `Authorization: Bearer <access_token>`. |

Maak per integratie één [serviceaccount](/nl/developers/developer-hub/service-accounts) aan.
Kies voor dat account een API-sleutel of een OAuth-client; u hebt niet beide
methoden nodig bij elk API-verzoek. Geen van beide referenties kan de huidige
machtigingen van het account overschrijden.

De quickstart gebruikt Basic-authenticatie. Een Bearer-header wordt ook
ondersteund voor API-sleutels; het gebruik van die header betekent niet dat u
een OAuth-client nodig hebt.

## Kies een API-sleutel voor een eenvoudige integratie

Gebruik een API-sleutel voor uw eigen geplande taken, rapportagescripts,
datapijplijnen of andere backendservices wanneer een geheim dat in uw
secretmanager is opgeslagen voldoet aan uw beveiligingseisen.

* Doe rechtstreeks geauthenticeerde verzoeken; een tokenuitwisseling is niet nodig.
* Selecteer alleen de machtigingen die de workload nodig heeft en stel een vervaldatum in.
* Roteer de sleutel met behulp van de overlapperiode, of trek de sleutel direct in als deze is blootgesteld.

Een integratie met een API-sleutel heeft geen OAuth-client nodig. Begin met de
[quickstart](/nl/developers/v1/quickstart) en zie vervolgens
[API-sleutels](/nl/developers/developer-hub/api-keys) voor het aanmaken en roteren.

## Kies OAuth voor kortlevende toegangstokens

Gebruik OAuth client credentials voor een vertrouwelijke backendservice wanneer
uw organisatie verlopende toegangstokens vereist of een integratietool de
`client_credentials`-grant verwacht.

1. Maak een OAuth-client met beperkt bereik aan voor het serviceaccount.
2. Authenticeer de client bij uw regionale tokenendpoint met de
   clientauthenticatiemethode die tijdens de configuratie is opgegeven.
3. Stuur het verkregen toegangstoken mee met uw API-verzoeken. Vraag een nieuw token
   aan voordat het huidige token verloopt.

OAuth voegt het verkrijgen van tokens en het afhandelen van verloop toe aan uw
integratie. Het clientgeheim moet nog steeds veilig worden opgeslagen en
geroteerd; kortlevende tokens nemen die verantwoordelijkheid niet weg. Client
credentials gebruikt geen refresh-tokens: authenticeer de client opnieuw om een
nieuw toegangstoken te verkrijgen.

OAuth-toegang moet voor uw organisatie zijn ingeschakeld. Als deze niet is
ingeschakeld, gebruikt u een API-sleutel of neemt u contact op met Living Security Support over uw vereisten.
Zie [OAuth client credentials](/nl/developers/v1/oauth) voor het aanmaken van clients,
eenmalige geheimen, intrekking en herstel.

## Houd referenties op uw backend

API-sleutels van serviceaccounts en OAuth-clientgeheimen horen thuis in opslag
voor geheimen aan de serverzijde. Plaats ze niet in browsercode, mobiele apps,
broncodebeheer of logs. Een referentie van een serviceaccount handelt namens de workload;
het meldt geen persoon aan en biedt geen flow voor klanttoestemming.

Gebruik voor beide methoden de [regionale API-host](/nl/developers/v1/regions) van
uw organisatie. Het wijzigen van de authenticatiemethode verandert niets aan de
resource-URL, de API-versie of de machtigingen die een bewerking vereist.


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