API-tokens beheren, opnieuw genereren en intrekken
Vind je API-tokens, genereer een geheim opnieuw (één keer, met een optionele overlap van 24 uur), trek een token in, begrijp verloopdata en IP-toegangslijsten, en zie waarom een token niet meer werkt.
Het tabblad Tokens bevat een lijst met je API-tokens, inclusief hun toegang, limieten en laatste gebruik. Vanaf daar kun je het geheim van een token opnieuw genereren, een token intrekken en zien waarom een token is gestopt met werken.
Waar je je tokens kunt vinden
Open het werkruimtemenu en kies AI agents & API. Het tabblad Tokens is het eerste tabblad; elk tabblad toont het aantal items.
Wie welke tokens ziet:
| Jouw rol | Je ziet | Je kunt |
|---|---|---|
| Eigenaar of beheerder | "Elk token in deze werkruimte. Leden zien hun eigen tokens." Filter op persoon met het eigenaarsmenu (Iedereen toont alles). | Elk token intrekken. Alleen je eigen tokens opnieuw genereren. |
| Editor of Content Creator | "Jouw tokens. Agents die deze gebruiken, handelen namens jou." | Je eigen tokens intrekken en opnieuw genereren. |
Elke rij toont de Naam (met de laatste tekens van het geheim, zoals clv_agent_…k7Qe), de Eigenaar, de Toegang (de rechten), de Sites die eronder vallen, Aangemaakt, Laatst gebruikt en Verloopt. De voettekst telt de actieve tokens van de werkruimte mee voor de limiet. Badges op een rij:
| Badge | Betekenis |
|---|---|
| Geeft credits uit | Het token heeft credits:spend. Wijs ernaar om de limieten te zien: Per taak, Per dag, Per maand ("geen limiet" indien leeg) en "Automatisch goedgekeurd onder n credits" of "Een persoon keurt elke betaalde start goed". |
| IP-beperkt | Het token heeft een IP-toegangslijst en werkt alleen vanaf die adressen. |
| Overschrijdt rol | "De rol van de eigenaar is gewijzigd. Aanroepen die de doorgehaalde vaardigheden vereisen, worden geweigerd." |
| Ingetrokken / Verlopen | Het token werkt niet meer. De reden staat ernaast (zie Waarom een token is gestopt met werken). |
Ingetrokken en verlopen tokens zijn standaard verborgen. Klik op Toon ingetrokken en verlopen (aantal) om ze weer te geven; ze blijven 30 dagen in de lijst staan.
Toegang van een token wijzigen
De rechten, sites, verloopdatum, bestedingslimieten en IP-toegangslijst van een token kunnen niet worden bewerkt nadat het is aangemaakt. Om een van deze zaken te wijzigen, maak je een nieuw token aan met de nieuwe instellingen, schakel je je agent over en trek je daarna het oude token in.
Het geheim van een token opnieuw genereren
Genereer het geheim opnieuw als het mogelijk is gelekt, of om het volgens schema te roteren. Het nieuwe geheim heeft dezelfde naam, toegang, sites, IP-toegangslijst, bestedingslimieten en verloopdatum.
Open het menu van het token
Open op het tabblad Tokens het ⋯-menu op de rij van het token en kies Geheim opnieuw genereren.
Kies wanneer het oude geheim stopt
Het dialoogvenster vraagt "Naam opnieuw genereren?": "Je krijgt een nieuw geheim met dezelfde toegang. Het oude stopt met werken." Vink Houd het oude geheim 24 uur actief aan als agents het nog gebruiken en je tijd nodig hebt om ze over te zetten. Laat dit uitgevinkt om het oude geheim direct te stoppen.
Kopieer het nieuwe geheim
Klik op Opnieuw genereren. Het dialoogvenster Token aangemaakt toont het nieuwe geheim één keer. Kopieer het, werk je agent of geheimenopslag bij en klik daarna op Ik heb het opgeslagen.
Regels voor het opnieuw genereren:
- Alleen de persoon die een token heeft aangemaakt, kan het opnieuw genereren. Een eigenaar of beheerder die het niet heeft aangemaakt, ziet "Alleen de persoon die dit token heeft aangemaakt, kan het opnieuw genereren. Je kunt het wel intrekken."
- Een geheim kan één keer opnieuw worden gegenereerd. Daarna toont de oude rij "Vervangen door een opnieuw gegenereerd geheim" en is de optie Geheim opnieuw genereren niet beschikbaar; genereer in plaats daarvan het nieuwe token opnieuw. Opnieuw proberen bij het oude geheim geeft de melding "Dit token is al opnieuw gegenereerd, ingetrokken of verlopen; gebruik de vervanging of maak een nieuwe aan."
- De verloopdatum verschuift niet. Een token dat voor 90 dagen is aangemaakt, verloopt nog steeds op de oorspronkelijke datum. Als de 24 uur van het oude geheim na die datum zouden vallen, stopt het op de verloopdatum.
- Je kunt opnieuw genereren, zelfs als de werkruimte de limiet voor actieve tokens heeft bereikt. Tijdens de overlap van 24 uur werken beide geheimen en tellen ze beide als actieve tokens.
- Voor opnieuw genereren moet de werkruimte op het Pro-abonnement of hoger zitten; anders opent Geheim opnieuw genereren het upgrade-dialoogvenster.
Een token intrekken
- Open het ⋯-menu op de rij van het token en kies Intrekken.
- Bevestig met Token intrekken: "Agents die dit token gebruiken, verliezen direct de toegang. Dit kan niet ongedaan worden gemaakt."
Een ingetrokken token maakt direct zijn plek vrij in de limiet voor actieve tokens van de werkruimte.
Verloopdatum
Elk token verloopt. Je kiest de levensduur bij het aanmaken: 7 dagen, 30 dagen, 90 dagen (de standaard) of 1 jaar. Er is geen optie voor "nooit verlopen", zodat een vergeten token niet voor altijd geldig blijft. De kolom Verloopt toont de datum.
Na de verloopdatum geeft elke aanroep de melding "Dit token is verlopen. Maak een nieuwe aan in Integraties → AI agents & API." Een verlopen token kan niet worden vernieuwd of opnieuw gegenereerd; maak een nieuwe aan.
IP-toegangslijst
Een token kan worden beperkt tot de adressen van waaruit je agent draait (bijvoorbeeld een CI-runner of een server). Je stelt dit in bij de stap Limieten van de wizard onder Geavanceerd → IP-toegangslijst: "Optioneel. Eén adres of bereik per regel; aanroepen vanaf andere locaties worden geweigerd."
- Voer IPv4- of IPv6-adressen (
203.0.113.7) of bereiken in CIDR-notatie (198.51.100.0/24) in, tot maximaal 20 vermeldingen. - Laat dit leeg om elk adres toe te staan. De controlestap toont dan Elk adres.
- Een aanroep vanaf een ander adres geeft de melding "Dit token kan niet worden gebruikt vanaf dit IP-adres."
- Een vermelding die geen adres of bereik is, wordt geweigerd: "waarde is geen geldig IP-adres of bereik."
Waarom een token is gestopt met werken
| Getoond bij het token | Wat is er gebeurd | Wat te doen |
|---|---|---|
| Verlopen | De levensduur is verstreken. | Maak een nieuw token aan. |
| "Ingetrokken door eigenaar" | De persoon die het heeft aangemaakt, heeft het ingetrokken. | Maak een nieuw token aan als het nog nodig is. |
| "Ingetrokken door beheerder" | De eigenaar van de werkruimte of een beheerder heeft het ingetrokken. | Vraag hen waarom voordat je een nieuwe aanmaakt. |
| "Ingetrokken: eigenaar heeft de werkruimte verlaten" | De persoon die het heeft aangemaakt, is verwijderd uit de werkruimte. Al hun tokens zijn ingetrokken. | Iemand die nog in de werkruimte zit, maakt een nieuw token aan. |
| "Ingetrokken: account van eigenaar is verwijderd" | De eigenaar heeft hun Clevera-account verwijderd. | Maak een nieuw token aan. |
| "Vervangen door een opnieuw gegenereerd geheim" | Het geheim is opnieuw gegenereerd. | Gebruik het nieuwe geheim. |
| "Ingetrokken: gevonden in een openbare repository" | Het token is gevonden in een openbare GitHub-repository en automatisch ingetrokken. | Verwijder het uit de geschiedenis van de repository, maak een nieuw token aan en bewaar dit in een geheimenopslag. |
| "Ingetrokken: ongebruikelijke activiteit" | Het heeft in enkele minuten veel geweigerde verzoeken gedaan (meer dan 50 in 10 minuten). | Controleer de activiteit om te zien wat er geprobeerd werd, repareer de agent en maak een nieuw token aan. |
| "Ingetrokken: tokenhergebruik gedetecteerd" / "Ingetrokken: app losgekoppeld" | Deze zijn van toepassing op gekoppelde apps, niet op API-tokens. | Koppel de app opnieuw. |
| Elke aanroep geeft "De agent-API is niet beschikbaar in het abonnement van deze werkruimte. Het is beschikbaar vanaf Pro." | De werkruimte is niet langer op Pro, Business of Custom. | Upgrade naar Pro. Zie Als de werkruimte Pro verlaat. |
Ongebruikelijke activiteit
Clevera houdt elk token in de gaten op pieken en informeert de eigenaar van de werkruimte met een melding "Ongebruikelijke activiteit op token":
- Veel geweigerde verzoeken in enkele minuten: het token wordt ingetrokken. "Het heeft in enkele minuten veel geweigerde verzoeken gedaan."
- Een ongebruikelijk hoog aantal wijzigingen in enkele minuten (meer dan 200 schrijfacties of 20 paginawijzigingen in 10 minuten): de schrijfacties worden 10 minuten gepauzeerd. Aanroepen geven "Schrijfacties van dit token zijn gepauzeerd na een ongebruikelijke piek in wijzigingen. De eigenaar van de werkruimte is op de hoogte gesteld." Lezen werkt nog wel.
- Credits ongebruikelijk snel verbruikt: het token kan 24 uur lang geen betaald werk starten. "Het heeft in enkele minuten een ongebruikelijk hoog aantal credits verbruikt, dus het kan voorlopig geen betaald werk starten."
Als de werkruimte Pro verlaat
AI agents & API is beschikbaar in de Pro-, Business- en Custom-abonnementen. Als de werkruimte overstapt naar Starter of Free, toont de pagina "AI agents & API zijn inbegrepen in Pro": "Upgrade om Claude, ChatGPT en je scripts in deze werkruimte te laten werken. Bestaande tokens en apps stoppen tot die tijd met werken; je kunt ze hier nog wel intrekken."
- Tokens blijven in de lijst staan en kunnen worden ingetrokken, maar elke aanroep wordt geweigerd met
plan_locked. - Geheim opnieuw genereren opent in plaats daarvan het upgrade-dialoogvenster.
- Upgraden naar Pro zorgt ervoor dat de tokens weer werken. Er wordt niets verwijderd; tokens verlopen nog steeds op hun datum.