OpenAI
Оваа страница беше машински преведена. Погледнете ја оригиналната статија на англиски јазик.

Најдобри практики за безбедност на API клучот

Заштитете ги своите API-клучеви со безбедно складирање, контроли на пристап, следење, ротација и ограничувања по IP-адреса.

Ажурирано: yesterday

1. Секогаш користете уникатен API-клуч за секој член на тимот на вашата сметка.

API-клуч е уникатен код што ги идентификува вашите барања до API. Вашиот API-клуч е наменет да го користите вие. Споделувањето API-клучеви е спротивно на Условите за користење.

Кога ќе почнете да експериментирате, можеби ќе сакате да го проширите пристапот до API на вашиот тим. OpenAI не поддржува споделување API-клучеви. Поканете нови членови во вашата сметка од страницата Членови и тие брзо ќе добијат свој уникатен клуч по најавувањето. Исто така можете да доделите дозволи на поединечни API-клучеви.

2. Никогаш не го распоредувајте вашиот клуч во околини од клиентска страна, како прелистувачи или мобилни апликации.

Изложувањето на вашиот OpenAI API-клуч во околини од клиентска страна, како прелистувачи или мобилни апликации, им овозможува на злонамерни корисници да го земат тој клуч и да поднесуваат барања во ваше име — што може да доведе до неочекувани трошоци или компромитирање на одредени податоци од сметката. Барањата треба секогаш да се рутираат преку вашиот сопствен backend-сервер, каде што можете да го чувате вашиот API-клуч безбеден.

3. Никогаш не го комитувајте вашиот клуч во вашиот репозиториум

Комитувањето API-клуч во изворниот код е чест вектор за компромитирање на акредитиви. За оние со јавни репозиториуми, ова е чест начин на кој несвесно можете да го споделите вашиот клуч со интернетот. Приватните репозиториуми се побезбедни, но пробив на податоци исто така може да доведе до протекување на вашите клучеви. Поради овие причини, силно препорачуваме користење променливи на околината како проактивна мерка за безбедност на клучевите.

4. Користете променливи на окружувањето наместо вашиот API-клуч

Променлива на окружувањето е променлива што се поставува во оперативниот систем, а не во апликацијата. Таа се состои од име и вредност. Препорачуваме името на променливата да биде OPENAI_API_KEY. Ако целиот тим доследно го користи ова име на променливата, ќе можете да го зачувувате и споделувате кодот без ризик да го откриете API-клучот.


Поставување на Windows

Опција 1: Поставете ја променливата на окружувањето „OPENAI_API_KEY“ преку командната линија cmd

Извршете го следново во командната линија cmd, заменувајќи го <yourkey> со вашиот API-клуч:

setx OPENAI_API_KEY "<yourkey>"

Ова ќе важи за идните прозорци на командната линија cmd, па ќе треба да отворите нов прозорец за да ја користите променливата со curl. Може да проверите дали променливата е поставена така што ќе отворите нов прозорец на командната линија cmd и ќе внесете

echo %OPENAI_API_KEY%

Опција 2: Поставете ја променливата на окружувањето „OPENAI_API_KEY“ преку Контролната табла

  1. Отворете ги својствата на Систем и изберете Напредни системски поставки

Windows 10 System settings with Advanced system settings highlighted in Control Panel
  1. Изберете Променливи на окружувањето...

Windows System Properties Advanced tab with Environment Variables button highlighted
  1. Во делот „Кориснички променливи“ (горе), изберете Нова…. Додајте го парот име/вредност на клучот, заменувајќи го <yourkey> со вашиот API-клуч.

Име на променлива: OPENAI_API_KEY
Вредност на променлива: <yourkey>

Поставување на Linux / macOS

Опција 1: Поставете ја променливата на окружувањето „OPENAI_API_KEY“ преку zsh

  1. Извршете ја следнава команда во терминалот, заменувајќи го yourkey со вашиот API-клуч.

echo "export OPENAI_API_KEY='yourkey'" >> ~/.zshrc
  1. Ажурирајте ја школката со новата променлива:

source ~/.zshrc
  1. Потврдете дека сте ја поставиле променливата на околината користејќи ја следнава команда.

echo $OPENAI_API_KEY

Вредноста на вашиот API-клуч ќе биде добиениот излез.


Опција 2: Поставете ја вашата променлива на околината „OPENAI_API_KEY“ користејќи bash

Следете ги упатствата во Опција 1, заменувајќи .zshrc со .bash_profile.

Сè е подготвено! Сега можете да го референцирате клучот во curl или да го вчитате во вашиот Python:

import os
import openai

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

5. Користете услуга за управување со клучеви

Достапни се разновидни производи за безбедно управување со тајни API-клучеви. Овие алатки ви овозможуваат да го контролирате пристапот до вашите клучеви и да ја подобрите целокупната безбедност на податоците. Во случај на пробив на податоци во вашата апликација, вашиот клуч или клучеви нема да бидат компромитирани, бидејќи ќе бидат шифрирани и управувани на целосно одделна локација.

За тимови што ги распоредуваат своите апликации во продукција, препорачуваме да разгледате една од овие услуги.

6. Следете го користењето на сметката и менувајте ги клучевите кога е потребно

Компромитиран API-клуч може да му овозможи на некого да пристапи до квотата на вашата сметка без ваша согласност. Тоа може да доведе до губење податоци, неочекувани трошоци, исцрпување на месечната квота и прекин на пристапот до API.

Користењето од страна на вашиот тим може да се следи преку страницата Користење. Ако некогаш се посомневате во злоупотреба, може да преземете неколку чекори за да ја заштитите сметката:

  • Прегледајте го користењето за да проверите дали е во согласност со работата на вашиот тим. За корисниците што припаѓаат на повеќе организации (на пр., деловна и лична), проверете дали корисникот го овозможил следењето и ја поставил стандардната организација за користење и следење.

  • Ако сметате дека вашиот клуч е откриен, веднаш заменете го преку страницата API-клучеви. Ако имате апликации во продукција, ќе треба соодветно да ги ажурирате вредностите на клучевите.

  • За дополнителна истрага, контактирајте нè преку help.openai.com.

7. Ограничете го пристапот до API со список на дозволени IP-адреси

Списокот на дозволени IP-адреси ви овозможува да ограничите кои IP-адреси можат да пристапат до вашиот OpenAI API. Кога е овозможено, дозволени се само барања од конфигурирани IP-адреси или опсези, а сите други се одбиваат — дури и ако вклучуваат валиден API-клуч.

Ова додава дополнителен слој на заштита така што осигурува дека до вашиот API може да се пристапи само од доверлива инфраструктура, како што се вашите backend-сервери или облачна околина.

За повеќе информации, видете ја статијата за список на дозволени IP-адреси за OpenAI API.

Дали оваа статија ви беше корисна?