Obmedzenie API na IP adresy

Na čo slúži obmedzenie na IP adresy

Kým je zoznam povolených adries prázdny, prijíma API požiadavky odkiaľkoľvek — portál to oznamuje textom API je dostupné z ľubovoľnej IP adresy. Hneď ako do zoznamu pridáte prvú adresu, začne API obsluhovať len požiadavky prichádzajúce z uvedených adries.

Prístupové údaje tým nijako nezaniknú. Application ID aj API token platia ďalej, len ich nemožno použiť odinakiaľ ako z povolenej adresy.

Kde obmedzenie nastavím

V menu portálu kliknite na Moduly a API
V časti Moje API a Moduly kliknite na kartu svojej aplikácie
Zostaňte na karte Nastavenie a posuňte sa nadol do časti Obmedzenie prístupu k API
Pri dlaždici Povolené IP adresy kliknite na Konfigurovať
Do poľa Zadajte IP adresu vpíšte adresu a kliknite na Pridať

Časť Obmedzenie prístupu k API s dlaždicou Povolené IP adresy

Okno Pridať IP adresu na to rovno upozorňuje hláškou API bude dostupné iba z uvedených IP adries! — obmedzenie je aktívne od uloženia prvej adresy.

Upozornenie

Zadajte adresu, z ktorej API volá vaša aplikácia, nie adresu počítača, na ktorom nastavenie robíte. Portál po uložení neoveruje, či sa z uvedenej adresy niekto naozaj pripojí.

Aké adresy portál prijme

Pravidlo	Správanie
Jedna konkrétna adresa	IPv4 aj IPv6; rozsahy ani zápis s maskou (`/24`) portál neprijme
Len verejné adresy	Lokálne a rezervované rozsahy skončia hláškou `Zadajte verejnú IP adresu, lokálne a rezervované rozsahy nie je možné použiť`
Platný zápis	Nezmyselná hodnota skončí hláškou `Neplatná IP adresa`
Bez duplicít	Adresu, ktorá už v zozname je, druhýkrát nepridáte

Medzi neverejné rozsahy patria aj 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 127.0.0.0/8 a pri IPv6 fc00::/7 alebo fe80::/10. Tlačidlo Pridať zostáva nedostupné, kým zadaná hodnota nevyhovie.

Adresu zapísanú ako IPv4 vnorenú do IPv6 — teda ::ffff:1.2.3.4 alebo 6to4 tvar 2002:… — portál prevedie na zodpovedajúcu IPv4. Počet adries v zozname nie je obmedzený.

Ako zoznam upravím alebo obmedzenie zruším

Po pridaní prvej adresy sa z dlaždice stane zoznam. Tlačidlom Pridať doplníte ďalšiu adresu, ikona koša pri riadku jednu odoberie — zmazanie potvrdíte tlačidlom Zmazať. Šípka vedľa Pridať rozbalí ponuku, ktorou zmažete celý zoznam naraz.

Hneď ako v zozname nezostane žiadna adresa, obmedzenie sa vypne a API je znova dostupné odkiaľkoľvek.

Čo sa stane s požiadavkou z inej adresy

Požiadavka z adresy, ktorá v zozname nie je, skončí odpoveďou s HTTP kódom 401 a typom chyby unknown_identity — rovnakou, akú vracia neplatný token. Prehľad ostatných chýb nájdete na stránke Typy chýb API.

Bola táto stránka užitočná?

Opýtať sa AI Skopírované