Klucze API i bezpieczeństwo
Zakresy, listy dozwolonych adresów IP, dzienne limity wydatków, wygasanie, rotacja bez przestojów i co zrobić, gdy klucz wycieknie.
Na tej stronie
Klucz API może zrobić wszystko, na co pozwalają jego zakresy, płacąc z Twojego salda. Traktuj go jak hasło.
Format klucza
Klucze wyglądają jak sgk_ i 40 liter oraz cyfr. SmsGrab przechowuje tylko odcisk każdego klucza, więc klucz jest pokazywany raz, przy tworzeniu lub rotacji, i nigdy więcej. Na koncie widzisz tylko jego początek i ostatnie cztery znaki.
Ogranicz, co może każdy klucz
Tworząc lub edytując klucz, możesz go ograniczyć:
| Ustawienie | Co robi |
|---|---|
| Zakresy | read dla salda, katalogu, cen, aktywacji i użycia; read i purchase, aby także kupować, anulować i kończyć |
| Lista dozwolonych IP | Do 50 adresów IPv4 lub IPv6 albo zakresów CIDR; żądania z innych adresów są odrzucane |
| Dzienny limit wydatków | Maksymalna kwota, jaką ten klucz może wydać (netto) w ciągu doby UTC; powyżej niej zakupy są odrzucane i nic nie jest pobierane |
| Wygaśnięcie | Opcjonalna data, po której klucz przestaje działać, maksymalnie 2 lata naprzód |
Używaj jednego klucza na aplikację lub serwer, z najmniejszymi potrzebnymi zakresami. Konto może mieć do 10 aktywnych kluczy.
Potwierdzanie wrażliwych zmian
Utworzenie klucza, jego rotacja, dodanie webhooka, wymiana sekretu webhooka i poluzowanie klucza (więcej zakresów, szersza lista IP, wyższy limit lub późniejsze wygaśnięcie) wymagają ponownego podania hasła, a przy włączonej weryfikacji dwuetapowej także jej kodu. Potwierdzenie jest ważne przez 5 minut. Unieważnienie klucza i zaostrzenie limitów nigdy tego nie wymagają.
Rotacja bez przestojów
Rotacja nadaje kluczowi nowy sekret, zachowując jego ustawienia, użycie i webhooki. Wybierasz okres przejściowy do 72 godzin, w którym stary sekret nadal działa, więc możesz zaktualizować serwery bez przerwy.
Unieważnienie
Unieważnienie zatrzymuje klucz natychmiast i na zawsze. Jego webhooki również zostają wyłączone.
Gdy klucz wycieknie
- Unieważnij go albo wykonaj rotację z okresem przejściowym 0 godzin.
- Sprawdź dziennik żądań klucza (ostatnie 7 dni) i Portfel pod kątem nieznanej aktywności.
- Utwórz nowy klucz z listą dozwolonych IP i dziennym limitem wydatków.
Co zapisujemy
Klucze nigdy nie trafiają do żadnych logów. Dla każdego żądania przez 7 dni przechowujemy czas, ścieżkę, status, czas trwania i identyfikator żądania, a Ty widzisz je dla każdego klucza. Tworzenie, rotacja i unieważnianie kluczy pojawiają się też w aktywności konta, a każdy nowy klucz wywołuje powiadomienie.
Nigdy z przeglądarki
API nie przyjmuje wywołań ze stron internetowych (nie ma CORS). Wywołuj je tylko z własnych serwerów.
Czy ten artykuł był pomocny?
Dziękujemy! Cieszymy się, że pomogło.