Tokeny API

Token API pozwala skryptowi lub innemu systemowi pracować z Flowtly w twoim imieniu, bez logowania się przez ekran logowania. Własne tokeny tworzysz i unieważniasz w Profil → Bezpieczeństwo, w sekcji Tokeny API.

Token działa jako ty

Przeczytaj to, zanim przekażesz token komukolwiek lub czemukolwiek.

Token niesie twoją tożsamość i twoje uprawnienia. Wszystko, co możesz zobaczyć i zmienić we Flowtly, może zobaczyć i zmienić także każdy, kto ma twój token, a wszystko, co zostanie nim zrobione, jest zrobione jako ty.

• To nie jest klucz organizacji. Należy do osoby, która go utworzyła, i sięga tam, gdzie sięga ta osoba.
• Nie da się go ograniczyć. Nie ma tokenu tylko do odczytu ani tokenu dla jednego modułu: każdy token ma cały twój dostęp.

Przekazanie tokenu integracji to więc przekazanie jej własnego dostępu. Dawaj go tylko systemowi, któremu powierzyłbyś swoje konto, i twórz go jako osoba, której dostępu integracja naprawdę potrzebuje.

Podłączenie asystenta AI, takiego jak Claude czy ChatGPT, nie wymaga żadnego tokenu: zobacz Podłączanie narzędzi AI (Claude, ChatGPT).

Tworzenie tokenu

1. Otwórz Profil → Bezpieczeństwo i przejdź do Tokeny API.
2. Wpisz Nazwa tokena, która mówi, gdzie token będzie używany, na przykład nazwę integracji. Może mieć do 32 znaków. Bez nazwy token nazywa się „Token API”.
3. Wybierz Generuj token.

Flowtly pokaże wtedy token jeden raz. Wybierz ikonę kopiowania i zapisz go w bezpiecznym miejscu, na przykład w menedżerze haseł albo w magazynie sekretów samej integracji, zanim wybierzesz Gotowe. Flowtly nie przechowuje kopii, którą mógłby pokazać ponownie: po zamknięciu tego okna tokenu nie odzyska ani ty, ani nikt inny. Jeśli go zgubisz, unieważnij go i utwórz nowy.

Jak długo token jest ważny

Token utworzony tutaj jest ważny 365 dni od chwili utworzenia. To domyślny okres ważności, a 730 dni to najdłuższy okres, na jaki Flowtly wydaje token, więc żaden token nie jest ważny bezterminowo. Tokenu nie da się przedłużyć: przed jego wygaśnięciem utwórz nowy, przekaż go integracji, a potem unieważnij stary.

Lista Tokeny API pokazuje każdy twój token z nazwą, datą wygaśnięcia (lub datą, kiedy wygasł) i datą ostatniego użycia. Wygasły token zostaje na liście, dopóki go nie unieważnisz. Token nieużywany od miesięcy to dobry kandydat do unieważnienia.

Unieważnianie tokenu

Wybierz ikonę kosza obok tokenu, aby go unieważnić. Nie ma kroku potwierdzenia.

Unieważnienie działa od razu: już następne żądanie z tym tokenem zostaje odrzucone, zamiast działać aż do daty wygaśnięcia. Unieważnionego tokenu nie da się przywrócić; jeśli jest jeszcze potrzebny, utwórz nowy.

Niektóre zdarzenia zatrzymują twoje tokeny bez ich unieważniania:

• Reset hasła. Po zakończeniu resetu hasła przestają działać wszystkie tokeny utworzone przed nim, razem z innymi twoimi sesjami. Zostają na liście, jakby wciąż były ważne, więc unieważnij je również i utwórz nowe tokeny dla swoich integracji.
• Dezaktywowane konto. Jeśli twoje konto Flowtly zostanie dezaktywowane, wszystkie utworzone przez ciebie tokeny przestaną działać, dopóki konto pozostaje dezaktywowane. Unieważnij je, jeśli nie mogą wrócić.

Nikt inny nie może ich wyświetlić ani unieważnić ze swojego Profil → Bezpieczeństwo.

Przykładowe zastosowania

• Liderka zespołu podłącza do Flowtly skrypt do rejestrowania czasu pracy tokenem nazwanym tak jak skrypt i zapisanym w jego ustawieniach poufnych.
• Konsultant, który wkleił token w niewłaściwe miejsce, od razu go unieważnia, wiedząc, że przestanie działać przy następnym użyciu.
• Administrator ustawia przypomnienie jedenaście miesięcy po utworzeniu tokenu integracji i wymienia go, zanim minie 365 dni.
• Zanim przekaże token zewnętrznemu narzędziu, menedżerka sprawdza, do czego sięga jej własne konto, bo narzędzie sięgnie dokładnie tam samo.