Klíče API a zabezpečení
Rozsahy, seznamy povolených IP adres, denní limity útraty, platnost, rotace bez výpadku a co dělat, když klíč unikne.
Na této stránce
Klíč API může dělat vše, co mu jeho rozsahy dovolí, a platí přitom z vašeho zůstatku. Zacházejte s ním jako s heslem.
Formát klíče
Klíče vypadají jako sgk_ následované 40 písmeny a číslicemi. SmsGrab ukládá jen otisk každého klíče, takže se klíč zobrazí jednou, při vytvoření nebo rotaci, a pak už nikdy. Ve svém účtu vidíte jen jeho začátek a poslední čtyři znaky.
Omezte, co každý klíč smí
Při vytváření nebo úpravě klíče ho můžete omezit:
| Nastavení | Co dělá |
|---|---|
| Rozsahy | read pro zůstatek, katalog, ceny, aktivace a využití; read a purchase také pro nákup, rušení a dokončování |
| Seznam povolených IP | Až 50 adres IPv4 nebo IPv6 či rozsahů CIDR; požadavky z jiných adres se odmítnou |
| Denní limit útraty | Nejvíc, co smí tento klíč utratit (netto) za den UTC; nad tuto hranici se nákupy odmítají a nic se nestrhne |
| Platnost | Volitelné datum, po kterém klíč přestane fungovat, nejvýše 2 roky dopředu |
Používejte jeden klíč pro každou aplikaci nebo server, s co nejmenšími potřebnými rozsahy. Účet může mít až 10 aktivních klíčů.
Potvrzování citlivých změn
Vytvoření klíče, jeho rotace, přidání webhooku, výměna tajného klíče webhooku a uvolnění klíče (více rozsahů, širší seznam IP, vyšší limit nebo pozdější konec platnosti) vyžadují znovu heslo, a pokud je zapnuté dvoufázové ověření, i jeho kód. Potvrzení platí 5 minut. Zneplatnění klíče a zpřísnění jeho limitů nic takového nevyžadují.
Rotace bez výpadku
Rotace dá klíči nový tajný údaj a zachová jeho nastavení, využití a webhooky. Zvolíte přechodné období až 72 hodin, během kterého starý údaj stále funguje, takže můžete servery aktualizovat bez přerušení.
Zneplatnění
Zneplatnění klíč zastaví okamžitě a natrvalo. Vypnou se i jeho webhooky.
Když klíč unikne
- Zneplatněte ho, nebo proveďte rotaci s přechodným obdobím 0 hodin.
- Zkontrolujte protokol požadavků klíče (posledních 7 dní) a svou Peněženku, jestli v nich není aktivita, kterou nepoznáváte.
- Vytvořte nový klíč se seznamem povolených IP a denním limitem útraty.
Co zaznamenáváme
Klíče se nikdy neobjeví v žádném protokolu. U každého požadavku uchováváme 7 dní čas, cestu, stav, dobu trvání a identifikátor požadavku a vy je vidíte u každého klíče. Vytvoření, rotace a zneplatnění klíčů se objeví i v aktivitě účtu a každý nový klíč vyvolá oznámení.
Nikdy z prohlížeče
API nepřijímá volání z webových stránek (CORS není k dispozici). Volejte ho jen ze svých vlastních serverů.
Pomohl vám tento článek?
Děkujeme! Jsme rádi, že to pomohlo.