IP-begrensninger for API
Hva IP-begrensningen er til for
Så lenge listen over tillatte adresser er tom, godtar API-et forespørsler fra
hvor som helst — portalen opplyser om det med teksten The API is accessible from any IP address. Så snart du legger den første adressen til i listen, begynner API-et
bare å betjene forespørsler som kommer fra adressene i listen.
Ingen av tilgangsopplysningene dine utløper på grunn av dette. Både Application ID og API-tokenet forblir gyldige, de kan bare ikke brukes fra noe annet sted enn en tillatt adresse.
Hvor du angir begrensningen
- Klikk på
Moduler og APIeri portalmenyen - Under
Mine APIer og modulerklikker du på kortet for applikasjonen din - Bli stående på fanen
Innstillingerog bla ned til delenAPI access restrictions - På kortet
Allowed IP addressesklikker du påKonfigurer - Skriv adressen inn i feltet
Enter the IP addressog klikk påLegg til
Vinduet Add IP address gjør deg oppmerksom på dette med en gang med meldingen The API will only be accessible from the listed IP addresses! — begrensningen trer i kraft
så snart den første adressen er lagret.
Skriv inn adressen som applikasjonen din kaller API-et fra, ikke adressen til datamaskinen du gjør innstillingene på. Etter lagring kontrollerer ikke portalen at noen faktisk kobler til fra adressen du har skrevet inn.
Hvilke adresser portalen godtar
| Regel | Virkemåte |
|---|---|
| Én bestemt adresse | Både IPv4 og IPv6; områder og maskenotasjon (/24) godtas ikke |
| Bare offentlige adresser | Lokale og reserverte områder ender med meldingen Enter a public IP address, local and reserved ranges cannot be used |
| Gyldig skrivemåte | En meningsløs verdi ender med meldingen Invalid IP address |
| Ingen duplikater | En adresse som allerede står i listen, kan ikke legges til to ganger |
Til de ikke-offentlige områdene hører 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16,
127.0.0.0/8 og, for IPv6, fc00::/7 eller fe80::/10. Knappen Legg til forblir
deaktivert til verdien du har skrevet inn, er godkjent.
En adresse skrevet som IPv4 innebygd i IPv6 — altså ::ffff:1.2.3.4 eller
6to4-formen 2002:… — konverteres av portalen til tilsvarende IPv4. Antall
adresser i listen er ikke begrenset.
Slik redigerer du listen eller fjerner begrensningen
Når den første adressen er lagt til, blir kortet til en liste. Knappen Legg til
legger til en ny adresse, og søppelbøtteikonet på en rad fjerner en — du bekrefter
fjerningen med knappen Slett. Pilen ved siden av Legg til åpner en meny som
tømmer hele listen på én gang.
Så snart det ikke er noen adresse igjen i listen, slås begrensningen av, og API-et kan nås fra hvor som helst igjen.
Hva som skjer med en forespørsel fra en annen adresse
En forespørsel fra en adresse som ikke står i listen, ender med et svar med HTTP-kode
401 og feiltypen unknown_identity — den samme som et ugyldig token
returnerer. De øvrige feilene er oppført på siden
API-feiltyper.
Takk for tilbakemeldingen.