1. Brug altid en unik API-nøgle til hvert teammedlem på din konto.

En API-nøgle er en unik kode, der identificerer dine anmodninger til API'en. Din API-nøgle er beregnet til at blive brugt af dig. Deling af API-nøgler er i strid med vilkår for brug.

Når du begynder at eksperimentere, vil du måske udvide API-adgangen til dit team. OpenAI understøtter ikke deling af API-nøgler. Inviter nye medlemmer til din konto fra siden Medlemmer, så modtager de hurtigt deres egen unikke nøgle, når de logger ind. Du kan også tildele tilladelser til individuelle API-nøgler.

2. Udrul aldrig din nøgle i miljøer på klientsiden som browsere eller mobilapps.

Hvis din OpenAI API-nøgle eksponeres i miljøer på klientsiden som browsere eller mobilapps, kan ondsindede brugere tage nøglen og foretage anmodninger på dine vegne – hvilket kan føre til uventede opkrævninger eller kompromittering af visse kontodata. Anmodninger bør altid dirigeres via din egen backend-server, hvor du kan holde din API-nøgle sikker.

3. Commit aldrig din nøgle til dit lager

At committe en API-nøgle til kildekode er en almindelig vej til kompromittering af legitimationsoplysninger. For dem med offentlige lagre er dette en almindelig måde, hvorpå du uforvarende kan dele din nøgle med internettet. Private lagre er mere sikre, men et databrud kan også medføre, at dine nøgler lækkes. Af disse årsager anbefaler vi på det kraftigste at bruge miljøvariabler som en proaktiv sikkerhedsforanstaltning for nøgler.

4. Brug miljøvariabler i stedet for din API-nøgle

En miljøvariabel er en variabel, der indstilles i dit operativsystem i stedet for i din applikation. Den består af et navn og en værdi. Vi anbefaler, at du kalder variablen OPENAI_API_KEY. Ved at bruge det samme variabelnavn i hele teamet kan I gemme og dele jeres kode uden risiko for at eksponere jeres API-nøgle.

Opsætning i Windows

Mulighed 1: Indstil miljøvariablen »OPENAI_API_KEY« via kommandoprompten

Kør følgende i kommandoprompten, og erstat <yourkey> med din API-nøgle:

setx OPENAI_API_KEY "<yourkey>"

Dette gælder for fremtidige kommandopromptvinduer, så du skal åbne et nyt for at bruge variablen med curl. Du kan kontrollere, at variablen er indstillet, ved at åbne et nyt kommandopromptvindue og skrive

echo %OPENAI_API_KEY%

Mulighed 2: Indstil miljøvariablen »OPENAI_API_KEY« via Kontrolpanel

Åbn egenskaberne for System, og vælg Avancerede systemindstillinger

Windows 10 System settings with Advanced system settings highlighted in Control Panel

Vælg Miljøvariabler...

Windows System Properties Advanced tab with Environment Variables button highlighted

Vælg Ny… i sektionen Brugervariabler (øverst). Tilføj dit navn/værdi-par, og erstat <yourkey> med din API-nøgle.

Variabelnavn: OPENAI_API_KEY
Variabelværdi: <yourkey>

Opsætning i Linux/macOS

Mulighed 1: Indstil miljøvariablen »OPENAI_API_KEY« med zsh

Kør følgende kommando i din terminal, og erstat yourkey med din API-nøgle.

echo "export OPENAI_API_KEY='yourkey'" >> ~/.zshrc

Opdater shellen med den nye variabel:

source ~/.zshrc

Bekræft, at du har angivet din miljøvariabel, med følgende kommando.

echo $OPENAI_API_KEY

Værdien af din API-nøgle vil være det resulterende output.

Mulighed 2: Angiv miljøvariablen ‘OPENAI_API_KEY’ med bash

Følg vejledningen i mulighed 1, men erstat .zshrc med .bash_profile.

Så er du klar! Du kan nu henvise til nøglen i curl eller indlæse den i din Python:

import os
import openai
 
openai.api_key = os.environ["OPENAI_API_KEY"]

5. Brug en nøgleadministrationstjeneste

Der findes en række produkter til sikker administration af hemmelige API-nøgler. Disse værktøjer giver dig mulighed for at styre adgangen til dine nøgler og forbedre din overordnede datasikkerhed. I tilfælde af et databrud i din applikation vil dine nøgler ikke blive kompromitteret, da de vil være krypteret og administreret på et helt separat sted.

For teams, der udruller deres applikationer i produktion, anbefaler vi, at I overvejer en af disse tjenester.

6. Overvåg forbruget på din konto, og udskift dine nøgler efter behov

En kompromitteret API-nøgle giver andre adgang til din kontos kvote uden dit samtykke. Det kan medføre datatab, uventede gebyrer, opbrug af din månedlige kvote og afbrydelse af din API-adgang.

Dit teams forbrug kan følges på siden Forbrug. Hvis du er bekymret for misbrug, kan du beskytte din konto på flere måder:

Gennemgå dit forbrug for at se, om det stemmer overens med dit teams arbejde. Brugere, der tilhører flere organisationer (f.eks. en arbejdsrelateret og en privat), skal sørge for, at sporing er aktiveret, og at deres standardorganisation for forbrug og sporing er angivet.
Hvis du tror, at din nøgle er blevet lækket, skal du straks udskifte den på siden API-nøgler. Kunder med applikationer i produktion skal opdatere deres nøgleværdier tilsvarende.
Kontakt os via help.openai.com, så vi kan undersøge sagen nærmere.

7. Begræns API-adgang med IP-allowlisting

IP-allowlisting giver dig mulighed for at begrænse, hvilke IP-adresser der kan få adgang til din OpenAI API. Når det er aktiveret, tillades kun anmodninger fra konfigurerede IP-adresser eller -intervaller, og alle andre afvises – også selvom de indeholder en gyldig API-nøgle.

Dette tilføjer et ekstra beskyttelseslag ved at sikre, at din API kun kan tilgås fra pålidelig infrastruktur, såsom dine backend-servere eller dit cloudmiljø.

Du kan få flere oplysninger i artiklen om IP-allowlisting for OpenAI API.

Bedste praksis for sikker API-nøglebrug