> For the complete documentation index, see [llms.txt](https://docs.safegpt.nl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.safegpt.nl/dms/personalisatie/api-sleutels.md).

# API sleutels

Met een API-sleutel kan software namens uw account of organisatie SafeGPT-functies aanroepen. Maak alleen een sleutel wanneer u begrijpt welke toepassing deze gebruikt en welke rechten nodig zijn.

> **Zeer gevoelig:** behandel een API-sleutel als een wachtwoord. Plaats deze nooit in chatberichten, screenshots, broncode, tickets of openbare configuratie.

***

### Een sleutel maken

1. Open het profielmenu en ga naar **API sleutels**.
2. Klik op **Nieuwe API-sleutel**.
3. Geef een naam die toepassing, omgeving en eigenaar herkenbaar maakt, bijvoorbeeld “Zaaksysteem test – team Data”.
4. Kies uitsluitend de noodzakelijke rechten of scope wanneer die keuze wordt aangeboden.
5. Maak de sleutel aan en kopieer de waarde direct naar een goedgekeurde geheimenkluis.

### De sleutel gebruiken

Voeg de sleutel alleen toe via de beveiligde secret- of configuratievoorziening van de doeltoepassing. Gebruik voor test, acceptatie en productie verschillende sleutels.

```
Authorization: Bearer <uw-api-sleutel>
```

### Intrekken en vervangen

1. Maak eerst een vervangende sleutel en werk de toepassing bij.
2. Test de koppeling zonder de oude sleutel.
3. Trek daarna de oude sleutel in.
4. Trek een vermoedelijk gelekte sleutel onmiddellijk in en meld het incident volgens uw organisatieproces.

| Situatie                  | Actie                                      |
| ------------------------- | ------------------------------------------ |
| Toepassing buiten gebruik | Sleutel intrekken                          |
| Eigenaar wisselt          | Nieuwe sleutel met duidelijke eigenaar     |
| Onverwacht gebruik        | Intrekken, logboeken controleren en melden |