---
title: API-sleutels
description: Genereer, kopieer, identificeer en intrek een persoonlijke Runner API-sleutel veilig.
---

API-sleutels zijn persoonlijke geheimen voor programmatische Runner-toegang. Maak er slechts één voor een toepassing die u vertrouwt, sla deze veilig op en trek deze in wanneer deze niet meer nodig is.

## Wat deze gids behandelt

U leert hoe u het eenmalige geheim maakt en opslaat, bestaande sleutels identificeert zonder deze bloot te stellen, en een sleutel met bevestiging intrekt.

## Beschikbaarheid en vereisten

- **API-sleutels** is voorwaardelijk en verschijnt alleen wanneer ingeschakeld voor uw account.
- Sleutels behoren tot uw persoonlijke account, niet tot één winkel.
- Plaats nooit een volledige sleutel in chat, Agent Memory, een Skill, een schermafbeelding, broncodebeheer of productdocumentatie.

## Invoerpad

Selecteer **avatar → Instellingen → Persoonlijk → API-sleutels**. Als de invoer afwezig is, is de functie niet beschikbaar voor het huidige account.

## Besturingselementen

| Invoer of knop | Waarom het nuttig is | Wat gebeurt er vervolgens |
| --- | --- | --- |
| **Nieuwe sleutel genereren** | Maak een nieuwe referentie. | Een dialoogvenster wordt geopend met een optioneel naamveld. |
| **Naam** | Identificeer de toepassing later zonder het geheim bloot te stellen. | De naam verschijnt in de sleuteltabel; leeg maakt een naamloze sleutel. |
| **Sleutel maken** | Genereer de referentie. | Runner opent **API-sleutel gegenereerd** en geeft het volledige geheim eenmaal weer. |
| Oogpictogram | Controleer de volledige nieuw gegenereerde waarde voordat u deze opslaat. | De eenmalige waarde wordt weergegeven of gemaskeerd in het succesdialoogvenster. |
| Kopieerpictogram | Kopieer de nieuwe sleutel nauwkeurig. | Runner kopieert het naar het klembord en toont bevestiging. |
| **Ik heb het opgeslagen** | Sluit de eenmalige geheime weergave. | De volledige waarde wordt uit het dialoogvenster gewist en kan daar niet opnieuw worden weergegeven. |
| Bestaande sleuteltabel | Identificeer sleutels veilig. | Runner toont Naam, Voorvoegsel, Gemaakt en Laatst gebruikt, niet het volledige geheim. |
| Verwijderpictogram | Trek een bestaande sleutel in. | Een bevestiging legt uit dat intrekking niet ongedaan kan worden gemaakt. |
| **Intrekken** | Schakel de geselecteerde sleutel uit. | Na succes wordt de sleutel uit de lijst verwijderd en kan deze niet langer verifiëren. |

## Een sleutel genereren en opslaan

1. Open **Persoonlijk → API-sleutels**.
2. Selecteer **Nieuwe sleutel genereren**.
3. Voer een beschrijvende naam in, zoals de toepassing of omgeving. Plaats geen geheim in de naam.
4. Selecteer **Sleutel maken**.
5. Selecteer in **API-sleutel gegenereerd** de sleutel alleen indien nodig en selecteer Kopiëren.
6. Sla het op in een vertrouwde geheime manager.
7. Bevestig de opgeslagen waarde voordat u **Ik heb het opgeslagen** selecteert.
8. Gebruik het tabelvoorvoegsel om de sleutel later te identificeren zonder de volledige waarde bloot te stellen.

Runner waarschuwt dat de volledige sleutel niet opnieuw wordt weergegeven. Als u het dialoogvenster sluit zonder het op te slaan, trekt u die sleutel in en maakt u een vervanging in plaats van te proberen het geheim terug te krijgen.

## Een sleutel intrekken

1. Vergelijk de beoogde sleutel op naam en voorvoegsel.
2. Selecteer het verwijderpictogram.
3. Controleer de **Intrekken**-bevestiging.
4. Selecteer **Intrekken** alleen wanneer de afhankelijke toepassing klaar is om deze niet meer te gebruiken.
5. Bevestig **API-sleutel ingetrokken** en verwijder het oude geheim uit de toepassing.

Intrekking is destructief en kan niet ongedaan worden gemaakt. Maak een nieuwe sleutel als toegang opnieuw nodig is.

## Statussen en limieten

- **Nog geen API-sleutels** is de normale lege status.
- De volledige waarde van een nieuwe sleutel verschijnt alleen in het succesdialoogvenster.
- Bestaande rijen tonen een voorvoegsel en gebruiksdatums, geen herstelbare sleutel.
- **Nooit** onder Laatst gebruikt betekent dat Runner geen verzoek voor die sleutel heeft vastgelegd.
- Knoppen Maken en Intrekken tonen voortgang en mogen niet herhaaldelijk worden ingediend.

## Probleemoplossing

- Als API-sleutels ontbreken, gebruik geen gekopieerde directe link; de functie is uitgeschakeld voor dit account.
- Als klembordkopie mislukt, onthul de nieuwe waarde en kopieer deze handmatig naar een veilige geheime manager, verberg het vervolgens opnieuw.
- Als u een volledige sleutel bent kwijtgeraakt, trekt u de rij in en genereert u een vervanging.
- Als een toepassing niet meer werkt na intrekking, werkt u deze bij met een nieuw gemaakte sleutel; de oude sleutel kan niet worden hersteld.
- Als de verkeerde sleutel is geselecteerd, annuleert u de bevestiging en vergelijkt u opnieuw naam en voorvoegsel.

## Gerelateerde handleidingen

- [Beveiliging en sessies](./security-and-sessions)
- [Persoonlijke instellingen en werkruimten](./personal-settings-and-workspaces)
- [Geheugenbeveiliging](../agent/memory)