Hitelesítés, API-kulcsok és szervezetek
Ezen az oldalon
Hitelesítés, API-kulcsok és szervezetek
Mielőtt egyetlen sor kódot is írnál, konfigurálnod kell az API-hozzáférésedet. Ez a lecke bemutatja a kulcsok létrehozását, a hozzáférés szervezeteken és projekteken keresztüli strukturálását, valamint azokat a biztonsági óvintézkedéseket, amelyek megakadályozzák a klasszikus rémálmot: hogy véletlenül feltölts egy kulcsot egy nyilvános tárolóba, ahol egy idegen éjszaka alatt elhasználja azt.
Fiók létrehozása és kulcs igénylése
A folyamat három lépésből áll. Először látogass el a platform.openai.com oldalra, és hozz létre egy fiókot; automatikusan ingyenes jóváírást kapsz a kísérletezés megkezdéséhez. Ezután navigálj a vezérlőpult API Keys (API-kulcsok) szekciójához, és generálj egy új kulcsot. Ezt a kulcsot csak egyszer fogod látni: azonnal másold ki, de ne illeszd be közvetlenül a kódodba.
# Az API-kulcsod így néz ki (soha ne oszd meg!)
# sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# Legjobb gyakorlat: környezeti változó használata
import os
api_key = os.environ.get("OPENAI_API_KEY")
A harmadik lépés a környezeti változó deklarálása, amely a platformodtól függ. Fejlesztői gépen gyakran a python-dotenv által betöltött .env fájl a legkényelmesebb megoldás. Szerveren inkább az orchestrátorod vagy titokkezelő szolgáltatásod által definiált környezeti változót részesítsd előnyben.
# Linux / macOS — add hozzá a ~/.bashrc vagy ~/.zshrc fájlhoz
export OPENAI_API_KEY="sk-proj-your-key-here"
# Windows PowerShell
$env:OPENAI_API_KEY = "sk-proj-your-key-here"
# .env fájl (python-dotenv használatával)
# .env
OPENAI_API_KEY=sk-proj-your-key-here
Melyik kulcstípust válasszd?
A projektkulcsok, amelyek sk-proj- előtagjukkal azonosíthatók, egy adott projekthez vannak kötve, és a legjobb kontrollt kínálják. Szinte minden esetben ezeket fogod használni. Az SDK automatikusan felismeri őket, amint a környezeti változó be van állítva; ezért instantiated az OpenAI() hívás argumentumok nélkül minden példában ebben a tanfolyamban.
from openai import OpenAI
# Az SDK automatikusan érzékeli az OPENAI_API_KEY változót
client = OpenAI()
# Vagy megadhatod explicit módon (nem ajánlott éles környezetben)
client = OpenAI(api_key="sk-proj-...")
A szolgáltatáskulcsok a második típust képviselik. Kiemelt hozzáférést igénylő szerveralkalmazásokhoz tervezték őket; további engedélyeket biztosítanak, ezért fokozott gondosságot igényelnek: tárold őket titokkezelő széfben, és soha ne terjeszd az értéküket fejlesztői munkagépekre.
Szervezetek és projektek
A hozzáférés három egymásba ágyazott szinten strukturálódik:
- Szervezet: A céged vagy csapatod
- Projekt: Logikai csoportosítás (pl. „Éles Csevegőbot“, „Adatelemzés“)
- API-kulcs: Egy adott projekthez kapcsolódik
Ha több szervezethez is tartozol, add meg azt, amelyet használni szeretnél, amikor példányosítod a klienst:
from openai import OpenAI
# Szervezet megadása (hasznos, ha többhöz is tartozol)
client = OpenAI(
organization="org-xxxxxxxxxxxx",
project="proj-xxxxxxxxxxxx"
)
Szánj időt arra, hogy használatodat projektekre bontsd, ahelyett, hogy mindent egyetlen kulcson keresztül irányítanál. Az előnyeit már az első probléma jelénél meglátod. Minden projektnek saját használati nyomon követése van, így a költségeket egy adott funkcióhoz rendelheted hozzá, nem pedig egy átláthatatlan havi összeghez. A sebességkorlátok is szétválasztásra kerülnek: egy éjszakai kötegelt feladat, amely telíti a kvótáját, nem akadályozza meg a csevegőbotodat abban, hogy válaszoljon az ügyfeleknek. Ezután különböző tagokat rendelhetsz minden projekthez, és ami a legfontosabb: visszavonhatsz egy kompromittálódott kulcsot anélkül, hogy megszakítanád a többi alkalmazás működését.
Soha ne tedd közzé a kulcsaidat
A szabály egyszerű és abszolút: kulcs soha nem szerepelhet a forráskódban. Az alábbi két kódrészlet közötti kontraszt beszédesebb, mint egy hosszú előadás.
# ROSSZ — keménykódolt kulcs a kódban
client = OpenAI(api_key="sk-proj-abc123") # VESZÉLY!
# JÓ — környezeti változó
client = OpenAI() # Automatikusan beolvassa az OPENAI_API_KEY értéket
# JÓ — .env fájl python-dotenv használatával
from dotenv import load_dotenv
load_dotenv()
client = OpenAI()
Ennek következménye a .gitignore fájlra vonatkozik: a helyi konfigurációs fájlokat ki kell zárnia még az első commit előtt, nem utána. Egy közzétett, majd törölt kulcs továbbra is jelen marad a tároló előzményeiben.
# MINDIG add hozzá ezeket a sorokat a .gitignore fájlodhoz
.env
.env.local
.env.production
*.key
Végül tervezz meg rendszeres kulcscserét, 90 naponta. Ezt állásidő nélkül is megteheted: hozz létre egy új kulcsot, frissítsd a telepítéseidet, és csak akkor töröld a régit, ha már semmi sem használja.
Konfiguráció ellenőrzése
Mielőtt továbblépnél, futtasd le ezt a szkriptet. Ellenőrzi a kulcs jelenlétét, megjelenít egy csonkolt verziót a megerősítéshez, hogy a megfelelő kulcsról van-e szó, majd végrehajt egy valós hívást. Futtasd újra ezt a tesztet, amikor egy környezet furcsán viselkedik.
from openai import OpenAI
import os
def verify_configuration():
"""Ellenőrzi, hogy az API-konfiguráció helyes-e."""
# Kulcs ellenőrzése
api_key = os.environ.get("OPENAI_API_KEY")
if not api_key:
print("HIBA: Az OPENAI_API_KEY nincs definiálva")
return False
print(f"Kulcs észlelve: {api_key[:8]}...{api_key[-4:]}")
# Kapcsolat tesztelése
try:
client = OpenAI()
response = client.responses.create(
model="gpt-5.6-terra",
input="Reply only: OK"
)
print(f"Kapcsolat sikeres: {response.output_text}")
return True
except Exception as e:
print(f"Kapcsolati HIBA: {e}")
return False
verify_configuration()
# Várt eredmény:
# Kulcs észlelve: sk-proj-...xxxx
# Kapcsolat sikeres: OK
Főbb megállapítások
- Használj projektkulcsokat (
sk-proj-...) minden alkalmazáshoz - Tárold a kulcsaidat környezeti változókban, soha ne a kódban
- Szervezd meg a hozzáférésedet a Szervezet → Projekt → Kulcs hierarchia szerint
- Végezz rendszeres kulcscserét (90 naponta)
- Mindig add hozzá a
.envfájlt a.gitignorelistádhoz