## 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](https://www.bulkgate.com/no/dokumentasjon/api-administrasjon/administrasjon-av-api/) og
[API-tokenet](https://www.bulkgate.com/no/dokumentasjon/api-administrasjon/api-token/) forblir gyldige, de kan bare ikke brukes fra
noe annet sted enn en tillatt adresse.

## Hvor du angir begrensningen

1. Klikk på `Moduler og APIer` i portalmenyen
2. Under `Mine APIer og moduler` klikker du på kortet for applikasjonen din
3. Bli stående på fanen `Innstillinger` og bla ned til delen `API access restrictions`
4. På kortet `Allowed IP addresses` klikker du på `Konfigurer`
5. Skriv adressen inn i feltet `Enter the IP address` og klikk på `Legg til`

![Delen API access restrictions med kortet Allowed IP addresses](docs:api-ip-restrictions/allowed-ip_en)

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.

> [!WARNING]
> 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](https://www.bulkgate.com/no/dokumentasjon/api-administrasjon/api-feiltyper/).