1. Vždy používejte jedinečný klíč API pro každého člena týmu ve svém účtu.

Klíč API je jedinečný kód, který identifikuje vaše požadavky na API. Váš klíč API je určen k tomu, abyste jej používali vy. Sdílení klíčů API je v rozporu s podmínkami používání.

Jakmile začnete experimentovat, možná budete chtít rozšířit přístup k API na svůj tým. OpenAI sdílení klíčů API nepodporuje. Pozvěte prosím nové členy do svého účtu ze stránky Členové a po přihlášení rychle obdrží svůj vlastní jedinečný klíč. Také můžete přiřadit oprávnění jednotlivým klíčům API.

2. Nikdy nenasazujte svůj klíč v klientských prostředích, jako jsou prohlížeče nebo mobilní aplikace.

Vystavení vašeho klíče API OpenAI v klientských prostředích, jako jsou prohlížeče nebo mobilní aplikace, umožňuje škodlivým uživatelům tento klíč převzít a odesílat požadavky vaším jménem – což může vést k neočekávaným poplatkům nebo kompromitaci některých údajů účtu. Požadavky by měly být vždy směrovány přes váš vlastní backendový server, kde můžete svůj klíč API udržet v bezpečí.

3. Nikdy neukládejte svůj klíč do úložiště

Uložení klíče API do zdrojového kódu je běžný způsob kompromitace přihlašovacích údajů. U veřejných úložišť jde o běžný způsob, jak můžete svůj klíč nevědomky sdílet s internetem. Soukromá úložiště jsou bezpečnější, ale únik dat může také vést k vyzrazení vašich klíčů. Z těchto důvodů důrazně doporučujeme používat proměnné prostředí jako proaktivní bezpečnostní opatření pro klíče.

4. Místo klíče API používejte proměnné prostředí

Proměnná prostředí je proměnná nastavená v operačním systému, nikoli přímo v aplikaci. Skládá se z názvu a hodnoty. Doporučujeme proměnnou pojmenovat OPENAI_API_KEY. Pokud bude celý tým používat stejný název proměnné, můžete ukládat a sdílet kód bez rizika odhalení klíče API.

Nastavení ve Windows

Možnost 1: Nastavte proměnnou prostředí „OPENAI_API_KEY“ pomocí příkazového řádku cmd

Spusťte v příkazovém řádku cmd následující příkaz a nahraďte <yourkey> svým klíčem API:

setx OPENAI_API_KEY "<yourkey>"

Toto nastavení se projeví až v nově otevřených oknech příkazového řádku cmd, takže chcete-li proměnnou použít s nástrojem curl, otevřete nové okno. Nastavení této proměnné můžete ověřit tak, že otevřete nové okno příkazového řádku cmd a zadáte

echo %OPENAI_API_KEY%

Možnost 2: Nastavte proměnnou prostředí „OPENAI_API_KEY“ prostřednictvím Ovládacích panelů

Otevřete vlastnosti Systému a vyberte Upřesnit nastavení systému

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

Vyberte Proměnné prostředí…

Windows System Properties Advanced tab with Environment Variables button highlighted

V horní části Uživatelské proměnné vyberte Nová…. Přidejte dvojici názvu a hodnoty klíče a nahraďte <yourkey> svým klíčem API.

Název proměnné: OPENAI_API_KEY
Hodnota proměnné: <yourkey>

Nastavení v Linuxu / macOS

Možnost 1: Nastavte proměnnou prostředí „OPENAI_API_KEY“ pomocí zsh

Spusťte v terminálu následující příkaz a nahraďte yourkey svým klíčem API.

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

Aktualizujte shell novou proměnnou:

source ~/.zshrc

Ověřte, že jste proměnnou prostředí nastavili, pomocí následujícího příkazu.

echo $OPENAI_API_KEY

Výsledným výstupem bude hodnota vašeho klíče API.

Možnost 2: Nastavte proměnnou prostředí „OPENAI_API_KEY“ pomocí bashe

Postupujte podle pokynů v možnosti 1 a nahraďte .zshrc souborem .bash_profile.

Máte hotovo! Nyní můžete na klíč odkazovat v curlu nebo jej načíst v Pythonu:

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

5. Používejte službu správy klíčů

Pro bezpečnou správu tajných klíčů API je k dispozici řada produktů. Tyto nástroje vám umožňují řídit přístup ke klíčům a zlepšit celkové zabezpečení dat. V případě úniku dat z vaší aplikace by vaše klíče nebyly kompromitovány, protože by byly zašifrované a spravované na zcela samostatném místě.

Týmům, které nasazují své aplikace do produkce, doporučujeme zvážit některou z těchto služeb.

6. Sledujte využití účtu a podle potřeby obměňujte klíče

Kompromitovaný klíč API umožňuje jiné osobě bez vašeho souhlasu čerpat kvótu vašeho účtu. To může vést ke ztrátě dat, neočekávaným poplatkům, vyčerpání měsíční kvóty a přerušení přístupu k API.

Využití vašich týmů můžete sledovat na stránce Využití. Pokud máte podezření na zneužití, můžete svůj účet ochránit několika způsoby:

Zkontrolujte využití a ověřte, zda odpovídá práci vašeho týmu. U uživatelů, kteří patří do více organizací (např. firemní a osobní), ověřte, zda mají zapnuté sledování a nastavenou výchozí organizaci pro využití a sledování.
Pokud se domníváte, že váš klíč unikl, okamžitě ho obměňte na stránce Klíče API. Pokud používáte aplikace v produkčním prostředí, budete v nich muset odpovídajícím způsobem aktualizovat hodnoty klíčů.
Chcete-li záležitost dále prošetřit, kontaktujte nás prostřednictvím webu help.openai.com.

7. Omezte přístup k API pomocí seznamu povolených IP adres

Seznam povolených IP adres vám umožňuje omezit, které IP adresy mohou přistupovat k vašemu OpenAI API. Když je tato funkce povolena, jsou povoleny pouze požadavky z nakonfigurovaných IP adres nebo rozsahů a všechny ostatní jsou odmítnuty – i když obsahují platný klíč API.

Tím přidáte další vrstvu ochrany, protože zajistíte, že k vašemu API bude možné přistupovat pouze z důvěryhodné infrastruktury, například z vašich backendových serverů nebo cloudového prostředí.

Další informace najdete v článku o seznamu povolených IP adres pro OpenAI API.

Osvědčené postupy pro bezpečnost API klíčů