Godkendelse, API-nøgler og organisation
På denne side
Godkendelse, API-nøgler og organisation
Før du skriver en eneste linje kode, skal du konfigurere din API-adgang. Denne lektion dækker oprettelse af nøgler, strukturering af adgang gennem organisationer og projekter samt de sikkerhedsforanstaltninger, der forhindrer det klassiske mareridt: utilsigtet at push’e en nøgle til et offentligt repository, hvor en fremmed kan misbruge den over natten.
Opret din konto og få en nøgle
Processen tager tre trin. Gå først til platform.openai.com og opret en konto; du modtager automatisk gratis kredit til at starte eksperimentering. Naviger derefter til sektionen API Keys i dashboardet og generér en ny nøgle. Du ser kun denne nøgle én gang: kopier den straks, men indsæt den ikke i din kode.
# Din API-nøgle ser sådan ud (del den aldrig!)
# sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# Bedste praksis: brug en miljøvariabel
import os
api_key = os.environ.get("OPENAI_API_KEY")
Det tredje trin er at deklarere miljøvariablen, hvilket afhænger af din platform. På en udviklingsmaskine er en .env-fil, der indlæses af python-dotenv, ofte den mest bekvemme løsning. På en server bør du foretrække en miljøvariabel defineret af din orchestrator eller secrets-service.
# Linux / macOS — tilføj til ~/.bashrc eller ~/.zshrc
export OPENAI_API_KEY="sk-proj-your-key-here"
# Windows PowerShell
$env:OPENAI_API_KEY = "sk-proj-your-key-here"
# .env fil (med python-dotenv)
# .env
OPENAI_API_KEY=sk-proj-your-key-here
Hvilken nøgletype skal du vælge?
Projektnøgler, der kan identificeres ved deres sk-proj--præfiks, er knyttet til et specifikt projekt og giver den bedste kontrol. Du vil bruge disse i næsten alle tilfælde. SDK’en registrerer dem automatisk, når miljøvariablen er sat, hvilket er grunden til, at OpenAI() instantieres uden argumenter i alle eksempler i dette kursus.
from openai import OpenAI
# SDK'en registrerer automatisk OPENAI_API_KEY
client = OpenAI()
# Eller angiv eksplicit (anbefales ikke til produktion)
client = OpenAI(api_key="sk-proj-...")
Servicenøgler er den anden type. De er designet til serverapplikationer, der kræver udvidet adgang, giver yderligere tilladelser og kræver derfor ekstra omhu: opbevar dem i en secrets-vault og distribuer aldrig deres værdi til en udviklingsworkstation.
Organisationer og projekter
Adgangen er struktureret på tre nestede niveauer:
- Organisation: Din virksomhed eller dit team
- Projekt: En logisk gruppering (f.eks. „Produktionschatbot”, „Dataanalyse”)
- API-nøgle: Linket til et specifikt projekt
Hvis du tilhører flere organisationer, skal du angive den, du har til hensigt at bruge, når du instantierer klienten:
from openai import OpenAI
# Angiv organisationen (nyttigt hvis du tilhører flere)
client = OpenAI(
organization="org-xxxxxxxxxxxx",
project="proj-xxxxxxxxxxxx"
)
Tag dig tid til at opdele dit forbrug i projekter i stedet for at rute alt gennem en enkelt nøgle. Du vil se fordelen ved det første tegn på problemer. Hvert projekt har sin egen forbrugsovervågning, så du kan tilskrive omkostninger til en specifik funktion frem for et uigennemsigtigt månedligt totalbeløb. Rate limits er også adskilt: et natligt batch-job, der mætter sin kvote, vil ikke forhindre din chatbot i at svare kunder. Du kan derefter tildele forskellige medlemmer til hvert projekt, og vigtigst af alt, tilbagekalde en kompromitteret nøgle uden at afbryde andre applikationer.
Eksponér aldrig dine nøgler
Reglen er enkel og absolut: en nøgle må aldrig optræde i kildekoden. Kontrasten mellem de to uddrag nedenfor taler højere end en lang forelæsning.
# DÅRLIGT — hardcodet nøgle i koden
client = OpenAI(api_key="sk-proj-abc123") # FARE!
# GODT — miljøvariabel
client = OpenAI() # Læser automatisk OPENAI_API_KEY
# GODT — .env fil med python-dotenv
from dotenv import load_dotenv
load_dotenv()
client = OpenAI()
Konsekvensen vedrører din .gitignore, som skal ekskludere lokale konfigurationsfiler før dit første commit, ikke bagefter. En nøgle, der publiceres og derefter slettes, forbliver til stede i repository-historikken.
# TILFØJ ALTID disse linjer til din .gitignore
.env
.env.local
.env.production
*.key
Planlæg endelig regelmæssig rotation, hver 90. dag. Du kan gøre dette uden nedetid: opret en ny nøgle, opdater dine deployments, og slet derefter den gamle, først når intet længere bruger den.
Verificér din konfiguration
Før du går videre, skal du køre dette script. Det tjekker tilstedeværelsen af nøglen, viser en trunkeret version for at bekræfte, at det er den rigtige, og foretager derefter et rigtigt kald. Genkør denne test, når et miljø opfører sig mærkeligt.
from openai import OpenAI
import os
def verify_configuration():
"""Verificér at API-konfigurationen er korrekt."""
# Tjek for nøglen
api_key = os.environ.get("OPENAI_API_KEY")
if not api_key:
print("FEJL: OPENAI_API_KEY ikke defineret")
return False
print(f"Nøgle registreret: {api_key[:8]}...{api_key[-4:]}")
# Test forbindelsen
try:
client = OpenAI()
response = client.responses.create(
model="gpt-5.6-terra",
input="Reply only: OK"
)
print(f"Forbindelse succesfuld: {response.output_text}")
return True
except Exception as e:
print(f"ForbindelsesFEJL: {e}")
return False
verify_configuration()
# Forventet resultat:
# Nøgle registreret: sk-proj-...xxxx
# Forbindelse succesfuld: OK
Vigtige pointer
- Brug projektnøgler (
sk-proj-...) til hver applikation - Opbevar dine nøgler i miljøvariabler, aldrig i koden
- Organisér din adgang med hierarkiet Organisation → Projekt → Nøgle
- Udfør regelmæssig rotation af dine nøgler (hver 90. dag)
- Tilføj altid
.envtil din.gitignore