1. Dejjem uża ċavetta API unika għal kull membru tat-tim fil-kont tiegħek.

Ċavetta API hija kodiċi uniku li jidentifika t-talbiet tiegħek lill-API. Iċ-ċavetta API tiegħek hija maħsuba biex tintuża minnek. Il-qsim ta’ ċwievet API huwa kontra t-Termini tal-Użu.

Hekk kif tibda tesperimenta, tista’ tkun trid tespandi l-aċċess għall-API lit-tim tiegħek. OpenAI ma tappoġġjax il-qsim ta’ ċwievet API. Jekk jogħġbok stieden membri ġodda għall-kont tiegħek mill-paġna Members u huma jirċievu malajr iċ-ċavetta unika tagħhom stess meta jidħlu. Tista’ wkoll tassenja permessi lil ċwievet API individwali.

2. Oħloq ċwievet API b’data ta’ skadenza u stabbilixxi proċess biex tissostitwixxihom regolarment

Iċ-ċwievet tal-proġett jistgħu jinħolqu b’data ta’ skadenza li warajha kwalunkwe talba li tuża dawk iċ-ċwievet tiġi rrifjutata. Nirrakkomandaw bil-qawwa li toħloq ċwievet b’data ta’ skadenza u tistabbilixxi proċess biex tissostitwixxihom regolarment. Qabel ma tiskadi ċavetta, oħloq oħra minflokha, aġġorna l-applikazzjonijiet tiegħek biex jużawha, u rrevoka ċ-ċavetta l-qadima ladarba tkun ivverifikajt li l-ġdida taħdem. Dawn il-prattiki jistgħu jnaqqsu ħafna l-impatt jekk jiġu żvelati ċ-ċwievet API.

L-amministraturi jistgħu jimponu perjodu massimu ta’ validità għaċ-ċwievet API fil-livell tal-organizzazzjoni jew tal-proġett fis-settings tal-pjattaforma. Iċ-ċwievet il-ġodda jridu jiġu konfigurati fil-limiti permessi, biex ma jibqgħux validi għal żmien indefinit. Il-limiti tal-proġett ma jistgħux jaqbżu l-limitu tal-organizzazzjoni.

Għal tagħbijiet tax-xogħol appoġġjati, uża l-federazzjoni tal-identità tat-tagħbija tax-xogħol minflok taħżen ċavetta API ta’ OpenAI b’validità fit-tul. It-tagħbija tax-xogħol tiegħek tiskambja identità minn fornitur affidabbli ma’ token ta’ aċċess għal OpenAI b’validità qasira. Ikkonfigura kont tas-servizz iddedikat bil-permessi biss li teħtieġ it-tagħbija tax-xogħol.

3. Qatt tinkludi ċ-ċavetta tiegħek f’ambjenti fuq in-naħa tal-klijent, bħal browsers jew apps mobbli.

Jekk tesponi ċ-ċavetta API ta’ OpenAI tiegħek f’ambjenti fuq in-naħa tal-klijent, bħal browsers jew apps mobbli, utenti malizzjużi jistgħu jieħdu dik iċ-ċavetta u jagħmlu talbiet f’ismek. Dan jista’ jwassal għal ħlasijiet mhux mistennija jew jikkomprometti ċerta data tal-kont. It-talbiet għandhom dejjem jgħaddu mis-server tal-backend tiegħek stess, fejn tista’ żżomm iċ-ċavetta API tiegħek sigura.

4. Qatt tikkommittja ċ-ċavetta tiegħek fir-repożitorju

Il-kommittjar ta’ ċavetta tal-API fil-kodiċi sors huwa mod komuni kif il-kredenzjali jistgħu jiġu kompromessi. Jekk għandek repożitorji pubbliċi, dan huwa mod komuni kif tista’ bla ma tinduna taqsam iċ-ċavetta tiegħek mal-internet. Ir-repożitorji privati huma aktar siguri, iżda ksur tad-data jista’ wkoll iwassal biex iċ-ċwievet tiegħek jiġu żvelati. Għal dawn ir-raġunijiet, nirrakkomandaw bil-qawwa li tuża varjabbli tal-ambjent bħala miżura proattiva biex tipproteġi ċ-ċwievet.

5. Uża Varjabbli tal-Ambjent minflok iċ-ċavetta tal-API tiegħek

Varjabbli tal-ambjent huwa varjabbli li jiġi stabbilit fis-sistema operattiva tiegħek, minflok fl-applikazzjoni. Dan jikkonsisti f’isem u valur. Nirrakkomandaw li tagħżel OPENAI_API_KEY bħala l-isem tal-varjabbli. Jekk it-tim kollu juża l-istess isem għal dan il-varjabbli, tistgħu tikkommittjaw u taqsmu l-kodiċi mingħajr ir-riskju li tesponu ċ-ċavetta tal-API.


Konfigurazzjoni tal-Windows

Għażla 1: Issettja l-Varjabbli tal-Ambjent ‘OPENAI_API_KEY’ permezz tal-prompt tas-cmd

Ħaddem dan li ġej fil-prompt tas-cmd, u ibdel <yourkey> biċ-ċavetta tal-API tiegħek:

Dan se japplika għat-twieqi tal-prompt tas-cmd li tiftaħ fil-futur, għalhekk trid tiftaħ waħda ġdida biex tuża dik il-varjabbli ma’ curl. Tista’ tivverifika li din il-varjabbli ġiet issettjata billi tiftaħ tieqa ġdida tal-prompt tas-cmd u tittajpja

Għażla 2: Issettja l-Varjabbli tal-Ambjent ‘OPENAI_API_KEY’ mill-Panew tal-Kontroll

1. Iftaħ il-proprjetajiet tas-Sistema u agħżel Settings avvanzati tas-sistema

1. Agħżel Varjabbli tal-Ambjent...

1. Agħżel Ġdid… mit-taqsima tal-varjabbli tal-utent (fuq). Żid il-par isem/valur taċ-ċavetta tiegħek, u ibdel <yourkey> biċ-ċavetta API tiegħek.

Konfigurazzjoni għal Linux/macOS

Għażla 1: Issettja l-Varjabbli tal-Ambjent ‘OPENAI_API_KEY’ permezz ta’ zsh

1. Ħaddem il-kmand li ġej fit-terminal tiegħek, u ibdel yourkey biċ-ċavetta API tiegħek.

1. Aġġorna s-shell bil-varjabbli l-ġdida:

1. Ikkonferma li ssettjajt il-varjabbli tal-ambjent tiegħek billi tuża l-kmand li ġej.

Il-valur taċ-ċavetta API tiegħek se jkun l-output li jirriżulta.


Għażla 2: Issettja l-Varjabbli tal-Ambjent ‘OPENAI_API_KEY’ tiegħek billi tuża bash

Segwi d-direzzjonijiet f’Għażla 1, billi tissostitwixxi .zshrc b’.bash_profile.

Kollox lest! Issa tista’ tirreferi għaċ-ċavetta f’curl jew tgħabbiha fil-Python tiegħek:

6. Uża Servizz għall-Ġestjoni taċ-Ċwievet

Hemm diversi prodotti disponibbli għall-ġestjoni sigura ta’ ċwievet sigrieti tal-API. Dawn l-għodod iħalluk tikkontrolla l-aċċess għaċ-ċwievet tiegħek u ttejjeb is-sigurtà ġenerali tad-data tiegħek. F’każ ta’ ksur tad-data fl-applikazzjoni tiegħek, iċ-ċavetta jew iċ-ċwievet tiegħek ma jiġux kompromessi, għax ikunu kriptati u ġestiti f’post kompletament separat.

Għat-timijiet li qed iqiegħdu l-applikazzjonijiet tagħhom fil-produzzjoni, nirrakkomandaw li jikkunsidraw wieħed minn dawn is-servizzi.

7. Immonitorja l-użu tal-kont tiegħek u ssostitwixxi ċ-ċwievet tiegħek meta jkun meħtieġ

Issettja limiti ta’ nfiq ta’ kull xahar għall-organizzazzjoni jew għall-proġetti tiegħek, u attiva l-infurzar strett biex tgħin tillimita spejjeż mhux mistennija jekk tiġi żvelata ċavetta. It-twissijiet dwar l-infiq waħedhom ma jwaqqfux it-traffiku tal-API. L-infurzar strett jista’ jimblokka talbiet leġittimi, u l-infiq jista’ jaqbeż xi ftit il-limitu għax l-infurzar mhuwiex istantanju.

Ċavetta API kompromessa tippermetti lil xi ħadd jaċċessa l-kwota tal-kont tiegħek mingħajr il-kunsens tiegħek. Dan jista’ jwassal għal telf ta’ data, ħlasijiet mhux mistennija, eżawriment tal-kwota ta’ kull xahar tiegħek u interruzzjoni fl-aċċess tiegħek għall-API.

Tista’ ssegwi l-użu tat-timijiet tiegħek permezz tal-paġna Użu. Jekk qatt ikollok tħassib dwar użu ħażin, tista’ tieħu dawn il-miżuri biex tipproteġi l-kont tiegħek:

• Irrevedi l-użu tiegħek biex tara jekk jaqbilx max-xogħol tat-tim tiegħek. Għall-utenti li jappartjenu għal diversi organizzazzjonijiet (pereżempju, korporattivi u personali), kun żgur li l-utent ikun attiva t-traċċar u ssettja l-organizzazzjoni prestabbilita tiegħu għall-użu u t-traċċar.

• Jekk taħseb li ċ-ċavetta tiegħek ġiet żvelata, issostitwiha minnufih mill-paġna Ċwievet API. Jekk għandek applikazzjonijiet fl-ambjent tal-produzzjoni, ikollok bżonn taġġorna l-valuri taċ-ċwievet tiegħek kif xieraq.

• Ikkuntattjana permezz ta’ help.openai.com biex ninvestigaw aktar.

8. Ipproteġi l-aċċess għall-API b’kontrolli tan-network

Lista ta’ indirizzi IP permessi tippermettilek tillimita liema indirizzi IP jistgħu jaċċessaw l-API ta’ OpenAI tiegħek. Meta tkun attivata, jiġu aċċettati biss talbiet mill-indirizzi IP jew mill-firxiet konfigurati, u l-oħrajn kollha jiġu rrifjutati—anke jekk jinkludu ċavetta API valida.

Dan iżid saff ieħor ta’ protezzjoni billi jiżgura li l-API tiegħek tkun aċċessibbli biss minn infrastruttura affidabbli, bħas-servers tal-backend jew l-ambjent tal-cloud tiegħek.

Għal aktar informazzjoni, ara l-artiklu dwar il-listi ta’ indirizzi IP permessi għall-API ta’ OpenAI.

Private Link hija għażla oħra għall-organizzazzjonijiet li jeħtieġu aċċess permezz ta’ network privat. Tippermetti lit-tagħbijiet tax-xogħol ta’ Azure jikkonnettjaw mal-endpoints reġjonali tal-API ta’ OpenAI permezz ta’ Azure Private Link. Ikkuntattja lir-rappreżentant ta’ OpenAI tiegħek jew lit-tim tal-bejgħ biex titlob aċċess. L-awtentikazzjoni tal-API xorta waħda hija meħtieġa, u Private Link mhijiex kompatibbli mal-listi ta’ indirizzi IP permessi jew mat-TLS reċiproku (mTLS). Għad-dettalji tal-konfigurazzjoni, ara l-gwida għal Private Link.