InnerWeb
Przejdź do treści

Tokeny maszynowe integracji: zalecenia dla administratora

Token maszynowy integracji z portalem kwalifikacji jest kluczem do wyszukiwania osób, a przy włączonej rejestracji z plakatu QR także do zakładania kont, firm i wydawania przepustek. Taki klucz zasługuje na własną politykę: właściciela, zakres, rotację i monitoring. Poniżej zalecenia dla administratora IT.

3
minimalna liczba znaków zapytania wyszukującego
Źródło: karta
8
najwyższa liczba pozycji w odpowiedzi wyszukiwania
Źródło: karta

Dlaczego token maszynowy wymaga osobnej uwagi

API dla portalu kwalifikacji wymaga tokenu maszynowego w nagłówku. Brak lub zły token daje odpowiedź 401, a zapytania wyszukujące wymagają co najmniej 3 liter lub cyfr i zwracają najwyżej 8 pozycji. Te ograniczenia utrudniają przeglądanie całej bazy osób, ale nie zastępują ochrony samego klucza.

Token nie reprezentuje człowieka, więc nie ma drugiego składnika ani ekranu logowania. Kto go posiada, korzysta z uprawnień integracji. Dlatego ocena ryzyka dla tokenu jest ostrzejsza niż dla zwykłego konta.

Zalecenie 1: policz promień rażenia

Gdy włączona jest rejestracja z plakatu QR, ten sam token maszynowy zakłada konta, firmy i wydaje przepustki. Przed włączeniem tej funkcji zapisz, co token potrafi zrobić w najgorszym scenariuszu: ile kont można założyć, jakie przepustki wydać, jakie dane odczytać.

Wynik wpisz do rejestru ryzyka IT zakładu. Jeżeli zakład nie potrzebuje rejestracji z plakatu, nie włączaj jej tylko dlatego, że jest dostępna: mniejsza funkcja to mniejszy promień rażenia.

Limity zapytania wyszukującego osoby

Limity zapytania wyszukującego osobyWykres: minimum 3 znaki zapytania i maksimum 8 pozycji w odpowiedzi02468liczbaMinimum znaków zapytaniaMinimum znaków zapytania: 3 liczba3Maksimum pozycji w odpowiedziMaksimum pozycji w odpowiedzi: 8 liczba8
Źródło: Karta komórki: opis API dla portalu kwalifikacji

Zalecenie 2: przechowuj klucz poza przeglądarką i repozytorium

System stosuje zasadę, że klucze integracji nigdy nie wychodzą do przeglądarki. Panel SSO pokazuje ustawienia tylko do odczytu, a akceptacja, odrzucenie i ponowienie decyzji o wniosku jest ograniczone do jednej roli administracyjnej. Po stronie zakładu zastosuj tę samą zasadę: klucz w menedżerze sekretów, nie w skrypcie, wiadomości ani dokumencie projektu.

  • Jeden właściciel tokenu z imienia i zastępca.
  • Przechowywanie w menedżerze sekretów, dostęp według roli.
  • Zakaz przesyłania tokenu pocztą i komunikatorem.
  • Rotacja według kalendarza i po każdej zmianie osoby z dostępem.

Zalecenie 3: rozdziel role akceptacji wniosków

Decyzje o wnioskach o dostęp podejmuje jedna rola administracyjna. Przypisz do niej małą, nazwaną grupę osób i przejrzyj ją co kwartał. Rozdzielenie osoby, która zarządza tokenem, od osoby, która akceptuje wnioski, zmniejsza ryzyko, że jedno konto kontroluje cały łańcuch.

Zalecenie 4: monitoruj dziennik wymiany

Dziennik wymiany z portalem zapisuje kierunek, zdarzenie, osobę, wynik, kod HTTP i czas, a zapis do dziennika nigdy nie przerywa operacji głównej. Dzięki temu możesz wykryć serię odpowiedzi 401, nietypowe godziny wywołań lub nagły wzrost liczby wyszukiwań.

Ustal progi alarmowe w swoim narzędziu monitoringu i sprawdzaj dziennik po każdej rotacji tokenu. Prawidłowy obraz po rotacji to krótka seria 401 od starego klucza, a potem stabilna seria sukcesów.

Zalecenie 5: zaplanuj rotację bez przerwy w usłudze

Rotację zaplanuj poza szczytem wejść wykonawców. Uzgodnij z administratorem portalu moment zamiany klucza i procedurę wycofania. Po rotacji wykonaj test: wyszukanie osoby, zgłoszenie wniosku i odczyt dziennika.

Zmianę klucza i jej termin zapisz w rejestrze zmian. W razie podejrzenia wycieku wymień klucz natychmiast, a zdarzenie opisz w dzienniku incydentów zakładu.

Materiał wideo

Często zadawane pytania

Co zwraca API przy złym tokenie?

Odpowiedź 401. Taki wpis pojawia się w dzienniku wymiany z kodem HTTP, kierunkiem i czasem.

Czy klucz integracji można zobaczyć w panelu?

Nie. Klucze nie wychodzą do przeglądarki, a panel SSO pokazuje ustawienia tylko do odczytu.

Kto może zaakceptować wniosek o dostęp?

Akceptację, odrzucenie i ponowienie decyzji wykonuje jedna rola administracyjna, którą zakład przypisuje wybranym osobom.

Uporządkujmy klucze integracji

Razem z Waszym IT spiszemy zakres tokenu, właściciela i plan rotacji, zanim integracja ruszy na produkcji.

Porozmawiajmy