1. Gebruik altijd een unieke API-sleutel voor elk teamlid op je account.
Een API-sleutel is een unieke code die je verzoeken aan de API identificeert. Je API-sleutel is bedoeld om door jou te worden gebruikt. Het delen van API-sleutels is in strijd met de gebruiksvoorwaarden.
Wanneer je begint te experimenteren, wil je de API-toegang mogelijk uitbreiden naar je team. OpenAI ondersteunt het delen van API-sleutels niet. Nodig nieuwe leden uit voor je account via de pagina Leden; zij ontvangen na aanmelding snel hun eigen unieke sleutel. Je kunt ook machtigingen toewijzen aan afzonderlijke API-sleutels.
2. Implementeer je sleutel nooit in client-side omgevingen zoals browsers of mobiele apps.
Als je je OpenAI API-sleutel blootstelt in client-side omgevingen zoals browsers of mobiele apps, kunnen kwaadwillende gebruikers die sleutel gebruiken om namens jou verzoeken te doen. Dit kan leiden tot onverwachte kosten of het compromitteren van bepaalde accountgegevens. Verzoeken moeten altijd via je eigen backendserver worden geleid, waar je je API-sleutel veilig kunt bewaren.
3. Commit je sleutel nooit naar je repository
Het committen van een API-sleutel naar broncode is een veelvoorkomende manier waarop inloggegevens worden gecompromitteerd. Voor wie openbare repositories heeft, is dit een veelvoorkomende manier waarop je je sleutel onbedoeld met het internet kunt delen. Privérepositories zijn veiliger, maar een datalek kan er ook toe leiden dat je sleutels uitlekken. Om deze redenen raden we sterk aan om omgevingsvariabelen te gebruiken als proactieve veiligheidsmaatregel voor sleutels.
4. Gebruik omgevingsvariabelen in plaats van je API-sleutel
Een omgevingsvariabele is een variabele die in je besturingssysteem wordt ingesteld in plaats van in je applicatie. Deze bestaat uit een naam en een waarde. We raden aan de variabele de naam OPENAI_API_KEY te geven. Door binnen je team steeds dezelfde variabelenaam te gebruiken, kun je je code vastleggen en delen zonder het risico dat je API-sleutel openbaar wordt.
Configuratie voor Windows
Optie 1: Stel de omgevingsvariabele 'OPENAI_API_KEY' in via de cmd-prompt
Voer het volgende uit in de cmd-prompt en vervang <yourkey> door je API-sleutel:
setx OPENAI_API_KEY "<yourkey>"Dit geldt voor toekomstige cmd-promptvensters. Je moet dus een nieuw venster openen om die variabele met curl te gebruiken. Je kunt controleren of deze variabele is ingesteld door een nieuw cmd-promptvenster te openen en het volgende in te voeren
echo %OPENAI_API_KEY%Optie 2: Stel de omgevingsvariabele 'OPENAI_API_KEY' in via het Configuratiescherm
Open de eigenschappen van Systeem en selecteer Geavanceerde systeeminstellingen
Selecteer Omgevingsvariabelen...
Selecteer Nieuw… in het gedeelte Gebruikersvariabelen (bovenaan). Voeg de combinatie van naam en sleutelwaarde toe en vervang <yourkey> door je API-sleutel.
Variabelenaam: OPENAI_API_KEY
Variabelewaarde: <yourkey>Configuratie voor Linux/macOS
Optie 1: Stel de omgevingsvariabele 'OPENAI_API_KEY' in met zsh
Voer de volgende opdracht uit in je terminal en vervang yourkey door je API-sleutel.
echo "export OPENAI_API_KEY='yourkey'" >> ~/.zshrcWerk de shell bij met de nieuwe variabele:
source ~/.zshrcBevestig met de volgende opdracht dat je je omgevingsvariabele hebt ingesteld.
echo $OPENAI_API_KEYDe waarde van je API-sleutel is de resulterende uitvoer.
Optie 2: Stel je omgevingsvariabele ‘OPENAI_API_KEY’ in met bash
Volg de instructies in optie 1 en vervang .zshrc door .bash_profile.
Je bent klaar! Je kunt nu naar de sleutel verwijzen in curl of deze laden in je Python:
import os
import openai
openai.api_key = os.environ["OPENAI_API_KEY"]5. Gebruik een Key Management Service
Er zijn verschillende producten beschikbaar om geheime API-sleutels veilig te beheren. Met deze tools kun je de toegang tot je sleutels beheren en je algehele gegevensbeveiliging verbeteren. Bij een datalek in je applicatie zouden je sleutel(s) niet worden gecompromitteerd, omdat ze versleuteld en op een volledig aparte locatie beheerd zouden worden.
Voor teams die hun applicaties in productie implementeren, raden we aan een van deze diensten te overwegen.
6. Houd je accountgebruik bij en vervang je sleutels wanneer dat nodig is
Met een gecompromitteerde API-sleutel kan iemand zonder jouw toestemming toegang krijgen tot het quotum van je account. Dit kan leiden tot gegevensverlies, onverwachte kosten, het opraken van je maandelijkse quotum en onderbreking van je API-toegang.
Je kunt het gebruik van je teams volgen via de pagina Gebruik. Als je je zorgen maakt over misbruik, kun je een aantal maatregelen nemen om je account te beschermen:
Controleer of je gebruik overeenkomt met de werkzaamheden van je team. Voor gebruikers die bij meerdere organisaties horen (bijvoorbeeld zakelijk en persoonlijk): controleer of tracking is ingeschakeld en of hun standaardorganisatie voor gebruik en tracking is ingesteld.
Als je denkt dat je sleutel is uitgelekt, vervang deze dan onmiddellijk via de pagina API-sleutels. Klanten met productieapplicaties moeten de waarden van hun sleutels dienovereenkomstig bijwerken.
Neem contact met ons op via help.openai.com, zodat we dit verder kunnen onderzoeken.
7. Beperk API-toegang met IP-allowlisting
Met IP-allowlisting kun je beperken welke IP-adressen toegang hebben tot je OpenAI-API. Als dit is ingeschakeld, worden alleen verzoeken van geconfigureerde IP-adressen of -bereiken toegestaan en worden alle andere geweigerd, zelfs als ze een geldige API-sleutel bevatten.
Dit voegt een extra beschermingslaag toe door ervoor te zorgen dat je API alleen toegankelijk is vanuit vertrouwde infrastructuur, zoals je backendservers of cloudomgeving.
Zie voor meer informatie het artikel over IP-allowlisting voor de OpenAI-API.