1. Kiekvienam komandos nariui savo paskyroje visada naudokite atskirą API raktą.

API raktas – tai unikalus kodas, pagal kurį atpažįstamos jūsų API užklausos. Jūsų API raktas skirtas naudoti tik jums. Dalijimasis API raktais pažeidžia Naudojimo sąlygas.

Pradėję bandyti API, galbūt norėsite suteikti prieigą ir savo komandai. „OpenAI“ neleidžia dalytis API raktais. Pakvieskite naujus narius į savo paskyrą puslapyje Nariai. Prisijungę jie netrukus gaus savo unikalų raktą. Taip pat galite priskirti leidimus atskiriems API raktams.

2. Kurkite API raktus su galiojimo pabaigos data ir nustatykite raktų keitimo tvarką

Kuriant projekto raktus galima nustatyti galiojimo pabaigos datą, po kurios visos užklausos su šiais raktais bus atmetamos. Primygtinai rekomenduojame kurti raktus su galiojimo pabaigos data ir nustatyti reguliaraus raktų keitimo tvarką. Prieš pasibaigiant rakto galiojimui, sukurkite naują, atnaujinkite programas, kad jos naudotų naująjį raktą, ir įsitikinę, kad jis veikia, atšaukite senąjį. Šios priemonės gali gerokai sumažinti API raktų nutekėjimo žalą.

Administratoriai gali nustatyti privalomą maksimalią API rakto galiojimo trukmę organizacijos ar projekto lygmeniu platformos nustatymuose. Naujų raktų galiojimo trukmė turi neviršyti nustatytų ribų, todėl jie negali galioti neribotą laiką. Projekto ribos negali viršyti organizacijos ribos.

Jei darbo krūvis tai palaiko, užuot saugoję ilgai galiojantį „OpenAI“ API raktą, naudokite darbo krūvio tapatybės federaciją. Jūsų darbo krūvis iškeičia patikimo teikėjo patvirtintą tapatybę į trumpai galiojantį „OpenAI“ prieigos atpažinimo ženklą. Sukonfigūruokite atskirą paslaugos paskyrą ir suteikite jai tik tuos leidimus, kurių reikia darbo krūviui.

3. Niekada nediekite rakto kliento pusės aplinkose, pavyzdžiui, naršyklėse ar mobiliosiose programėlėse.

Atskleidus „OpenAI“ API raktą kliento pusės aplinkose, pavyzdžiui, naršyklėse ar mobiliosiose programėlėse, piktavaliai gali jį pasisavinti ir teikti užklausas jūsų vardu. Dėl to galite patirti netikėtų išlaidų arba gali būti pažeistas kai kurių paskyros duomenų saugumas. Užklausos visada turi būti siunčiamos per jūsų valdomą serverį, kuriame galite saugiai laikyti API raktą.

4. Niekada neįtraukite rakto į saugyklą

API rakto įtraukimas į šaltinio kodą yra vienas iš dažnų prisijungimo duomenų nutekinimo būdų. Jei saugykla vieša, galite patys to nežinodami paskelbti savo raktą internete. Privačios saugyklos yra saugesnės, tačiau dėl duomenų saugumo pažeidimo jūsų raktai taip pat gali būti nutekinti. Todėl primygtinai rekomenduojame iš anksto pasirūpinti raktų saugumu ir naudoti aplinkos kintamuosius.

5. Vietoj API rakto naudokite aplinkos kintamuosius

Sąranka „Windows“ sistemoje

Aplinkos kintamasis – tai kintamasis, nustatomas operacinėje sistemoje, o ne pačioje programoje. Jį sudaro pavadinimas ir reikšmė. Rekomenduojame kintamąjį pavadinti OPENAI_API_KEY. Visai komandai naudojant tą patį kintamojo pavadinimą, galite įkelti kodą į saugyklą ir juo dalytis nerizikuodami atskleisti API rakto.


1 būdas: nustatykite aplinkos kintamąjį „OPENAI_API_KEY“ per cmd komandų eilutę

cmd komandų eilutėje paleiskite toliau pateiktą komandą, pakeisdami <yourkey> savo API raktu:

Šis pakeitimas bus taikomas naujiems cmd komandų eilutės langams, todėl, norėdami naudoti šį kintamąjį su curl, turėsite atverti naują langą. Norėdami patikrinti, ar šis kintamasis nustatytas, atverkite naują cmd komandų eilutės langą ir įveskite

2 būdas: nustatykite aplinkos kintamąjį „OPENAI_API_KEY“ valdymo skyde

1. Atidarykite sistemos ypatybes ir pasirinkite Išplėstiniai sistemos parametrai

1. Pasirinkite Aplinkos kintamieji...

1. Naudotojo kintamųjų skiltyje (viršuje) pasirinkite Naujas…. Įveskite kintamojo pavadinimą ir rakto reikšmę, pakeisdami <yourkey> savo API raktu.

Sąranka „Linux“ ir „macOS“ sistemose

1 būdas: nustatykite aplinkos kintamąjį „OPENAI_API_KEY“ naudodami zsh

1. Terminale paleiskite toliau pateiktą komandą, pakeisdami yourkey savo API raktu.

1. Atnaujinkite komandų apvalkalą nauju kintamuoju:

1. Patvirtinkite, kad nustatėte aplinkos kintamąjį, naudodami šią komandą.

Gauta išvestis bus jūsų API rakto reikšmė.


2 parinktis: nustatykite aplinkos kintamąjį „OPENAI_API_KEY“ naudodami bash

Vadovaukitės 1 parinkties nurodymais, pakeisdami .zshrc į .bash_profile.

Viskas paruošta! Dabar galite naudoti raktą su curl arba įkelti jį į Python:

6. Naudokitės raktų valdymo paslauga

Yra įvairių produktų, skirtų saugiai valdyti slaptuosius API raktus. Šie įrankiai leidžia valdyti prieigą prie jūsų raktų ir padidinti bendrą duomenų saugumą. Nutekėjus jūsų programos duomenims, raktai liktų saugūs, nes būtų užšifruoti ir valdomi visiškai atskiroje vietoje.

Komandoms, diegiančioms programas gamybinėje aplinkoje, rekomenduojame apsvarstyti vieną iš šių paslaugų.

7. Stebėkite paskyros naudojimą ir prireikus keiskite raktus

Nustatykite savo organizacijos ar projektų mėnesio išlaidų limitus ir įjunkite griežtą jų taikymą, kad apribotumėte netikėtas išlaidas nutekėjus raktui. Vien įspėjimai apie išlaidas API srauto nesustabdo. Griežtai taikant limitus gali būti blokuojamos ir teisėtos užklausos, o išlaidos gali šiek tiek viršyti limitą, nes jis pradedamas taikyti ne iš karto.

Nutekėjęs API raktas leidžia kitam asmeniui naudotis jūsų paskyros kvota be jūsų sutikimo. Dėl to galite prarasti duomenis, patirti netikėtų išlaidų, išnaudoti mėnesio kvotą ir netekti prieigos prie API.

Savo komandų naudojimą galite stebėti puslapyje Naudojimas. Jei įtariate piktnaudžiavimą, galite imtis kelių veiksmų savo paskyrai apsaugoti:

• Peržiūrėkite naudojimo duomenis ir patikrinkite, ar jie atitinka jūsų komandos veiklą. Jei naudotojas priklauso kelioms organizacijoms (pvz., įmonės ir asmeninei), įsitikinkite, kad jis įjungė naudojimo stebėjimą ir nustatė numatytąją organizaciją, kuriai bus priskiriamas ir stebimas naudojimas.

• Jei manote, kad jūsų raktas nutekėjo, nedelsdami pakeiskite jį nauju puslapyje API raktai. Jei jūsų programos veikia gamybinėje aplinkoje, jose taip pat turėsite atnaujinti raktų reikšmes.

• Kad galėtume išsamiau ištirti situaciją, susisiekite su mumis per help.openai.com.

8. Apsaugokite prieigą prie API tinklo valdymo priemonėmis

Leidžiamų IP adresų sąrašu galite apriboti, iš kurių IP adresų galima pasiekti jūsų „OpenAI“ API. Įjungus šią funkciją, leidžiamos tik užklausos iš nustatytų IP adresų ar jų intervalų, o visos kitos atmetamos, net jei jose pateiktas galiojantis API raktas.

Tai suteikia papildomą apsaugą: jūsų API galima pasiekti tik iš patikimos infrastruktūros, pavyzdžiui, jūsų serverių ar debesijos aplinkos.

Daugiau informacijos rasite straipsnyje apie leidžiamų IP adresų sąrašą „OpenAI“ API.

„Private Link“ – dar viena galimybė organizacijoms, kurioms reikalinga prieiga per privatų tinklą. Ji leidžia „Azure“ aplinkoje veikiančioms sistemoms prisijungti prie regioninių „OpenAI“ API galinių taškų per „Azure Private Link“. Norėdami gauti prieigą, kreipkitės į savo „OpenAI“ atstovą arba pardavimo komandą. API autentifikavimas vis tiek būtinas, o „Private Link“ nesuderinama su leidžiamų IP adresų sąrašu ar abipusiu TLS (mTLS). Išsamias sąrankos instrukcijas rasite „Private Link“ vadove.