Osobiste tokeny dostępu
Osobisty token dostępu (nazywany też kluczem API) daje twoim własnym narzędziom dostęp do danych w Kombine przez API. Takim narzędziem może być skrypt, alias w powłoce, agent AI w rodzaju Claude Code albo importer z Jiry. Ty decydujesz, do czego token ma dostęp i jak długo działa. W każdej chwili możesz go unieważnić.
Tokeny są dla twoich własnych narzędzi. Nie wklejaj ich do usług zewnętrznych, nad którymi nie masz kontroli.
Utwórz token
Dział zatytułowany „Utwórz token”Tokeny tworzysz w aplikacji webowej. Potrzebujesz konta ze zweryfikowanym adresem e-mail.
- Na app.kombine.dev przejdź do Ustawienia › Konto i znajdź sekcję Osobiste tokeny dostępu.
- Kliknij Nowy token.
- Wpisz Nazwę (do czego służy token, np. „Import z Jiry”) i opcjonalnie Opis.
- Wybierz, kiedy token Wygasa: za 7, 30, 90 lub 365 dni. Domyślnie jest to 30 dni. Każdy token kiedyś wygasa.
- Ustaw Uprawnienia (opis poniżej). Daj tylko te, których narzędzie potrzebuje.
- Wpisz swoje Obecne hasło i kliknij Utwórz token.
- Skopiuj token od razu. Zaczyna się od
kmb_pat_i zobaczysz go tylko raz. Kombine przechowuje jedynie jego odcisk, więc nie może pokazać go ponownie. Zgubiłeś token? Unieważnij go i utwórz nowy.
Możesz mieć maksymalnie 10 aktywnych tokenów.
Uprawnienia
Dział zatytułowany „Uprawnienia”Token dostaje jeden poziom dostępu dla każdego obszaru: Brak, Odczyt albo Odczyt i zapis. Token, który ma wszędzie ustawione Brak, nie może nic zrobić.
| Obszar | Co obejmuje | Poziomy |
|---|---|---|
| tasks | Zadania, także zaimportowane | Odczyt / Odczyt i zapis |
| goals | Cele dla każdego okresu i notatki okresów | Odczyt / Odczyt i zapis |
| sessions | Sesje skupienia, wpisy w dzienniku i aktywności | Odczyt / Odczyt i zapis |
| timer | Działający timer i jego ustawienia | Odczyt / Odczyt i zapis |
| stats | Statystyki i podsumowania dnia | Odczyt |
Niektóre rzeczy są zawsze poza zasięgiem tokena, niezależnie od jego uprawnień: logowanie, twoje hasło i konto, urządzenia, ustawienia aplikacji i synchronizacja. Token nie może zmienić twojego hasła ani usunąć konta.
Odczyt obszaru to każde żądanie GET. Wszystko inne (tworzenie, zmiana, usuwanie) wymaga uprawnienia Odczyt i zapis.
Przeglądaj i unieważniaj tokeny
Dział zatytułowany „Przeglądaj i unieważniaj tokeny”Przejdź do Ustawienia › Konto › Osobiste tokeny dostępu, żeby zobaczyć swoje tokeny i Unieważnić wybrany. W aplikacji mobilnej nie da się tworzyć tokenów. Do tego służy aplikacja webowa.
Przejdź do Ustawienia › Konto › Osobiste tokeny dostępu, żeby zobaczyć swoje tokeny i Unieważnić wybrany. W aplikacji mobilnej nie da się tworzyć tokenów. Do tego służy aplikacja webowa.
W Ustawienia › Konto › Osobiste tokeny dostępu widzisz wszystkie tokeny razem z ich uprawnieniami oraz datami wygaśnięcia, utworzenia i ostatniego użycia. Kliknij Unieważnij przy wybranym tokenie albo Unieważnij wszystkie.
Unieważnienie działa od razu: kolejne żądanie z tym tokenem się nie powiedzie.
Wylogowanie, wylogowanie ze wszystkich urządzeń oraz zmiana lub reset hasła nie unieważniają tokenów. Robi to tylko ręczne unieważnienie, wygaśnięcie tokena albo usunięcie konta. Jeśli podejrzewasz, że token wyciekł, unieważnij go.
Dbaj o bezpieczeństwo tokenów
Dział zatytułowany „Dbaj o bezpieczeństwo tokenów”- Traktuj token jak hasło. Trzymaj go w zmiennej środowiskowej albo w menedżerze haseł, nigdy w kodzie, który commitujesz.
- Jeden token na jedno narzędzie. Wtedy unieważnienie jednego nie psuje pozostałych, a ostatnie użycie pokazuje, które narzędzie jest aktywne.
- Krótki termin ważności do eksperymentów, dłuższy do narzędzi, na których polegasz.