API-sleutels
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
- Open Persoonlijk → API-sleutels.
- Selecteer Nieuwe sleutel genereren.
- Voer een beschrijvende naam in, zoals de toepassing of omgeving. Plaats geen geheim in de naam.
- Selecteer Sleutel maken.
- Selecteer in API-sleutel gegenereerd de sleutel alleen indien nodig en selecteer Kopiëren.
- Sla het op in een vertrouwde geheime manager.
- Bevestig de opgeslagen waarde voordat u Ik heb het opgeslagen selecteert.
- 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
- Vergelijk de beoogde sleutel op naam en voorvoegsel.
- Selecteer het verwijderpictogram.
- Controleer de Intrekken-bevestiging.
- Selecteer Intrekken alleen wanneer de afhankelijke toepassing klaar is om deze niet meer te gebruiken.
- 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.