1. Kasuta oma kontol iga meeskonnaliikme jaoks alati eraldi API-võtit.
API-võti on kordumatu kood, mille abil tuvastatakse sinu API-päringud. Sinu API-võti on mõeldud ainult sulle kasutamiseks. API-võtmete jagamine on vastuolus kasutustingimustega.
API-ga katsetama hakates võid soovida anda sellele juurdepääsu ka oma meeskonnale. OpenAI ei toeta API-võtmete jagamist. Kutsu uusi liikmeid oma kontole lehelt Liikmed. Sisselogimisel saavad nad kiiresti oma kordumatu võtme. Samuti saad määrata igale API-võtmele eraldi õigused.
2. Looge aegumiskuupäevaga API-võtmed ja kehtestage võtmete regulaarse vahetamise kord
Projektivõtmeid saab luua aegumiskuupäevaga, pärast mida lükatakse kõik nende võtmetega tehtud päringud tagasi. Soovitame tungivalt luua aegumiskuupäevaga võtmed ja kehtestada võtmete regulaarse vahetamise korra. Enne võtme aegumist looge uus võti, seadistage rakendused seda kasutama ja tühistage vana võti, kui olete veendunud, et uus töötab. Need võtted võivad API-võtmete lekkimise mõju oluliselt vähendada.
Administraatorid saavad platvormi seadetes kehtestada organisatsiooni või projekti tasemel API-võtmete maksimaalse kehtivusaja. Uute võtmete seadistamisel tuleb järgida lubatud piire, et võtmed ei jääks kehtima määramata ajaks. Projekti kehtivusaja piirang ei tohi ületada organisatsiooni oma.
Toetatud töökoormuste puhul kasutage pika kehtivusajaga OpenAI API-võtme salvestamise asemel töökoormuste identiteediföderatsiooni. Teie töökoormus vahetab usaldusväärselt pakkujalt saadud identiteedi lühikese kehtivusajaga OpenAI pääsutõendi vastu. Seadistage eraldi teenusekonto, millel on ainult töökoormusele vajalikud õigused.
3. Ärge kunagi paigutage oma võtit kliendipoolsetesse keskkondadesse, näiteks brauseritesse või mobiilirakendustesse.
Kui teie OpenAI API-võti on nähtav kliendipoolsetes keskkondades, näiteks brauserites või mobiilirakendustes, saavad pahatahtlikud kasutajad selle kopeerida ja teie nimel päringuid teha. See võib kaasa tuua ootamatuid tasusid või seada ohtu osa kontoandmeid. Päringud tuleks alati suunata läbi teie enda tagarakenduse serveri, kus saate oma API-võtit turvaliselt hoida.
4. Ärge kunagi lisage võtit oma varamusse
API-võtme lähtekoodi lisamine on levinud viis, kuidas autentimisandmed võivad ohtu sattuda. Avalike varamute puhul võite nii oma võtme enese teadmata internetis avalikustada. Privaatsed varamud on turvalisemad, kuid andmeleke võib siiski põhjustada teie võtmete avalikuks tuleku. Seetõttu soovitame võtmete ennetava turvameetmena tungivalt kasutada keskkonnamuutujaid.
5. Kasuta API-võtme asemel keskkonnamuutujaid
Seadistamine Windowsis
Keskkonnamuutuja on muutuja, mis määratakse operatsioonisüsteemis, mitte rakenduses. See koosneb nimest ja väärtusest. Soovitame määrata muutuja nimeks OPENAI_API_KEY. Kui kogu meeskond kasutab sama muutujanime, saate koodi versioonihaldusse salvestada ja jagada, ilma et riskiksite oma API-võtme avaldamisega.
Variant 1: määra keskkonnamuutuja „OPENAI_API_KEY“ cmd käsuviiba kaudu
Käivita cmd käsuviibas järgmine käsk, asendades <yourkey> oma API-võtmega:
setx OPENAI_API_KEY "<yourkey>"See rakendub edaspidi avatavatele cmd-käsuviiba akendele, mistõttu peate muutuja kasutamiseks curliga avama uue akna. Muutuja määramist saate kontrollida, avades uue cmd-käsuviiba akna ja sisestades
echo %OPENAI_API_KEY%Variant 2: määra keskkonnamuutuja „OPENAI_API_KEY“ juhtpaneeli kaudu
Ava süsteemi atribuudid ja vali Täpsemad süsteemisätted
Vali Keskkonnamuutujad...
Vali kasutajamuutujate jaotises (üleval) Uus…. Lisa nime ja võtmeväärtuse paar, asendades <yourkey> oma API-võtmega.
Muutuja nimi: OPENAI_API_KEY
Muutuja väärtus: <yourkey>Seadistamine Linuxis ja macOS-is
Variant 1: määra keskkonnamuutuja „OPENAI_API_KEY“ zsh abil
Käivita terminalis järgmine käsk, asendades yourkey oma API-võtmega.
echo "export OPENAI_API_KEY='yourkey'" >> ~/.zshrcVärskendage kesta uue muutujaga:
source ~/.zshrcKinnitage järgmise käsuga, et olete keskkonnamuutuja määranud.
echo $OPENAI_API_KEYTulemuseks kuvatakse teie API võtme väärtus.
Valik 2. Määrake oma keskkonnamuutuja ‘OPENAI_API_KEY’ bashi abil
Järgige valiku 1 juhiseid, asendades .zshrc väärtusega .bash_profile.
Kõik on valmis! Nüüd saate võtmele viidata curlis või laadida selle oma Pythonis:
import os
import openai
openai.api_key = os.environ["OPENAI_API_KEY"]6. Kasuta võtmehaldusteenust
Salajaste API-võtmete turvaliseks haldamiseks on saadaval mitmesuguseid tooteid. Need tööriistad võimaldavad sul kontrollida juurdepääsu oma võtmetele ja parandada üldist andmeturvet. Kui sinu rakenduses peaks toimuma andmeleke, jääksid sinu võtmed kaitstuks, sest need oleksid krüpteeritud ja neid hallataks täiesti eraldi asukohas.
Meeskondadel, kes viivad oma rakendusi tootmiskeskkonda, soovitame kaaluda mõne sellise teenuse kasutamist.
7. Jälgi oma konto kasutust ja vaheta võtmed vajaduse korral välja
Määra oma organisatsioonile või projektidele igakuised kululimiidid ja lülita sisse limiidi range jõustamine, et piirata lekkinud võtmest tingitud ootamatuid kulusid. Ainuüksi kuluhoiatused API-liiklust ei peata. Range jõustamine võib blokeerida ka õiguspärased päringud ning kulud võivad limiiti veidi ületada, sest jõustamine ei toimu hetkega.
Kõrvalise isiku kätte sattunud API-võti võimaldab tal kasutada sinu konto kvooti ilma sinu nõusolekuta. See võib põhjustada andmekadu, ootamatuid tasusid, sinu kuukvoodi ammendumist ja API-le juurdepääsu katkemist.
Oma meeskondade kasutust saad jälgida lehel Kasutus. Kui kahtlustad väärkasutust, saad oma konto kaitsmiseks teha järgmist.
Vaata oma kasutusandmed üle ja kontrolli, kas need vastavad sinu meeskonna tööle. Mitmesse organisatsiooni (nt ettevõtte ja isiklikku organisatsiooni) kuuluvate kasutajate puhul veendu, et kasutaja oleks jälgimise sisse lülitanud ning määranud kasutuse ja selle jälgimise jaoks vaikeorganisatsiooni.
Kui arvad, et sinu võti on lekkinud, vaheta see kohe välja lehel API-võtmed. Kui sinu rakendused on tootmiskeskkonnas kasutusel, tuleb ka nendes võtmeväärtusi vastavalt uuendada.
Edasiseks uurimiseks võta meiega ühendust lehe help.openai.com kaudu.
8. Kaitse API-le juurdepääsu võrgupiirangutega
IP-aadresside lubatud loendiga saad piirata, millistelt IP-aadressidelt sinu OpenAI API-le juurde pääseb. Kui see on lubatud, võetakse vastu ainult määratud IP-aadressidelt või aadressivahemikest tulevad päringud. Kõik teised lükatakse tagasi, isegi kui need sisaldavad kehtivat API-võtit.
See lisab täiendava kaitsekihi, tagades, et sinu API-le pääseb juurde ainult usaldusväärsest taristust, näiteks sinu taustaserveritest või pilvekeskkonnast.
Lisateavet leiad artiklist „IP-aadresside lubatud loend OpenAI API jaoks“.
Private Link on teine võimalus organisatsioonidele, kes vajavad juurdepääsu privaatvõrgu kaudu. See võimaldab Azure’i töökoormustel luua Azure Private Linki kaudu ühenduse OpenAI API piirkondlike lõpp-punktidega. Juurdepääsu taotlemiseks võta ühendust oma OpenAI esindaja või müügimeeskonnaga. API autentimine on endiselt nõutav ning Private Link ei ühildu IP-aadresside lubatud loendi ega vastastikuse TLS-iga (mTLS). Seadistamise üksikasjad leiad Private Linki juhendist.