1. Аккаунтыңыздағы әрбір команда мүшесі үшін әрдайым бірегей API кілтін пайдаланыңыз.
API кілті — API-ге жіберетін сұрауларыңызды сәйкестендіретін бірегей код. API кілтіңіз тек сіздің пайдалануыңызға арналған. API кілттерін бөлісу Пайдалану шарттарына қайшы.
Тәжірибе жасай бастағанда, API қолжетімділігін командаңызға кеңейткіңіз келуі мүмкін. OpenAI API кілттерін бөлісуді қолдамайды. Жаңа мүшелерді аккаунтыңызға Мүшелер бетінен шақырыңыз, сонда олар жүйеге кірген кезде өздерінің бірегей кілтін тез алады. Сондай-ақ жеке API кілттеріне рұқсаттар тағайындай аласыз.
2. Жарамдылық мерзімі бар API кілттерін жасап, оларды ауыстыру тәртібін белгілеңіз
Жоба кілттерін жарамдылық мерзімімен жасауға болады. Сол мерзім өткеннен кейін бұл кілттермен жіберілген барлық сұраулар қабылданбайды. Кілттерді жарамдылық мерзімімен жасап, оларды жүйелі түрде ауыстыру тәртібін белгілеуді қатаң ұсынамыз. Кілттің мерзімі аяқталмай тұрып, жаңасын жасаңыз және қолданбаларыңызды соны пайдаланатындай жаңартыңыз. Жаңа кілттің жұмыс істейтініне көз жеткізген соң, ескі кілттің күшін жойыңыз. Бұл шаралар API кілттері бөгде адамдардың қолына түскен жағдайда келетін зиянды едәуір азайта алады.
Әкімшілер платформа баптауларында ұйым немесе жоба деңгейінде API кілтінің ең ұзақ жарамдылық мерзімін міндетті шектеу ретінде белгілей алады. Жаңа кілттердің мерзімі рұқсат етілген шектер аясында белгіленуі керек. Бұл олардың мерзімсіз жарамды болып қалуына жол бермейді. Жоба үшін белгіленген шектеулер ұйым шегінен аспауы керек.
Қолдау көрсетілетін жұмыс жүктемелерінде ұзақ мерзімді OpenAI API кілтін сақтаудың орнына жұмыс жүктемелерінің сәйкестік деректерін федерациялауды пайдаланыңыз. Жұмыс жүктемеңіз сенімді провайдерден алынған сәйкестік деректерін қысқа мерзімді OpenAI қол жеткізу токеніне айырбастайды. Жұмыс жүктемесіне қажет рұқсаттары ғана бар арнайы қызметтік есептік жазбаны баптаңыз.
3. Кілтіңізді браузерлер немесе мобильді қолданбалар сияқты клиенттік орталарға ешқашан орналастырмаңыз.
OpenAI API кілтін браузерлер немесе мобильді қолданбалар сияқты клиенттік орталарда ашық қалдыру зиянкестерге оны алып, сіздің атыңыздан сұраулар жіберуге мүмкіндік береді. Бұл күтпеген төлемдерге немесе есептік жазбаңыздағы кейбір деректердің қауіпке ұшырауына әкелуі мүмкін. Сұрауларды әрдайым API кілтін қауіпсіз сақтай алатын өзіңіздің серверлік бөлік серверіңіз арқылы жіберу керек.
4. Кілтіңізді репозиторийге ешқашан қоспаңыз
API кілтін бастапқы кодқа қосу — тіркелгі деректерінің қауіпсіздігіне нұқсан келуінің кең таралған жолы. Жалпыға қолжетімді репозиторий пайдалансаңыз, кілтіңізді байқамай интернетте жариялап қоюыңыз мүмкін. Жеке репозиторийлер қауіпсіздеу болғанымен, деректер сыртқа шықса, кілттеріңіз де жария болуы мүмкін. Сондықтан кілт қауіпсіздігін алдын ала қамтамасыз ету үшін орта айнымалыларын пайдалануды қатаң ұсынамыз.
5. API кілтінің орнына орта айнымалыларын пайдаланыңыз
Орта айнымалысы қолданбаның ішінде емес, операциялық жүйеде орнатылады. Ол атау мен мәннен тұрады. Айнымалыны OPENAI_API_KEY деп атауды ұсынамыз. Командаңызда осы айнымалы атауын бірдей пайдалану арқылы API кілтін жариялау қаупінсіз кодты репозиторийге қосып, бөлісе аласыз.
Windows жүйесінде реттеу
1-нұсқа: «OPENAI_API_KEY» орта айнымалысын cmd пәрмен жолы арқылы орнату
cmd пәрмен жолында төмендегі пәрменді орындап, <yourkey> орнына API кілтіңізді енгізіңіз:
setx OPENAI_API_KEY "<yourkey>"Бұл болашақ cmd пәрмен жолы терезелеріне қолданылады, сондықтан айнымалыны curl көмегімен пайдалану үшін жаңа терезе ашуыңыз керек. Жаңа cmd пәрмен жолы терезесін ашып, төмендегіні енгізу арқылы осы айнымалының орнатылғанын тексеруге болады
echo %OPENAI_API_KEY%2-нұсқа: «OPENAI_API_KEY» орта айнымалысын Басқару тақтасы арқылы орнатыңыз
Жүйе сипаттарын ашып, Қосымша жүйе параметрлері тармағын таңдаңыз
Орта айнымалылары... тармағын таңдаңыз
Пайдаланушы айнымалылары бөлімінен (жоғарғы бөлікте) Жаңа… түймесін таңдаңыз. <yourkey> орнына API кілтіңізді қойып, атау мен кілт мәнінің жұбын қосыңыз.
Айнымалы атауы: OPENAI_API_KEY
Айнымалы мәні: <yourkey>Linux/macOS жүйесінде орнату
1-нұсқа: «OPENAI_API_KEY» орта айнымалысын zsh арқылы орнатыңыз
Терминалда келесі пәрменді орындап, yourkey орнына API кілтіңізді қойыңыз.
echo "export OPENAI_API_KEY='yourkey'" >> ~/.zshrcҚабықты жаңа айнымалымен жаңартыңыз:
source ~/.zshrcКелесі пәрмен арқылы орта айнымалысын орнатқаныңызды растаңыз.
echo $OPENAI_API_KEYНәтиже ретінде API кілтіңіздің мәні шығады.
2-нұсқа: bash арқылы «OPENAI_API_KEY» орта айнымалысын орнатыңыз
1-нұсқадағы нұсқауларды орындап, .zshrc файлын .bash_profile. файлына ауыстырыңыз.
Бәрі дайын! Енді кілтке curl ішінде сілтеме жасай аласыз немесе оны Python-да жүктей аласыз:
import os
import openai
openai.api_key = os.environ["OPENAI_API_KEY"]6. Кілттерді басқару қызметін пайдаланыңыз
Құпия API кілттерін қауіпсіз басқаруға арналған түрлі өнімдер бар. Бұл құралдар кілттеріңізге қолжетімділікті бақылауға және деректеріңіздің жалпы қауіпсіздігін арттыруға мүмкіндік береді. Қолданбаңыздағы деректер сыртқа шыққан жағдайда да кілттеріңізге қауіп төнбейді, өйткені олар шифрланып, мүлде бөлек жерде басқарылады.
Қолданбаларын өндірістік ортаға орналастыратын командаларға осындай қызметтердің бірін пайдалануды қарастыруды ұсынамыз.
7. Есептік жазбаңыздың пайдаланылуын бақылап, қажет кезде кілттерді ауыстырыңыз
Ұйымыңыз немесе жобаларыңыз үшін айлық шығын шектерін белгілеңіз. Кілт бөгде адамдардың қолына түскенде күтпеген шығындарды шектеу үшін осы шектерді қатаң сақтауды қосыңыз. Шығын туралы ескертулердің өзі API трафигін тоқтатпайды. Шекті қатаң сақтау заңды сұрауларды да бұғаттауы мүмкін. Шектеу бірден іске қосылмайтындықтан, шығын белгіленген шектен сәл асып кетуі ықтимал.
Бөгде адамның қолына түскен API кілті оған сіздің келісіміңізсіз есептік жазбаңыздың квотасын пайдалануға мүмкіндік береді. Бұл деректердің жоғалуына, күтпеген төлемдерге, айлық квотаның таусылуына және API-ге қол жеткізудің үзілуіне әкелуі мүмкін.
Командаларыңыздың ресурстарды пайдалануын Пайдалану бетінен бақылауға болады. Теріс пайдалану бар деп күдіктенсеңіз, есептік жазбаңызды қорғау үшін бірнеше шара қолдана аласыз:
Ресурстарды пайдалану көрсеткіштерін қарап, олардың командаңыздың жұмысына сәйкес келетінін тексеріңіз. Бірнеше ұйымға (мысалы, корпоративтік және жеке ұйымға) кіретін пайдаланушылардың бақылауды қосқанын және пайдалану мен оны бақылау үшін әдепкі ұйымын белгілегенін тексеріңіз.
Кілтіңіз бөгде адамдардың қолына түсті деп ойласаңыз, оны API кілттері бетінде дереу ауыстырыңыз. Қолданбаларыңыз өндірістік ортада жұмыс істеп тұрса, олардағы кілт мәндерін де тиісінше жаңарту қажет.
Жағдайды әрі қарай тексеру үшін бізге help.openai.com арқылы хабарласыңыз.
8. Желі арқылы қол жеткізуді басқару құралдарымен API-ді қорғаңыз
Рұқсат етілген IP мекенжайлар тізімі OpenAI API-іңізге қай IP мекенжайлардан қол жеткізуге болатынын шектеуге мүмкіндік береді. Бұл мүмкіндік қосылғанда, тек көрсетілген IP мекенжайлардан немесе ауқымдардан келген сұрауларға рұқсат беріледі. Қалған сұраулардың бәрі, тіпті оларда жарамды API кілті болса да, қабылданбайды.
Бұл API-іңізге тек серверлік бөлік серверлері немесе бұлттық орта сияқты сенімді инфрақұрылымнан қол жеткізуді қамтамасыз етіп, қосымша қорғаныс қабатын қалыптастырады.
Қосымша ақпаратты OpenAI API үшін рұқсат етілген IP мекенжайлар тізімі туралы мақаладан қараңыз.
Private Link — жеке желі арқылы қол жеткізу мүмкіндігі қажет ұйымдарға арналған тағы бір нұсқа. Ол Azure жұмыс жүктемелеріне Azure Private Link арқылы аймақтық OpenAI API түпкі нүктелеріне қосылуға мүмкіндік береді. Қол жеткізу мүмкіндігін сұрау үшін OpenAI өкіліңізге немесе сату бөліміне хабарласыңыз. API аутентификациясы бәрібір қажет. Private Link рұқсат етілген IP мекенжайлар тізімімен немесе өзара TLS (mTLS) протоколымен үйлеспейді. Баптау туралы толық ақпаратты Private Link нұсқаулығынан қараңыз.