Wybierz język

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
  1. Format klucza
  2. Ogranicz, co może każdy klucz
  3. Potwierdzanie wrażliwych zmian
  4. Rotacja bez przestojów
  5. Unieważnienie
  6. Gdy klucz wycieknie
  7. Co zapisujemy
  8. Nigdy z przeglądarki

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

  1. Unieważnij go albo wykonaj rotację z okresem przejściowym 0 godzin.
  2. Sprawdź dziennik żądań klucza (ostatnie 7 dni) i Portfel pod kątem nieznanej aktywności.
  3. 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?

Nadal potrzebujesz pomocy?

Napisz do nas. Odpowiadamy na każdą wiadomość, zwykle w ciągu kilku godzin.

Albo napisz na adres support@smsgrab.com