Klucze API w organizacji

Administratorzy organizacji zarządzają osobistymi kluczami API swojej organizacji na stronie Klucze API w sekcji Organizacja w Ustawieniach. Strona nosi tytuł Klucze API organizacji i zawsze dotyczy organizacji, w której aktualnie pracujesz. Uprawnienia administracyjne jej nie otwierają; jest dostępna tylko dla osób z rolą Administrator organizacji.

O tym, kto może tworzyć klucze, decyduje rola Klucze API na stronie Osoby (zobacz Role). Rola obowiązuje w każdej organizacji, do której należy dana osoba; administratorzy każdej organizacji widzą i unieważniają klucze swojej organizacji.

Miesięczny limit dla kluczy LiteLLM#

W sekcji Klucze LiteLLM ustalasz Miesięczny limit na osobę w euro, czyli ile każda osoba może wykorzystać swoimi kluczami LiteLLM w miesiącu. Dopóki limit nie jest ustalony, nikt w organizacji nie może tworzyć kluczy LiteLLM, a strona o tym informuje: „Nie ustalono jeszcze limitu. Do tego czasu nikt w organizacji … nie może tworzyć kluczy LiteLLM.”

• Limit dotyczy każdej osoby: obejmuje łącznie wszystkie klucze LiteLLM danej osoby w organizacji, także klucze unieważnione lub wygasłe w tym samym miesiącu. Osoba z dwoma kluczami LiteLLM nie może wykorzystać więcej niż osoba z jednym.
• LiteLLM sam pilnuje limitu i na początku każdego miesiąca liczy go od nowa. Gdy klucze danej osoby wyczerpią limit, LiteLLM odrzuca jej zapytania do tego czasu.
• Nowy limit od razu dotyczy każdej osoby.
• Kwota musi być większa niż 0, mieć najwyżej dwa miejsca po przecinku i wynosić najwyżej 1 000 000 €.
• Usuń limit najpierw prosi o potwierdzenie. Potem nikt w organizacji nie może tworzyć nowych kluczy LiteLLM. Dla istniejących kluczy nadal obowiązuje dotychczasowy limit; aby je od razu zatrzymać, unieważnij je.
• Wykorzystanie kluczy pojawia się na stronie Zużycie pod nazwiskiem osoby, do której należy klucz.

Wszystkie klucze organizacji#

Aktywne klucze wymienia wszystkie aktywne klucze organizacji, pogrupowane według osób, z imieniem i nazwiskiem oraz adresem e-mail. Przy każdym kluczu widać te same dane co na stronie osobistej: typ, początek klucza, dostęp lub wykorzystanie oraz daty. Wygasłe i unieważnione klucze nie są wyświetlane. Same klucze nigdy nie są pokazywane, także administratorom.

Unieważnianie kluczy innych osób#

Programy używające tego klucza natychmiast tracą dostęp. Dopóki osoba ma rolę Klucze API, może utworzyć nowy klucz. Jeśli ktoś w ogóle nie powinien używać kluczy, odbierz mu tę rolę. Od razu unieważnia to wszystkie jego klucze we wszystkich organizacjach, do których należy, ponieważ rola obowiązuje we wszystkich. Ponowne nadanie roli nie przywraca starych kluczy.

Tworzenie i unieważnianie kluczy oraz zmiany miesięcznego limitu są zapisywane w Dzienniku audytu w obszarze Administracja jako „Utworzono klucz API”, „Unieważniono klucz API” i „Zmieniono limit kluczy LiteLLM” (kody działań API_KEY_CREATED, API_KEY_REVOKED i API_KEY_LIMIT_CHANGED). Klucze, które przestają obowiązywać z powodu działania na koncie, odebrania roli lub utraty dostępu, również są zapisywane jako „Unieważniono klucz API”. Szczegóły zdarzenia podają, kto unieważnił klucz (revokedBy): administrator albo system, jeśli AITEZA unieważniła go automatycznie.

Zapytania, które AITEZA odrzuca dla znanego klucza, np. funkcja administracyjna, inna organizacja albo zmiana kluczem z dostępem Odczyt, są zapisywane w obszarze Inne jako „Odmowa dostępu” (kod działania ACCESS_DENIED), z identyfikatorem i nazwą klucza (apiKey i apiKeyName). Dzięki temu nadużycie skradzionego klucza jest widoczne.