Przejdź do treści
Centrum pomocy Clevera

Zarządzaj, generuj ponownie i unieważniaj tokeny API

Znajdź swoje tokeny API, wygeneruj ponownie klucz (jednorazowo, z opcjonalnym 24-godzinnym okresem nakładania się), unieważnij token, zrozum zasady wygasania i listy dozwolonych adresów IP oraz sprawdź, dlaczego token przestał działać.

Zaktualizowano 7 min czytania

Karta Tokeny zawiera listę Twoich tokenów API wraz z informacjami o ich dostępie, limitach i ostatnim użyciu. Z tego miejsca możesz wygenerować ponownie klucz tokena, unieważnić token oraz sprawdzić, dlaczego przestał on działać.

Gdzie znaleźć swoje tokeny

Otwórz menu obszaru roboczego i wybierz AI agents & API. Karta Tokeny jest pierwszą kartą; każda z nich pokazuje swoją liczbę elementów.

Karta Tokeny w AI agents & API, wyświetlająca trzy tokeny API wraz z ich właścicielem, uprawnieniami, stronami i datą wygaśnięcia.
Właściciele i administratorzy widzą każdy token w obszarze roboczym.

Kto widzi poszczególne tokeny:

Twoja rola Widzisz Możesz
Właściciel lub administrator „Każdy token w tym obszarze roboczym. Członkowie widzą własne.” Filtruj według osoby za pomocą menu właściciela (Wszyscy pokazuje wszystkie). Unieważnić dowolny token. Wygenerować ponownie tylko własne.
Redaktor lub Twórca treści „Twoje tokeny. Agenci używający ich działają jako Ty.” Unieważnić i wygenerować ponownie własne tokeny.

Każdy wiersz pokazuje Nazwę (wraz z ostatnimi znakami klucza, np. clv_agent_…k7Qe), Właściciela, Dostęp (jego uprawnienia), Strony, które obejmuje, Utworzono, Ostatnio używane oraz Wygasa. Stopka zlicza aktywne tokeny w obszarze roboczym w odniesieniu do jego limitu. Odznaki w wierszu:

Odznaka Znaczenie
Wydaje kredyty Token posiada credits:spend. Wskaż go, aby zobaczyć limity: Na zadanie, Dziennie, Miesięcznie („brak limitu”, gdy puste) oraz „Zatwierdzane automatycznie poniżej n kredytów” lub „Osoba zatwierdza każde płatne uruchomienie”.
Ograniczone IP Token posiada listę dozwolonych adresów IP i działa tylko z tych adresów.
Przekracza uprawnienia roli „Rola właściciela uległa zmianie. Wywołania wymagające przekreślonych uprawnień są odrzucane.”
Unieważniono / Wygasło Token już nie działa. Powód jest wyświetlany obok (zobacz Dlaczego token przestał działać).

Unieważnione i wygasłe tokeny są domyślnie ukryte. Kliknij Pokaż unieważnione i wygasłe (liczba), aby je wyświetlić; pozostają one na liście przez 30 dni.

Zmień dostęp tokena

Uprawnień, stron, daty wygaśnięcia, limitów wydatków oraz listy dozwolonych adresów IP tokena nie można edytować po jego utworzeniu. Aby zmienić którykolwiek z nich, utwórz nowy token z nowymi ustawieniami, przełącz swojego agenta, a następnie unieważnij stary.

Wygeneruj ponownie klucz tokena

Wygeneruj ponownie, jeśli klucz mógł wyciec lub aby rotować go zgodnie z harmonogramem. Nowy klucz ma tę samą nazwę, dostęp, strony, listę dozwolonych adresów IP, limity wydatków i datę wygaśnięcia.

  1. Otwórz menu tokena

    Na karcie Tokeny otwórz menu ⋯ w wierszu tokena i wybierz Wygeneruj ponownie klucz.

  2. Wybierz, kiedy stary klucz przestanie działać

    Okno dialogowe pyta „Wygenerować ponownie „nazwa”?”: „Otrzymasz nowy klucz z tym samym dostępem. Stary przestanie działać.” Zaznacz Utrzymaj działanie starego klucza przez 24 godziny, jeśli agenci nadal go używają i potrzebujesz czasu na ich przełączenie. Pozostaw niezaznaczone, aby natychmiast zatrzymać stary klucz.

  3. Skopiuj nowy klucz

    Kliknij Wygeneruj ponownie. Okno dialogowe Token utworzony pokazuje nowy klucz tylko raz. Skopiuj go, zaktualizuj swojego agenta lub magazyn kluczy, a następnie kliknij Zapisano.

Zasady ponownego generowania:

  • Tylko osoba, która utworzyła token, może go wygenerować ponownie. Właściciel lub administrator, który go nie utworzył, widzi komunikat „Tylko osoba, która utworzyła ten token, może go wygenerować ponownie. Możesz go unieważnić.”
  • Klucz można wygenerować ponownie tylko raz. Po tym fakcie stary wiersz pokazuje „Zastąpiony przez wygenerowany ponownie klucz” i nie posiada opcji Wygeneruj ponownie klucz; zamiast tego wygeneruj ponownie nowy token. Ponowna próba na starym kluczu zwraca komunikat „Ten token został już wygenerowany ponownie, unieważniony lub wygasł; użyj jego zamiennika lub utwórz nowy.”
  • Data wygaśnięcia nie ulega zmianie. Token utworzony na 90 dni nadal wygasa w pierwotnym terminie. Jeśli 24-godzinny okres starego klucza miałby wykraczać poza tę datę, przestaje on działać w dniu wygaśnięcia.
  • Możesz generować ponownie nawet wtedy, gdy obszar roboczy osiągnął limit aktywnych tokenów. Podczas 24-godzinnego okresu nakładania się oba klucze działają i oba są liczone jako aktywne tokeny.
  • Ponowne generowanie wymaga, aby obszar roboczy posiadał plan Pro lub wyższy; w przeciwnym razie Wygeneruj ponownie klucz otwiera okno dialogowe aktualizacji planu.

Unieważnij token

  1. Otwórz menu ⋯ w wierszu tokena i wybierz Unieważnij.
  2. Potwierdź za pomocą Unieważnij token: „Agenci używający tego tokena natychmiast tracą dostęp. Tego nie można cofnąć.”

Unieważniony token natychmiast zwalnia swoje miejsce w limicie aktywnych tokenów obszaru roboczego.

Wygasanie

Każdy token wygasa. Wybierasz okres ważności podczas tworzenia: 7 dni, 30 dni, 90 dni (domyślnie) lub 1 rok. Nie ma opcji „nigdy nie wygasa”, więc zapomniany token nie może pozostać ważny na zawsze. Kolumna Wygasa pokazuje datę.

Po dacie wygaśnięcia każde wywołanie zwraca komunikat „Ten token wygasł. Utwórz nowy w Integrations → AI agents & API.” Wygasłego tokena nie można odnowić ani wygenerować ponownie; utwórz nowy.

Lista dozwolonych adresów IP

Token może być ograniczony do adresów, z których działa Twój agent (na przykład runner CI lub serwer). Ustawiasz to w kroku Limity kreatora w sekcji Zaawansowane → Lista dozwolonych adresów IP: „Opcjonalne. Jeden adres lub zakres w linii; wywołania z dowolnego innego miejsca są odrzucane.”

  • Wprowadź adresy IPv4 lub IPv6 (203.0.113.7) albo zakresy w formacie CIDR (198.51.100.0/24), maksymalnie 20 wpisów.
  • Pozostaw puste, aby zezwolić na dowolny adres. Krok przeglądu pokaże wtedy Dowolny adres.
  • Wywołanie z innego adresu zwraca komunikat „Tego tokena nie można używać z tego adresu IP.”
  • Wpis, który nie jest adresem lub zakresem, jest odrzucany: „wartość nie jest adresem IP ani zakresem.”

Dlaczego token przestał działać

Wyświetlane przy tokenie Co się stało Co zrobić
Wygasło Jego okres ważności minął. Utwórz nowy token.
„Unieważniony przez właściciela” Osoba, która go utworzyła, unieważniła go. Utwórz nowy token, jeśli jest nadal potrzebny.
„Unieważniony przez administratora” Właściciel obszaru roboczego lub administrator unieważnił go. Zapytaj ich o powód przed utworzeniem nowego.
„Unieważniono: właściciel opuścił obszar roboczy” Osoba, która go utworzyła, została usunięta z obszaru roboczego. Wszystkie jej tokeny są unieważnione. Ktoś, kto nadal jest w obszarze roboczym, tworzy nowy token.
„Unieważniono: konto właściciela zostało usunięte” Właściciel usunął swoje konto Clevera. Utwórz nowy token.
„Zastąpiony przez wygenerowany ponownie klucz” Klucz został wygenerowany ponownie. Użyj nowego klucza.
„Unieważniono: znaleziono w publicznym repozytorium” Token został znaleziony w publicznym repozytorium GitHub i automatycznie unieważniony. Usuń go z historii repozytorium, a następnie utwórz nowy token i przechowuj go w magazynie kluczy.
„Unieważniono: nietypowa aktywność” Wykonał wiele odrzuconych żądań w ciągu kilku minut (ponad 50 w 10 minut). Sprawdź aktywność, aby zobaczyć, co próbował zrobić, napraw agenta, a następnie utwórz nowy token.
„Unieważniono: wykryto ponowne użycie tokena” / „Unieważniono: aplikacja rozłączona” Dotyczy to połączonych aplikacji, a nie tokenów API. Połącz aplikację ponownie.
Każde wywołanie zwraca „Agent API nie jest dostępny w planie tego obszaru roboczego. Jest dostępny w planie Pro i wyższych.” Obszar roboczy przestał korzystać z planu Pro, Business lub Custom. Przejdź na plan Pro. Zobacz Jeśli obszar roboczy opuszcza plan Pro.

Nietypowa aktywność

Clevera monitoruje każdy token pod kątem nagłych skoków aktywności i powiadamia właściciela obszaru roboczego powiadomieniem „Nietypowa aktywność tokena token”:

  • Wiele odrzuconych żądań w ciągu kilku minut: token zostaje unieważniony. „Wykonał wiele odrzuconych żądań w ciągu kilku minut.”
  • Nietypowo duża liczba zmian w ciągu kilku minut (ponad 200 zapisów lub 20 usunięć stron w 10 minut): jego zapisy są wstrzymywane na 10 minut. Wywołania zwracają komunikat „Zapisy z tego tokena są wstrzymane po nietypowym skoku zmian. Właściciel obszaru roboczego został powiadomiony.” Odczyty nadal działają.
  • Kredyty wydane nietypowo szybko: token nie może rozpocząć płatnej pracy przez 24 godziny. „Wydano nietypowo dużą liczbę kredytów w ciągu kilku minut, więc na razie nie może rozpocząć płatnej pracy.”

Jeśli obszar roboczy opuszcza plan Pro

AI agents & API jest dostępne w planach Pro, Business i Custom. Jeśli obszar roboczy przejdzie na plan Starter lub Free, strona wyświetli komunikat „AI agents & API są zawarte w planie Pro”: „Przejdź na wyższy plan, aby Claude, ChatGPT i Twoje skrypty działały w tym obszarze roboczym. Istniejące tokeny i aplikacje przestają działać do tego czasu; nadal możesz je tutaj unieważnić.”

  • Tokeny pozostają na liście i można je unieważnić, ale każde wywołanie jest odrzucane z plan_locked.
  • Wygeneruj ponownie klucz otwiera zamiast tego okno dialogowe aktualizacji planu.
  • Powrót do planu Pro sprawia, że tokeny znów działają. Nic nie jest usuwane; tokeny nadal wygasają w swoich terminach.
Utwórz token APICzterostopniowy kreator.Odczytaj aktywność agentaCo zrobił każdy token.Uprawnienia agentaNa co pozwala każde uprawnienie.Napraw błędy agenta i APIKażde odrzucenie i co z nim zrobić.