1. Pre každého člena tímu vo svojom účte vždy používajte jedinečný kľúč API.

Kľúč API je jedinečný kód, ktorý identifikuje vaše požiadavky na API. Váš kľúč API je určený na používanie vami. Zdieľanie kľúčov API je v rozpore s podmienkami používania.

Keď začnete experimentovať, možno budete chcieť rozšíriť prístup k API na svoj tím. OpenAI nepodporuje zdieľanie kľúčov API. Pozvite nových členov do svojho účtu zo stránky Členovia a po prihlásení rýchlo dostanú svoj vlastný jedinečný kľúč. Jednotlivým kľúčom API môžete priraďovať povolenia.

2. Nikdy nenasadzujte svoj kľúč v klientskych prostrediach, ako sú prehliadače alebo mobilné aplikácie.

Vystavenie vášho kľúča OpenAI API v klientskych prostrediach, ako sú prehliadače alebo mobilné aplikácie, umožňuje škodlivým používateľom tento kľúč prevziať a odosielať požiadavky vo vašom mene – čo môže viesť k neočakávaným poplatkom alebo kompromitácii určitých údajov účtu. Požiadavky by sa mali vždy smerovať cez váš vlastný backendový server, kde môžete svoj kľúč API uchovávať v bezpečí.

3. Nikdy neukladajte svoj kľúč do repozitára

Uloženie kľúča API do zdrojového kódu je bežný spôsob kompromitácie prihlasovacích údajov. Ak máte verejné repozitáre, je to bežný spôsob, ako môžete nevedomky zdieľať svoj kľúč s internetom. Súkromné repozitáre sú bezpečnejšie, ale narušenie ochrany údajov môže tiež viesť k úniku vašich kľúčov. Z týchto dôvodov dôrazne odporúčame používať premenné prostredia ako proaktívne bezpečnostné opatrenie na ochranu kľúčov.

4. Namiesto kľúča API používajte premenné prostredia

Premenná prostredia je premenná nastavená v operačnom systéme, nie priamo v aplikácii. Pozostáva z názvu a hodnoty. Odporúčame nastaviť názov premennej na OPENAI_API_KEY. Ak bude celý tím používať rovnaký názov premennej, môžete ukladať a zdieľať kód bez rizika odhalenia kľúča API.

Nastavenie v systéme Windows

Možnosť 1: Nastavte premennú prostredia „OPENAI_API_KEY“ cez príkazový riadok cmd

V príkazovom riadku cmd spustite nasledujúci príkaz a nahraďte <yourkey> svojím kľúčom API:

setx OPENAI_API_KEY "<yourkey>"

Zmena sa prejaví v nových oknách príkazového riadka cmd, preto musíte otvoriť nové okno, aby ste mohli túto premennú použiť s curl. Nastavenie tejto premennej môžete overiť tak, že otvoríte nové okno príkazového riadka cmd a zadáte

echo %OPENAI_API_KEY%

Možnosť 2: Nastavte premennú prostredia „OPENAI_API_KEY“ cez Ovládací panel

Otvorte vlastnosti Systému a vyberte Rozšírené systémové nastavenia

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

Vyberte Premenné prostredia...

Windows System Properties Advanced tab with Environment Variables button highlighted

V sekcii Používateľské premenné (hore) vyberte Nová…. Pridajte dvojicu názvu a hodnoty kľúča, pričom <yourkey> nahraďte svojím kľúčom API.

Názov premennej: OPENAI_API_KEY
Hodnota premennej: <yourkey>

Nastavenie v systéme Linux/macOS

Možnosť 1: Nastavte premennú prostredia „OPENAI_API_KEY“ pomocou zsh

V termináli spustite nasledujúci príkaz a nahraďte yourkey svojím kľúčom API.

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

Aktualizujte shell novou premennou:

source ~/.zshrc

Pomocou nasledujúceho príkazu potvrďte, že ste nastavili premennú prostredia.

echo $OPENAI_API_KEY

Výsledným výstupom bude hodnota vášho kľúča API.

Možnosť 2: Nastavte premennú prostredia „OPENAI_API_KEY“ pomocou bash

Postupujte podľa pokynov v možnosti 1 a nahraďte .zshrc za .bash_profile.

Všetko je pripravené! Teraz môžete na kľúč odkazovať v curl alebo ho načítať v Pythone:

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

5. Používajte službu správy kľúčov

Na bezpečnú správu tajných kľúčov API je k dispozícii viacero produktov. Tieto nástroje vám umožňujú kontrolovať prístup ku kľúčom a zlepšiť celkovú bezpečnosť údajov. V prípade narušenia ochrany údajov vašej aplikácie by vaše kľúče neboli kompromitované, pretože by boli šifrované a spravované na úplne samostatnom mieste.

Tímom, ktoré nasadzujú svoje aplikácie do produkcie, odporúčame zvážiť jednu z týchto služieb.

6. Sledujte využitie svojho účtu a podľa potreby obmieňajte kľúče

Kompromitovaný kľúč API umožňuje inej osobe získať bez vášho súhlasu prístup ku kvóte vášho účtu. Môže to viesť k strate údajov, neočakávaným poplatkom, vyčerpaniu mesačnej kvóty a prerušeniu prístupu k API.

Využitie vašich tímov môžete sledovať na stránke Využitie. Ak máte podozrenie na zneužitie, svoj účet môžete chrániť niekoľkými spôsobmi:

Skontrolujte využitie a overte, či zodpovedá práci vášho tímu. Pri používateľoch, ktorí patria do viacerých organizácií (napr. pracovnej a osobnej), skontrolujte, či majú zapnuté sledovanie a nastavenú predvolenú organizáciu na využívanie a sledovanie.
Ak sa domnievate, že váš kľúč unikol, okamžite ho obmeňte na stránke Kľúče API. Ak máte aplikácie v produkčnom prostredí, budete v nich musieť príslušne aktualizovať hodnoty kľúčov.
Ak potrebujete ďalšie preverenie, kontaktujte nás prostredníctvom stránky help.openai.com.

7. Obmedzte prístup k API pomocou zoznamu povolených IP adries

Zoznam povolených IP adries vám umožňuje obmedziť, ktoré IP adresy môžu pristupovať k vášmu OpenAI API. Keď je zapnutý, povolené sú iba požiadavky z nakonfigurovaných IP adries alebo rozsahov a všetky ostatné sa odmietnu – aj keď obsahujú platný kľúč API.

Tým pridáte ďalšiu vrstvu ochrany, ktorá zaistí, že k vášmu API možno pristupovať iba z dôveryhodnej infraštruktúry, napríklad z vašich backendových serverov alebo cloudového prostredia.

Ďalšie informácie nájdete v článku o zozname povolených IP adries pre OpenAI API.

Osvedčené postupy pre bezpečnosť API kľúčov