Yleiskatsaus

IP-sallintalista on valinnainen suojausominaisuus, jolla voit rajoittaa, mistä IP-osoitteista OpenAI-rajapintaasi voi käyttää.

Kun ominaisuus on käytössä, vain määritetyistä IP-osoitteista tai IP-osoitealueilta tulevat pyynnöt sallitaan. Kaikista muista IP-osoitteista tulevat pyynnöt hylätään, vaikka ne sisältäisivät kelvollisen API-avaimen.

Ominaisuuden tarkoituksena on vähentää rajapinnan luvattoman käytön riskiä rajaamalla käyttö luotettuihin verkkoympäristöihin.

Huomautus: IP-sallintalista koskee vain API-pyyntöjä. Se ei vaikuta platform.openai.com-sivuston käyttöön tai käyttäjien kirjautumiseen.

Miksi IP-sallintalistaa kannattaa käyttää

IP-sallintalista voi auttaa sinua:

• Rajaamaan rajapinnan käytön tunnettuun infrastruktuuriin (esimerkiksi omiin palvelimiisi tai pilviympäristöihisi)

• Vähentämään riskejä, jos API-avain vuotaa

• Hallitsemaan entistä tarkemmin, mistä API-liikenne tulee

IP-sallintalistaa käytetään yleisimmin tuotantoympäristöissä, joissa API-liikenne tulee kiinteiltä tai tarkasti määritetyiltä verkko-osoitealueilta.

Toimintaperiaate

Määrität luettelon sallituista IP-osoitteista tai CIDR-osoitealueista.

• Sallituista IP-osoitteista tulevat pyynnöt hyväksytään.

• Pyynnöt hylätään, jos niiden IP-osoite ei ole sallintalistalla.

IP-sallintalistaa voi käyttää:

• organisaatiotasolla tai

• projektitasolla

Saatavuus

IP-sallintalista on kaikkien API-asiakkaiden käytettävissä.

Määritä IP-sallintalista seuraavien ohjeiden mukaisesti.

Määritä IP-sallintalista

Huomautus: Voit lisätä enintään 50 IP-osoitetta tai CIDR-osoitealuetta.

1. Avaa Asetukset.

2. Valitse Suojaus.

3. Valitse IP-sallintalista.

4. Lisää yksi tai useampi IP-osoite tai CIDR-osoitealue.

5. (Valinnainen) Tarkista Tarkista-työkalulla, kuuluuko IP-osoite sallintalistaasi.

6. Ota sallintalista käyttöön:

   • tietyssä projektissa tai

   • koko organisaatiossa.

7. Testaa pyyntöjä ympäristöistä, joita aiot käyttää.

Suosittelemme aloittamaan yhdestä projektista ennen rajoitusten käyttöönottoa koko organisaatiossa.

Muutosten voimaantulo voi kestää jopa 15 minuuttia.


Huomautus: IP-sallintalistan asetusten määrittäminen edellyttää asianmukaisia käyttöoikeuksia organisaatiossa.

Vianmääritys

Jos pyynnöt epäonnistuvat odottamatta:

• Varmista, että pyyntö tulee sallitusta IP-osoitteesta.

• Tarkista, ovatko infrastruktuurisi IP-osoitteet muuttuneet.

• Tarkista, että määrittämäsi IP-osoitealueet ovat oikein.

• Odota enintään 15 minuuttia, jotta asetusmuutokset ehtivät tulla voimaan.

• Varmista Tarkista-työkalulla, onko IP-osoite sallittu.

Mitä tapahtuu, kun pyyntö estetään

Jos pyyntö tulee IP-osoitteesta, joka ei ole sallintalistalla, pyyntö epäonnistuu ja palauttaa seuraavat tiedot:

• HTTP-tila: 401 Unauthorized

• Virhekoodi: ip_not_authorized

Esimerkkivastaus:

{

 "error": {

   "message": "Your IP is not authorized to access this organization.",

   "type": "ip_not_authorized"

 }

}

Usein kysytyt kysymykset

Estääkö IP-sallintalista kaiken API-avaimeni luvattoman käytön?

Ei. IP-sallintalista voi vähentää riskiä rajoittamalla, mistä API-pyynnöt tulevat, mutta se ei estä täysin kaikkia väärinkäytön muotoja. Sen rinnalla on noudatettava muita hyviä tietoturvakäytäntöjä, kuten avainten turvallista säilytystä, säännöllistä vaihtamista ja tilin vahvaa suojausta. Voit parantaa suojausta tutustumalla ohjekeskuksemme oppaisiin API-avaimen turvallisen käytön parhaat käytännöt ja Luvattoman käytön estäminen.

Vaikuttaako IP-sallintalista viiveeseen?

IP-sallintalista voi aiheuttaa joissakin tapauksissa hyvin pienen viiveen, yleensä ensimmäisissä pyynnöissä. Sen ei odoteta vaikuttavan merkittävästi rajapinnan kokonaissuorituskykyyn.

Mistä tiedän, johtuuko pyynnön epäonnistuminen IP-sallintalistasta?

IP-sallintalistan vuoksi epäonnistuvat pyynnöt palauttavat seuraavat tiedot:

• HTTP status: 401 Unauthorized

• Error code: ip_not_authorized