Authenticatie, API-sleutels en organisatie
Op deze pagina
Authenticatie, API-sleutels en organisatie
Voordat u ook maar één regel code schrijft, moet u uw API-toegang configureren. Deze les behandelt het aanmaken van sleutels, het structureren van toegang via organisaties en projecten, en de veiligheidsmaatregelen die de klassieke nachtmerrie voorkomen: het per ongeluk pushen van een sleutel naar een openbare repository, waar een vreemde deze ‘s nachts misbruikt.
Maak uw account aan en ontvang een sleutel
Het proces bestaat uit drie stappen. Ga eerst naar platform.openai.com en maak een account aan; u ontvangt automatisch gratis credits om mee te experimenteren. Navigeer vervolgens naar het gedeelte API Keys van het dashboard en genereer een nieuwe sleutel. U ziet deze sleutel slechts één keer: kopieer deze onmiddellijk, maar plak hem niet in uw code.
# Uw API-sleutel ziet er zo uit (deel deze nooit!)
# sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# Best practice: gebruik een omgevingsvariabele
import os
api_key = os.environ.get("OPENAI_API_KEY")
De derde stap is het declareren van de omgevingsvariabele, wat afhangt van uw platform. Op een ontwikkelmachine is een .env-bestand dat door python-dotenv wordt geladen, vaak het handigst. Op een server geeft u de voorkeur aan een omgevingsvariabele die door uw orchestrator of secrets-service is gedefinieerd.
# Linux / macOS — toevoegen aan ~/.bashrc of ~/.zshrc
export OPENAI_API_KEY="sk-proj-your-key-here"
# Windows PowerShell
$env:OPENAI_API_KEY = "sk-proj-your-key-here"
# .env bestand (met python-dotenv)
# .env
OPENAI_API_KEY=sk-proj-your-key-here
Welk type sleutel u moet kiezen
Projectsleutels, herkenbaar aan hun sk-proj--prefix, zijn gekoppeld aan een specifiek project en bieden de beste controle. In bijna elk geval zult u deze gebruiken. De SDK detecteert ze automatisch zodra de omgevingsvariabele is ingesteld, daarom wordt OpenAI() in alle voorbeelden in deze cursus zonder argumenten geïnstantieerd.
from openai import OpenAI
# De SDK detecteert OPENAI_API_KEY automatisch
client = OpenAI()
# Of expliciet opgeven (niet aanbevolen voor productie)
client = OpenAI(api_key="sk-proj-...")
Servicesleutels zijn het tweede type. Ontworpen voor servertoepassingen die verhoogde toegang vereisen, verlenen ze extra rechten en vragen ze daarom extra zorg: bewaar ze in een secrets-vault en verspreid hun waarde nooit naar een ontwikkelwerkstation.
Organisaties en projecten
Toegang is gestructureerd over drie geneste niveaus:
- Organisatie: Uw bedrijf of team
- Project: Een logische groepering (bijv. “Production Chatbot”, “Data Analysis”)
- API-sleutel: Gekoppeld aan een specifiek project
Als u tot meerdere organisaties behoort, geeft u bij het instantiëren van de client aan welke u wilt gebruiken:
from openai import OpenAI
# Geef de organisatie op (handig als u tot meerdere behoort)
client = OpenAI(
organization="org-xxxxxxxxxxxx",
project="proj-xxxxxxxxxxxx"
)
Neem de tijd om uw gebruik op te splitsen in projecten in plaats van alles via één sleutel te laten lopen. U ziet het voordeel bij het eerste teken van problemen. Elk project heeft zijn eigen gebruikstracking, zodat u kosten kunt toewijzen aan een specifieke functie in plaats van aan een ondoorzichtig maandtotaal. Ratelimits zijn ook gescheiden: een nachtelijke batchjob die zijn quota volmaakt, verhindert niet dat uw chatbot reageert op klanten. Vervolgens kunt u verschillende leden aan elk project toewijzen en, cruciaal, een gecompromitteerde sleutel intrekken zonder andere applicaties te onderbreken.
Stel uw sleutels nooit bloot
De regel is eenvoudig en absoluut: een sleutel verschijnt nooit in broncode. Het contrast tussen de twee onderstaande fragmenten spreekt luider dan een lange lezing.
# SLECHT — hardcoded sleutel in code
client = OpenAI(api_key="sk-proj-abc123") # GEVAAR!
# GOED — omgevingsvariabele
client = OpenAI() # Leest automatisch OPENAI_API_KEY
# GOED — .env bestand met python-dotenv
from dotenv import load_dotenv
load_dotenv()
client = OpenAI()
Het gevolg hiervan betreft uw .gitignore, dat lokale configuratiebestanden moet uitsluiten vóór uw eerste commit, niet erna. Een sleutel die eenmaal gepubliceerd en vervolgens verwijderd is, blijft aanwezig in de repository-geschiedenis.
# Voeg ALTIJD deze regels toe aan uw .gitignore
.env
.env.local
.env.production
*.key
Plan tot slot regelmatige rotatie, elke 90 dagen. U kunt dit doen zonder downtime: maak een nieuwe sleutel aan, werk uw deployments bij en verwijder de oude sleutel pas wanneer niets deze meer gebruikt.
Verifieer uw configuratie
Voordat u verdergaat, voert u dit script uit. Het controleert de aanwezigheid van de sleutel, toont een ingekorte versie om te bevestigen dat het de juiste is, en doet vervolgens een echte oproep. Voer deze test opnieuw uit wanneer een omgeving zich vreemd gedraagt.
from openai import OpenAI
import os
def verify_configuration():
"""Verifieer dat de API-configuratie correct is."""
# Controleer op de sleutel
api_key = os.environ.get("OPENAI_API_KEY")
if not api_key:
print("ERROR: OPENAI_API_KEY not defined")
return False
print(f"Key detected: {api_key[:8]}...{api_key[-4:]}")
# Test de verbinding
try:
client = OpenAI()
response = client.responses.create(
model="gpt-5.6-terra",
input="Reply only: OK"
)
print(f"Connection successful: {response.output_text}")
return True
except Exception as e:
print(f"Connection ERROR: {e}")
return False
verify_configuration()
# Verwacht resultaat:
# Key detected: sk-proj-...xxxx
# Connection successful: OK
Belangrijkste punten
- Gebruik projectsleutels (
sk-proj-...) voor elke applicatie - Bewaar uw sleutels in omgevingsvariabelen, nooit in code
- Organiseer uw toegang met de hiërarchie Organisatie → Project → Sleutel
- Voer regelmatige rotatie van uw sleutels uit (elke 90 dagen)
- Voeg
.envaltijd toe aan uw.gitignore