Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Authenticatie, API-sleutels en organisatie

Les 3 van 22 Bijgewerkt op 29 juli 2026 Ontwikkelaar
Op deze pagina
  1. Authenticatie, API-sleutels en organisatie
  2. Maak uw account aan en ontvang een sleutel
  3. Welk type sleutel u moet kiezen
  4. Organisaties en projecten
  5. Stel uw sleutels nooit bloot
  6. Verifieer uw configuratie
  7. Belangrijkste punten

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:

  1. Organisatie: Uw bedrijf of team
  2. Project: Een logische groepering (bijv. “Production Chatbot”, “Data Analysis”)
  3. 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 .env altijd toe aan uw .gitignore