Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Hitelesítés, API-kulcsok és szervezetek

3. lecke 22 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. Hitelesítés, API-kulcsok és szervezetek
  2. Fiók létrehozása és kulcs igénylése
  3. Melyik kulcstípust válasszd?
  4. Szervezetek és projektek
  5. Soha ne tedd közzé a kulcsaidat
  6. Konfiguráció ellenőrzése
  7. Főbb megállapítások

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:

  1. Szervezet: A céged vagy csapatod
  2. Projekt: Logikai csoportosítás (pl. „Éles Csevegőbot“, „Adatelemzés“)
  3. 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 .env fájlt a .gitignore listádhoz