Chei API și securitate
Domenii, liste de IP-uri permise, limite zilnice de cheltuieli, expirare, rotire fără întreruperi și ce faci dacă o cheie ajunge publică.
Pe această pagină
O cheie API poate face tot ce îi permit domeniile ei, plătind din soldul tău. Trateaz-o ca pe o parolă.
Formatul cheii
Cheile arată ca sgk_ urmat de 40 de litere și cifre. SmsGrab păstrează doar o amprentă a fiecărei chei, așa că o cheie este afișată o dată, când o creezi sau o rotești, și niciodată după aceea. În cont vezi doar începutul și ultimele patru caractere.
Limitează ce poate face fiecare cheie
Când creezi sau editezi o cheie, o poți restrânge:
| Setare | Ce face |
|---|---|
| Domenii | read pentru sold, catalog, prețuri, activări și utilizare; read și purchase ca să poți și cumpăra, anula și finaliza |
| Listă de IP-uri permise | Până la 50 de adrese IPv4 sau IPv6 ori intervale CIDR; cererile de la alte adrese sunt refuzate |
| Limită zilnică de cheltuieli | Maximul pe care cheia îl poate cheltui (net) într-o zi UTC; peste el, cumpărările sunt refuzate și nu se ia nimic |
| Expirare | O dată opțională după care cheia nu mai funcționează, cel mult cu 2 ani înainte |
Folosește câte o cheie pentru fiecare aplicație sau server, cu cele mai restrânse domenii necesare. Un cont poate avea până la 10 chei active.
Confirmarea schimbărilor sensibile
Crearea unei chei, rotirea ei, adăugarea unui webhook, schimbarea secretului unui webhook și relaxarea unei chei (mai multe domenii, o listă de IP-uri mai largă, o limită mai mare sau o expirare mai târzie) îți cer din nou parola, plus codul verificării în doi pași dacă este activată. Confirmarea rămâne valabilă 5 minute. Revocarea unei chei și restrângerea limitelor nu cer niciodată așa ceva.
Rotire fără întreruperi
Rotirea îi dă cheii un secret nou, păstrându-i setările, utilizarea și webhook-urile. Alegi o perioadă de tranziție de până la 72 de ore în care vechiul secret încă funcționează, ca să-ți actualizezi serverele fără întrerupere.
Revocarea
Revocarea oprește o cheie imediat și definitiv. Webhook-urile ei sunt oprite și ele.
Dacă o cheie a ajuns publică
- Revoc-o sau rotește-o cu o perioadă de tranziție de 0 ore.
- Verifică jurnalul de cereri al cheii (ultimele 7 zile) și Portofelul pentru activitate pe care nu o recunoști.
- Creează o cheie nouă cu listă de IP-uri permise și limită zilnică de cheltuieli.
Ce înregistrăm
Cheile nu apar niciodată în niciun jurnal. Pentru fiecare cerere păstrăm timp de 7 zile ora, ruta, starea, durata și un id al cererii, iar tu le poți vedea pentru fiecare cheie. Crearea, rotirea și revocarea cheilor apar și în activitatea contului, iar fiecare cheie nouă declanșează o notificare.
Niciodată din browser
API-ul nu acceptă apeluri din pagini web (nu există CORS). Apelează-l doar de pe serverele tale.
Ți-a fost util acest articol?
Mulțumim! Ne bucurăm că te-a ajutat.