Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Awtentikazzjoni, Ċwievet tal-API, u Organizzazzjoni

Lezzjoni 3 / 22 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Awtentikazzjoni, Ċwievet tal-API, u Organizzazzjoni
  2. Oħloq il-Kont Tiegħek u Ikseb Ċavetta
  3. Liema Tip ta’ Ċavetta Tagħżel
  4. Organizzazzjonijiet u Proġetti
  5. Qatt ma Tesponi ċ-Ċwievet Tiegħek
  6. Ivverifika l-Konfigurazzjoni Tiegħek
  7. Punti Ewlenin

Awtentikazzjoni, Ċwievet tal-API, u Organizzazzjoni

Qabel ma tikteb linja waħda ta’ kodiċi, trid tikkonfigura l-aċċess tiegħek għall-API. Din il-lezzjoni tkopri l-ħolqien ta’ ċwievet, l-istrutturar tal-aċċess permezz ta’ organizzazzjonijiet u proġetti, u l-prekawzjonijiet ta’ sigurtà li jipprevjenu l-incub klassiku: li tippushja bi żball ċavetta f’repożitorju pubbliku fejn barrani jikkunsmaha matul il-lejl.

Oħloq il-Kont Tiegħek u Ikseb Ċavetta

Il-proċess jieħu tliet passi. L-ewwel, mur fuq platform.openai.com u oħloq kont; awtomatikament se tirċievi krediti b’xejn biex tibda tesperimenta. Imbagħad, imxi lejn it-taqsima API Keys tad-dashboard u ġġenera ċavetta ġdida. Se tara din iċ-ċavetta darba biss: ikkopjaha immedjatament, iżda teħilhiex fil-kodiċi tiegħek.

# Iċ-ċavetta tal-API tiegħek tidher hekk (qatt ma taqsamha!)
# sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# L-aħjar prattika: uża varjabbli tal-ambjent
import os
api_key = os.environ.get("OPENAI_API_KEY")

It-tielet pass huwa d-dikjarazzjoni tal-varjabbli tal-ambjent, li tiddependi mill-pjattaforma tiegħek. Fuq magna ta’ żvilupp, fajl .env imħaddem minn python-dotenv spiss ikun l-aktar konvenjenti. Fuq server, ippreferi varjabbli tal-ambjent iddefinita mill-orchestrator jew is-servizz tas-sigrieti tiegħek.

# Linux / macOS — żid ma' ~/.bashrc jew ~/.zshrc
export OPENAI_API_KEY="sk-proj-your-key-here"

# Windows PowerShell
$env:OPENAI_API_KEY = "sk-proj-your-key-here"

# Fajl .env (b'python-dotenv)
# .env
OPENAI_API_KEY=sk-proj-your-key-here

Liema Tip ta’ Ċavetta Tagħżel

Iċ-ċwievet tal-proġett, li jistgħu jiġu identifikati mill-prefiss sk-proj- tagħhom, huma marbuta ma’ proġett speċifiku u joffru l-aħjar kontroll. Se tuża dawn f’kważi kull każ. L-SDK jiskoprihom awtomatikament ladarba l-varjabbli tal-ambjent tkun issettjata, u għalhekk OpenAI() tistanzja mingħajr argumenti fl-eżempji kollha f’dan il-kors.

from openai import OpenAI

# L-SDK jiskopri awtomatikament OPENAI_API_KEY
client = OpenAI()

# Jew speċifika b'mod espliċitu (mhux irrakkomandat għall-produzzjoni)
client = OpenAI(api_key="sk-proj-...")

Iċ-ċwievet tas-servizz huma t-tieni tip. Iddisinjati għal applikazzjonijiet tas-server li jeħtieġu aċċess elevat, jagħtu permessi addizzjonali u għalhekk jeħtieġu kura ekstra: aħżinhom f’vault tas-sigrieti u qatt ma tqassam il-valur tagħhom lil workstation ta’ żvilupp.

Organizzazzjonijiet u Proġetti

L-aċċess huwa strutturat fuq tliet livelli innestati:

  1. Organizzazzjoni: Il-kumpanija jew it-tim tiegħek
  2. Proġett: Raggruppament loġiku (eż. “Chatbot tal-Produzzjoni”, “Analiżi tad-Data”)
  3. Ċavetta tal-API: Marbuta ma’ proġett speċifiku

Jekk tappartjeni għal organizzazzjonijiet multipli, speċifika dik li intendi tuża meta tistanzja l-klijent:

from openai import OpenAI

# Speċifika l-organizzazzjoni (utli jekk tappartjeni għal diversi)
client = OpenAI(
    organization="org-xxxxxxxxxxxx",
    project="proj-xxxxxxxxxxxx"
)

Ħu l-ħin biex taqsam l-użu tiegħek f’proġetti minflok ma tgħaqqad kollox permezz ta’ ċavetta waħda. Se tara l-benefiċċju fl-ewwel sinjal ta’ trouble. Kull proġett għandu t-traċċar tal-użu tiegħu stess, li jippermettilek tattribwixxi l-ispejjeż għal karatteristika speċifika minflok total mensili opaku. Il-limiti tar-rata huma wkoll separati: xogħol bil-batch ta’ bil-lejl li jissatura l-kwota tiegħu ma jipprevjenix liċ-chatbot tiegħek milli jwieġeb lill-klijenti. Imbagħad tista’ tassenja membri differenti għal kull proġett, u l-aktar importanti, tirrevoka ċavetta kompromessa mingħajr ma tinterrompi applikazzjonijiet oħra.

Qatt ma Tesponi ċ-Ċwievet Tiegħek

Ir-regola hija sempliċi u assoluta: ċavetta qatt ma tidher fil-kodiċi sors. Il-kuntrast bejn iż-żewġ frammenti hawn taħt jitkellem iktar minn лекċċja twila.

# ĦŻIEN — ċavetta mwaħħla fil-kodiċi
client = OpenAI(api_key="sk-proj-abc123")  # PERIKLU!

# TAJB — varjabbli tal-ambjent
client = OpenAI()  # Jaqra awtomatikament OPENAI_API_KEY

# TAJB — fajl .env b'python-dotenv
from dotenv import load_dotenv
load_dotenv()
client = OpenAI()

Il-korollarju jikkonċerna l-.gitignore tiegħek, li għandu jeskludi fajls ta’ konfigurazzjoni lokali qabel l-ewwel commit tiegħek, mhux wara. Ċavetta li tiġi ppubblikata u mbagħad imħassra tibqa’ preżenti fl-istorja tar-repożitorju.

# DEJEM żid dawn il-linji mal-.gitignore tiegħek
.env
.env.local
.env.production
*.key

Fl-aħħar nett, ippjana rotazzjoni regolari, kull 90 jum. Tista’ tagħmel dan mingħajr ħin ta’ waqfa: oħloq ċavetta ġdida, aġġorna d-deployments tiegħek, u mbagħad ħassar dik antika biss ladarba xejn ma jkun qed jużaha iktar.

Ivverifika l-Konfigurazzjoni Tiegħek

Qabel ma tkompli, ħaddem dan l-iskript. Jiċċekkja l-preżenza taċ-ċavetta, juri verżjoni mqassra biex jikkonferma li hija dik it-tajba, u mbagħad jagħmel sejħa reali. Erġa’ ħaddem dan it-test kull darba li ambjent jaġixxi b’mod stramb.

from openai import OpenAI
import os

def verify_configuration():
    """Ivverifika li l-konfigurazzjoni tal-API hija korretta."""
    
    # Iċċekkja għaċ-ċavetta
    api_key = os.environ.get("OPENAI_API_KEY")
    if not api_key:
        print("ERROR: OPENAI_API_KEY mhux definita")
        return False
    
    print(f"Ċavetta skoperta: {api_key[:8]}...{api_key[-4:]}")
    
    # Ittestja l-konnessjoni
    try:
        client = OpenAI()
        response = client.responses.create(
            model="gpt-5.6-terra",
            input="Reply only: OK"
        )
        print(f"Konnessjoni suċċessiva: {response.output_text}")
        return True
    except Exception as e:
        print(f"ERROR fil-Konnessjoni: {e}")
        return False

verify_configuration()
# Riżultat mistenni:
# Ċavetta skoperta: sk-proj-...xxxx
# Konnessjoni suċċessiva: OK

Punti Ewlenin

  • Uża ċwievet tal-proġett (sk-proj-...) għal kull applikazzjoni
  • Aħżen iċ-ċwievet tiegħek f’varjabbli tal-ambjent, qatt fil-kodiċi
  • Organizza l-aċċess tiegħek bil-ġerarkija Organizzazzjoni → Proġett → Ċavetta
  • Wettaq rotazzjoni regolari taċ-ċwievet tiegħek (kull 90 jum)
  • Dejjem żid .env mal-.gitignore tiegħek