Hantera, återskapa och återkalla API-tokens

Fliken Polletter listar dina API-tokens med deras åtkomst, gränser och senaste användning. Därifrån kan du återskapa en tokens hemlighet, återkalla en token och se varför en token slutade fungera.

Var du hittar dina tokens#

Öppna arbetsytemenyn och välj AI agents & API. Fliken Polletter är den första fliken; varje flik visar sitt antal.

Vem som ser vilka tokens:

Varje rad visar Namn (med de sista tecknen i hemligheten, som clv_agent_…k7Qe), Ägare, Åtkomst (dess behörigheter), Webbplatser den täcker, Skapad, Senast använd och Går ut. Sidfoten räknar arbetsytans aktiva tokens mot dess gräns. Märken på en rad:

Återkallade och utgångna tokens är dolda som standard. Klicka på Visa återkallade och utgångna (antal) för att lista dem; de förblir listade i 30 dagar.

Ändra en tokens åtkomst#

En tokens behörigheter, webbplatser, utgångsdatum, utgiftstak och IP-tillåtelselista kan inte redigeras efter att den skapats. För att ändra något av dem, skapa en ny token med de nya inställningarna, växla över din agent och återkalla sedan den gamla.

Återskapa en tokens hemlighet#

Återskapa när en hemlighet kan ha läckt, eller för att rotera den enligt ett schema. Den nya hemligheten har samma namn, åtkomst, webbplatser, IP-tillåtelselista, utgiftstak och utgångsdatum.

1. Öppna token-menyn#

   På fliken Polletter, öppna ⋯-menyn på token-raden och välj Återskapa hemlighet.

2. Välj när den gamla hemligheten slutar fungera#

   Dialogrutan frågar "Återskapa “namn”?": "Du får en ny hemlighet med samma åtkomst. Den gamla slutar fungera." Kryssa i Behåll den gamla hemligheten aktiv i 24 timmar om agenter fortfarande använder den och du behöver tid att växla över dem. Lämna den okryssad för att stoppa den gamla hemligheten omedelbart.

3. Kopiera den nya hemligheten#

   Klicka på Återskapa. Dialogrutan Token skapad visar den nya hemligheten en gång. Kopiera den, uppdatera din agent eller hemlighetslagring och klicka sedan på Jag har sparat den.

Regler för återskapande:

• Endast personen som skapade en token kan återskapa den. En ägare eller administratör som inte skapade den ser "Endast personen som skapade denna token kan återskapa den. Du kan återkalla den."
• En hemlighet kan återskapas en gång. Efter det visar den gamla raden "Ersatt av en återskapad hemlighet" och har inget alternativ för Återskapa hemlighet; återskapa den nya token istället. Att försöka igen på den gamla hemligheten returnerar "Denna token har redan återskapats, återkallats eller gått ut; använd dess ersättare eller skapa en ny."
• Utgångsdatumet flyttas inte. En token skapad för 90 dagar går fortfarande ut på sitt ursprungliga datum. Om den gamla hemlighetens 24 timmar skulle löpa förbi det datumet, stannar den vid utgångsdatumet.
• Du kan återskapa även när arbetsytan har nått sin gräns för aktiva tokens. Under 24-timmarsöverlappningen fungerar båda hemligheterna och båda räknas som aktiva tokens.
• Återskapande kräver att arbetsytan har Pro eller högre; annars öppnar Återskapa hemlighet uppgraderingsdialogen.

Återkalla en token#

1. Öppna ⋯-menyn på token-raden och välj Återkalla.
2. Bekräfta med Återkalla token: "Agenter som använder denna token förlorar åtkomst omedelbart. Detta kan inte ångras."

En återkallad token frigör omedelbart sin plats i arbetsytans gräns för aktiva tokens.

Utgång#

Varje token går ut. Du väljer livslängden när du skapar den: 7 dagar, 30 dagar, 90 dagar (standard) eller 1 år. Det finns inget alternativ för "går aldrig ut", så en bortglömd token kan inte förbli giltig för evigt. Kolumnen Går ut visar datumet.

Efter utgångsdatumet returnerar varje anrop "Denna token har gått ut. Skapa en ny i Integrations → AI agents & API." En utgången token kan inte förnyas eller återskapas; skapa en ny.

IP-tillåtelselista#

En token kan begränsas till de adresser din agent körs från (till exempel en CI-runner eller en server). Du ställer in det i guiden under steget Gränser under Avancerat → IP-tillåtelselista: "Valfritt. En adress eller ett intervall per rad; anrop från någon annanstans nekas."

• Ange IPv4- eller IPv6-adresser (203.0.113.7) eller intervall i CIDR-format (198.51.100.0/24), upp till 20 poster.
• Lämna den tom för att tillåta vilken adress som helst. Granskningssteget visar då Vilken adress som helst.
• Ett anrop från en annan adress returnerar "Denna token kan inte användas från denna IP-adress."
• En post som inte är en adress eller ett intervall nekas: "värde är inte en IP-adress eller ett intervall."

Varför en token slutade fungera#

Ovanlig aktivitet#

Clevera övervakar varje token för plötsliga toppar och meddelar arbetsytans ägare med en "Ovanlig aktivitet på token"-notis:

• Många nekade anrop på några minuter: token återkallas. "Den gjorde många nekade anrop på några minuter."
• Ett ovanligt högt antal ändringar på några minuter (fler än 200 skrivningar eller 20 sidborttagningar på 10 minuter): dess skrivningar pausas i 10 minuter. Anrop returnerar "Skrivningar från denna token är pausade efter en ovanlig burst av ändringar. Arbetsytans ägare har meddelats." Läsningar fungerar fortfarande.
• Krediter förbrukade ovanligt snabbt: token kan inte starta betalt arbete på 24 timmar. "Den förbrukade ett ovanligt högt antal krediter på några minuter, så den kan inte starta betalt arbete just nu."

Om arbetsytan lämnar Pro#

AI agents & API ingår i planerna Pro, Business och Custom. Om arbetsytan flyttas till Starter eller Free, visar sidan "AI agents & API ingår i Pro": "Uppgradera för att låta Claude, ChatGPT och dina skript fungera i denna arbetsyta. Befintliga tokens och appar slutar fungera fram till dess; du kan fortfarande återkalla dem här."

• Tokens förblir listade och kan återkallas, men varje anrop nekas med plan_locked.
• Återskapa hemlighet öppnar uppgraderingsdialogen istället.
• Uppgradering tillbaka till Pro gör att tokens fungerar igen. Inget raderas; tokens går fortfarande ut på sina datum.

Relaterat#