Autentifikacija, API ključevi i organizacija
Na ovoj stranici
Autentifikacija, API ključevi i organizacija
Prije nego što napišeš ijednu liniju koda, moraš konfigurirati svoj pristup API-ju. Ova lekcija pokriva stvaranje ključeva, strukturiranje pristupa kroz organizacije i projekte te sigurnosne mjere koje sprječavaju klasičnu noćnu moru: slučajno objavljivanje ključa u javnom repozitoriju gdje ga stranac može iskoristiti preko noći.
Kreiraj račun i dobi ključ
Proces se sastoji od tri koraka. Prvo, idi na platform.openai.com i kreiraj račun; automatski ćeš dobiti besplatne kredite za početak eksperimentiranja. Zatim, navigiraj do sekcije API Keys na nadzornoj ploči i generiraj novi ključ. Taj ćeš ključ vidjeti samo jednom: odmah ga kopiraj, ali ga nemoj zalijepiti u svoj kod.
# Tvoj API ključ izgleda ovako (nikada ga ne dijeli!)
# sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# Najbolja praksa: koristi varijablu okruženja
import os
api_key = os.environ.get("OPENAI_API_KEY")
Treći korak je deklariranje varijable okruženja, što ovisi o tvojoj platformi. Na razvojnom računalu, .env datoteka učitana putem python-dotenv često je najprikladnija. Na poslužitelju, prednost daj varijabli okruženja koju definira tvoj orkestrator ili servis za tajne.
# Linux / macOS — dodaj u ~/.bashrc ili ~/.zshrc
export OPENAI_API_KEY="sk-proj-your-key-here"
# Windows PowerShell
$env:OPENAI_API_KEY = "sk-proj-your-key-here"
# .env datoteka (s python-dotenv)
# .env
OPENAI_API_KEY=sk-proj-your-key-here
Koju vrstu ključa odabrati
Ključevi projekta, prepoznatljivi po prefiksu sk-proj-, vezani su uz određeni projekt i nude najbolju kontrolu. Koristit ćeš ih u gotovo svakom slučaju. SDK ih automatski detektira čim je varijabla okruženja postavljena, zbog čega se OpenAI() instancira bez argumenata u svim primjerima u ovom tečaju.
from openai import OpenAI
# SDK automatski detektira OPENAI_API_KEY
client = OpenAI()
# Ili navedi eksplicitno (ne preporučuje se za produkciju)
client = OpenAI(api_key="sk-proj-...")
Servisni ključevi su druga vrsta. Dizajnirani za serverske aplikacije koje zahtijevaju povišeni pristup, dodjeljuju dodatne dozvole i stoga zahtijevaju dodatnu pažnju: pohrani ih u trezor tajni i nikada ne distribuiraj njihovu vrijednost na razvojnu radnu stanicu.
Organizacije i projekti
Pristup je strukturiran kroz tri razine ugniježđenosti:
- Organizacija: Tvoja tvrtka ili tim
- Projekt: Logično grupiranje (npr. „Produkcijski Chatbot“, „Analiza podataka“)
- API ključ: Povezan s određenim projektom
Ako pripadaš više organizacija, navedi onu koju namjeravaš koristiti prilikom instanciranja klijenta:
from openai import OpenAI
# Navedi organizaciju (korisno ako pripadaš više njih)
client = OpenAI(
organization="org-xxxxxxxxxxxx",
project="proj-xxxxxxxxxxxx"
)
Odvoji vrijeme za razdvajanje svoje upotrebe u projekte umjesto da sve usmjeravaš kroz jedan ključ. Prednost ćeš vidjeti čim se pojave prvi problemi. Svaki projekt ima vlastito praćenje upotrebe, što ti omogućuje da troškove pripišeš određenoj funkcionalnosti umjesto nejasnom mjesečnom zbroju. Ograničenja stope (rate limits) također su odvojena: noćni batch posao koji zasiti svoju kvotu neće spriječiti tvoj chatbot da odgovara korisnicima. Zatim možeš dodijeliti različite članove svakom projektu, a što je najvažnije, opozvati kompromitirani ključ bez prekida rada drugih aplikacija.
Nikada ne izlaži svoje ključeve
Pravilo je jednostavno i apsolutno: ključ se nikada ne pojavljuje u izvornom kodu. Kontrast između dva isječka u nastavku govori više od dugog predavanja.
# LOŠE — ključ ukodiran u kodu
client = OpenAI(api_key="sk-proj-abc123") # OPASNOST!
# DOBRO — varijabla okruženja
client = OpenAI() # Automatski čita OPENAI_API_KEY
# DOBRO — .env datoteka s python-dotenv
from dotenv import load_dotenv
load_dotenv()
client = OpenAI()
Posljedica se odnosi na tvoj .gitignore, koji mora isključiti lokalne konfiguracijske datoteke prije tvog prvog commita, a ne nakon toga. Ključ koji je objavljen, a zatim izbrisan, ostaje prisutan u povijesti repozitorija.
# UVIJEK dodaj ove linije u svoj .gitignore
.env
.env.local
.env.production
*.key
Konačno, planiraj redovitu rotaciju, svakih 90 dana. To možeš učiniti bez zastoja: kreiraj novi ključ, ažuriraj svoje implementacije, a zatim izbriši stari tek kada ga ništa više ne koristi.
Provjeri svoju konfiguraciju
Prije nego što nastaviš, pokreni ovu skriptu. Ona provjerava prisutnost ključa, prikazuje njegovu skraćenu verziju kako bi potvrdila da je ispravan, a zatim izvršava stvarni poziv. Ponovno pokreni ovaj test kad god se okruženje ponaša čudno.
from openai import OpenAI
import os
def verify_configuration():
"""Provjeri je li API konfiguracija ispravna."""
# Provjeri postoji li ključ
api_key = os.environ.get("OPENAI_API_KEY")
if not api_key:
print("GREŠKA: OPENAI_API_KEY nije definiran")
return False
print(f"Ključ detektiran: {api_key[:8]}...{api_key[-4:]}")
# Testiraj vezu
try:
client = OpenAI()
response = client.responses.create(
model="gpt-5.6-terra",
input="Reply only: OK"
)
print(f"Veza uspješna: {response.output_text}")
return True
except Exception as e:
print(f"GREŠKA veze: {e}")
return False
verify_configuration()
# Očekivani rezultat:
# Ključ detektiran: sk-proj-...xxxx
# Veza uspješna: OK
Ključne točke
- Koristi ključeve projekta (
sk-proj-...) za svaku aplikaciju - Pohrani svoje ključeve u varijable okruženja, nikada u kod
- Organiziraj svoj pristup hijerarhijom Organizacija → Projekt → Ključ
- Izvršavaj redovitu rotaciju svojih ključeva (svakih 90 dana)
- Uvijek dodaj
.envu svoj.gitignore