Omezení API na IP adresy

K čemu omezení na IP adresy slouží

Dokud je seznam povolených adres prázdný, přijímá API požadavky odkudkoli — portál to hlásí textem API je dostupné z libovolné IP adresy. Jakmile do seznamu přidáte první adresu, začne API obsluhovat jen požadavky přicházející z uvedených adres.

Přístupové údaje tím nijak nezaniknou. Application ID i API token platí dál, jen je nelze použít odjinud než z povolené adresy.

Kde omezení nastavím

V menu portálu klikněte na Moduly a API
V části Moje API a Moduly klikněte na kartu své aplikace
Zůstaňte na kartě Nastavení a sjeďte do části Omezení přístupu k API
U dlaždice Povolené IP adresy klikněte na Konfigurovat
Do pole Zadejte IP adresu vepište adresu a klikněte na Přidat

Část Omezení přístupu k API s dlaždicí Povolené IP adresy

Okno Přidat IP adresu na to rovnou upozorňuje hláškou API bude dostupné pouze z uvedených IP adres! — omezení je aktivní od uložení první adresy.

Upozornění

Zadejte adresu, ze které na API volá vaše aplikace, ne adresu počítače, na kterém nastavení provádíte. Portál po uložení neověřuje, jestli se z uvedené adresy někdo skutečně připojí.

Jaké adresy portál přijme

Pravidlo	Chování
Jedna konkrétní adresa	IPv4 i IPv6; rozsahy ani zápis s maskou (`/24`) portál nepřijme
Jen veřejné adresy	Lokální a rezervované rozsahy skončí hláškou `Zadejte veřejnou IP adresu, lokální a rezervované rozsahy nelze použít`
Platný zápis	Nesmyslná hodnota skončí hláškou `Neplatná IP adresa`
Bez duplicit	Adresu, která už v seznamu je, podruhé nepřidáte

Mezi neveřejné rozsahy patří i 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 127.0.0.0/8 a u IPv6 fc00::/7 nebo fe80::/10. Tlačítko Přidat zůstává nedostupné, dokud zadaná hodnota nevyhoví.

Adresu zapsanou jako IPv4 vnořenou do IPv6 — tedy ::ffff:1.2.3.4 nebo 6to4 tvar 2002:… — portál převede na odpovídající IPv4. Počet adres v seznamu omezený není.

Jak seznam upravím nebo omezení zruším

Po přidání první adresy se z dlaždice stane seznam. Tlačítkem Přidat doplníte další adresu, ikona koše u řádku jednu odebere — smazání potvrdíte tlačítkem Smazat. Šipka vedle Přidat rozbalí nabídku, kterou smažete celý seznam najednou.

Jakmile v seznamu nezůstane žádná adresa, omezení se vypne a API je znovu dostupné odkudkoli.

Co se stane s požadavkem z jiné adresy

Požadavek z adresy, která v seznamu není, skončí odpovědí s HTTP kódem 401 a typem chyby unknown_identity — stejnou, jakou vrací neplatný token. Přehled ostatních chyb najdete na stránce Typy errorů API.

Byla tato stránka užitečná?

Zeptat se AI Zkopírováno