Bezpieczeństwo kluczy

• Klucz to hasło do konta sprzedawcy. Trzymaj go w zmiennych środowiska albo menedżerze sekretów — nigdy w kodzie, repozytorium, aplikacji mobilnej ani przeglądarce.
• Najmniejsze uprawnienia: osobny klucz na zastosowanie (np. „Oferty i magazyn” dla ERP, „Obsługa klienta” dla helpdesku).
• Lista IP: ogranicz klucz do adresów swoich serwerów (do 20 wpisów, IPv4/IPv6, CIDR). Żądanie spoza listy dostaje 401 i trafia do zdarzeń bezpieczeństwa.
• Termin ważności i rotacja: wybierz ważność (30–365 dni albo bez terminu). Rotacja wydaje nowy klucz, a stary działa jeszcze przez wybrane okno (0, 1 h, 24 h, 7 dni) — bez przestoju.
• Monitoring: w panelu (Klucze API) widzisz dla każdego klucza liczbę żądań, błędy, trasy, adresy IP i ostatnie żądania (zamaskowane).
• Kwarantanna: nietypowe użycie (np. seria prób odczytu cudzych danych, burza błędów 401/403) przełącza klucz w tryb „tylko odczyt” albo wstrzymuje go (403 KEY_QUARANTINED / KEY_SUSPENDED). Zdejmujesz ją w panelu po sprawdzeniu.

Wyciek klucza

Klucze allee mają rozpoznawalny przedrostek i sumę kontrolną (allee_sk_live_, allee_sk_test_, allee_at_, allee_rt_, allee_cs_) — skanery sekretów (GitHub secret scanning, gitleaks) wykrywają je w kodzie. Klucz znaleziony publicznie unieważniamy automatycznie i powiadamiamy sprzedawcę (POST /security/leak-report). Sam zauważysz wyciek? Kliknij w panelu „Unieważnij” i utwórz nowy klucz.

Po stronie API

Sekrety przechowujemy tylko jako skróty (klucze: HMAC-SHA256 z pieprzem), nigdy w dziennikach. Tokeny OAuth rotują się przy każdym odświeżeniu, a ponowne użycie starego refresh tokenu odcina całą rodzinę. Każde żądanie ma X-Request-Id — podaj go, gdy zgłaszasz problem.