Authentifizierung, API-Schlüssel und Organisation
Auf dieser Seite
Authentifizierung, API-Schlüssel und Organisation
Bevor Sie die erste Zeile Code schreiben, müssen Sie Ihren API-Zugang konfigurieren. Diese Lektion behandelt die Erstellung von Schlüsseln, die Strukturierung des Zugriffs über Organisationen und Projekte sowie die Sicherheitsvorkehrungen, die den klassischen Albtraum verhindern: den versehentlichen Upload eines Schlüssels in ein öffentliches Repository, in dem ihn ein Fremder über Nacht verbraucht.
Konto erstellen und Schlüssel erhalten
Der Prozess besteht aus drei Schritten. Gehen Sie zunächst zu platform.openai.com und erstellen Sie ein Konto; Sie erhalten automatisch Guthaben, um mit Experimenten zu beginnen. Navigieren Sie im Anschluss zum Bereich API Keys im Dashboard und generieren Sie einen neuen Schlüssel. Sie sehen diesen Schlüssel nur einmal: Kopieren Sie ihn sofort, aber fügen Sie ihn nicht in Ihren Code ein.
# Ihr API-Schlüssel sieht so aus (teilen Sie ihn niemals!)
# sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# Best Practice: Verwenden Sie eine Umgebungsvariable
import os
api_key = os.environ.get("OPENAI_API_KEY")
Der dritte Schritt besteht darin, die Umgebungsvariable zu deklarieren, was von Ihrer Plattform abhängt. Auf einer Entwicklungsmaschine ist eine .env-Datei, die von python-dotenv geladen wird, oft die bequemste Lösung. Auf einem Server bevorzugen Sie eine Umgebungsvariable, die von Ihrem Orchestrierungs- oder Geheimnisdienst definiert wird.
# Linux / macOS — fügen Sie dies zu ~/.bashrc oder ~/.zshrc hinzu
export OPENAI_API_KEY="sk-proj-your-key-here"
# Windows PowerShell
$env:OPENAI_API_KEY = "sk-proj-your-key-here"
# .env-Datei (mit python-dotenv)
# .env
OPENAI_API_KEY=sk-proj-your-key-here
Welchen Schlüsseltyp wählen?
Projektschlüssel, erkennbar am Präfix sk-proj-, sind an ein bestimmtes Projekt gebunden und bieten die beste Kontrolle. Sie werden in fast jedem Fall diese verwenden. Das SDK erkennt sie automatisch, sobald die Umgebungsvariable gesetzt ist, weshalb OpenAI() in allen Beispielen dieses Kurses ohne Argumente instanziiert wird.
from openai import OpenAI
# Das SDK erkennt OPENAI_API_KEY automatisch
client = OpenAI()
# Oder explizit angeben (nicht für die Produktion empfohlen)
client = OpenAI(api_key="sk-proj-...")
Service-Schlüssel sind der zweite Typ. Sie sind für Serveranwendungen konzipiert, die erweiterten Zugriff benötigen, gewähren zusätzliche Berechtigungen und erfordern daher besondere Vorsicht: Speichern Sie sie in einem Secrets-Vault und verteilen Sie ihren Wert niemals auf eine Entwicklungsmaschine.
Organisationen und Projekte
Der Zugriff ist über drei verschachtelte Ebenen strukturiert:
- Organisation: Ihr Unternehmen oder Ihre Mannschaft
- Projekt: Eine logische Gruppierung (z. B. “Produktions-Chatbot”, “Datenanalyse”)
- API-Schlüssel: Verknüpft mit einem bestimmten Projekt
Falls Sie mehreren Organisationen angehören, geben Sie diejenige an, die Sie verwenden möchten, wenn Sie den Client instanziiieren:
from openai import OpenAI
# Geben Sie die Organisation an (nützlich, wenn Sie mehreren angehören)
client = OpenAI(
organization="org-xxxxxxxxxxxx",
project="proj-xxxxxxxxxxxx"
)
Nehmen Sie sich Zeit, Ihren Einsatz in Projekte aufzuteilen, anstatt alles über einen einzigen Schlüssel zu leiten. Sie werden den Nutzen bereits beim ersten Anzeichen von Problemen erkennen. Jedes Projekt verfügt über eine eigene Nutzungsnachverfolgung, die es Ihnen ermöglicht, Kosten einer bestimmten Funktion zuzuordnen, anstatt eine undurchsichtige monatliche Gesamtsumme zu erhalten. Auch die Ratenbegrenzungen sind getrennt: Eine nächtliche Batch-Verarbeitung, die ihre Quote erschöpft, wird verhindern, dass Ihr Chatbot auf Kundenanfragen reagiert. Sie können dann verschiedenen Mitgliedern jedes Projekt zuweisen und vor allem einen kompromittierten Schlüssel widerrufen, ohne andere Anwendungen zu unterbrechen.
Schlüssel niemals offenzulegen
Die Regel ist einfach und absolut: Ein Schlüssel darf niemals im Quellcode erscheinen. Der Kontrast zwischen den beiden untenstehenden Codeausschnitten spricht lauter als eine lange Vorlesung.
# SCHLECHT — hartercodeder Schlüssel im Code
client = OpenAI(api_key="sk-proj-abc123") # GEFAHR!
# GUT — Umgebungsvariable
client = OpenAI() # Liest automatisch OPENAI_API_KEY
# GUT — .env-Datei mit python-dotenv
from dotenv import load_dotenv
load_dotenv()
client = OpenAI()
Die Folgerung betrifft Ihr .gitignore, das lokale Konfigurationsdateien vor dem ersten Commit ausschließen muss, nicht danach. Ein Schlüssel, der veröffentlicht und dann gelöscht wurde, bleibt in der Repository-Geschichte erhalten.
# Fügen Sie diese Zeilen immer zu Ihrem .gitignore hinzu
.env
.env.local
.env.production
*.key
Planen Sie zudem eine regelmäßige Rotation, alle 90 Tage. Dies können Sie ohne Ausfallzeiten durchführen: Erstellen Sie einen neuen Schlüssel, aktualisieren Sie Ihre Bereitstellungen und löschen Sie den alten erst, sobald nichts ihn mehr verwendet.
Konfiguration verifizieren
Bevor Sie fortfahren, führen Sie dieses Skript aus. Es prüft das Vorhandensein des Schlüssels, zeigt eine verkürzte Version an, um zu bestätigen, dass es der richtige ist, und führt dann einen echten Aufruf durch. Führen Sie diesen Test erneut aus, wenn sich ein Verhalten in einer Umgebung seltsam verhält.
from openai import OpenAI
import os
def verify_configuration():
"""Verifiziert, dass die API-Konfiguration korrekt ist."""
# Prüfen auf den Schlüssel
api_key = os.environ.get("OPENAI_API_KEY")
if not api_key:
print("FEHLER: OPENAI_API_KEY nicht definiert")
return False
print(f"Schlüssel erkannt: {api_key[:8]}...{api_key[-4:]}")
# Verbindung testen
try:
client = OpenAI()
response = client.responses.create(
model="gpt-5.6-terra",
input="Reply only: OK"
)
print(f"Verbindung erfolgreich: {response.output_text}")
return True
except Exception as e:
print(f"VerbindungsFEHLER: {e}")
return False
verify_configuration()
# Erwartetes Ergebnis:
# Schlüssel erkannt: sk-proj-...xxxx
# Verbindung erfolgreich: OK
Kernaussagen
- Verwenden Sie Projektschlüssel (
sk-proj-...) für jede Anwendung - Speichern Sie Ihre Schlüssel in Umgebungsvariablen, niemals im Code
- Organisieren Sie Ihren Zugriff mit der Hierarchie Organisation → Projekt → Schlüssel
- Führen Sie eine regelmäßige Rotation Ihrer Schlüssel durch (alle 90 Tage)
- Fügen Sie
.envimmer zu Ihrem.gitignorehinzu