API anahtarlarınızı güvenli depolama, erişim kontrolleri, izleme, yenileme ve IP kısıtlamalarıyla koruyun.

1. Hesabınızdaki her ekip üyesi için her zaman benzersiz bir API anahtarı kullanın.

API anahtarı, API’ye gönderdiğiniz istekleri tanımlayan benzersiz bir koddur. API anahtarınız sizin tarafınızdan kullanılmak üzere tasarlanmıştır. API anahtarlarının paylaşılması Kullanım Koşullarına aykırıdır.

Denemelere başladıkça, API erişimini ekibinize genişletmek isteyebilirsiniz. OpenAI, API anahtarlarının paylaşılmasını desteklemez. Lütfen Üyeler sayfasından hesabınıza yeni üyeler davet edin; oturum açtıklarında hızla kendi benzersiz anahtarlarını alacaklardır. Ayrıca ayrı API anahtarlarına izinler atayabilirsiniz.

2. Anahtarınızı asla tarayıcılar veya mobil uygulamalar gibi istemci tarafı ortamlarda dağıtmayın.

OpenAI API anahtarınızı tarayıcılar veya mobil uygulamalar gibi istemci tarafı ortamlarda açığa çıkarmak, kötü niyetli kullanıcıların bu anahtarı alıp sizin adınıza istek göndermesine olanak tanır; bu da beklenmeyen ücretlere veya belirli hesap verilerinin ele geçirilmesine yol açabilir. İstekler, API anahtarınızı güvenli tutabileceğiniz kendi arka uç sunucunuz üzerinden her zaman yönlendirilmelidir.

3. Anahtarınızı asla deponuza commit etmeyin

Bir API anahtarını kaynak koda commit etmek, kimlik bilgilerinin ele geçirilmesi için yaygın bir yoldur. Herkese açık depoları olanlar için bu, anahtarınızı farkında olmadan internetle paylaşmanızın yaygın bir yoludur. Özel depolar daha güvenlidir, ancak bir veri ihlali anahtarlarınızın sızdırılmasına da yol açabilir. Bu nedenlerle, proaktif bir anahtar güvenliği önlemi olarak ortam değişkenlerini kullanmanızı önemle öneririz.

4. API anahtarınız yerine ortam değişkenlerini kullanın

Ortam değişkeni, uygulamanızın içinde değil işletim sisteminizde ayarlanan bir değişkendir. Bir ad ve değerden oluşur. Değişkenin adını OPENAI_API_KEY olarak ayarlamanızı öneririz. Bu değişken adını ekibiniz genelinde aynı tutarak API anahtarınızı ifşa etme riski olmadan kodunuzu kaydedebilir ve paylaşabilirsiniz.

Windows Kurulumu

Seçenek 1: cmd komut istemi üzerinden ‘OPENAI_API_KEY’ ortam değişkeninizi ayarlayın

cmd komut isteminde aşağıdakini çalıştırın ve <yourkey> yerine API anahtarınızı yazın:

setx OPENAI_API_KEY "<yourkey>"

Bu ayar gelecekte açılacak cmd komut istemi pencerelerinde geçerli olur; dolayısıyla değişkeni curl ile kullanmak için yeni bir pencere açmanız gerekir. Yeni bir cmd komut istemi penceresi açıp aşağıdakini yazarak bu değişkenin ayarlandığını doğrulayabilirsiniz

echo %OPENAI_API_KEY%

Seçenek 2: Denetim Masası üzerinden ‘OPENAI_API_KEY’ ortam değişkeninizi ayarlayın

Sistem özelliklerini açın ve Gelişmiş sistem ayarlarını seçin

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

Ortam Değişkenleri... seçeneğini belirleyin

Windows System Properties Advanced tab with Environment Variables button highlighted

Kullanıcı değişkenleri bölümünden (üstte) Yeni… seçeneğini belirleyin. <yourkey> yerine API anahtarınızı yazarak ad/değer çiftinizi ekleyin.

Değişken adı: OPENAI_API_KEY
Değişken değeri: <yourkey>

Linux/macOS Kurulumu

Seçenek 1: zsh kullanarak ‘OPENAI_API_KEY’ ortam değişkeninizi ayarlayın

Terminalinizde aşağıdaki komutu çalıştırın ve yourkey yerine API anahtarınızı yazın.

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

Kabuğu yeni değişkenle güncelleyin:

source ~/.zshrc

Aşağıdaki komutu kullanarak ortam değişkeninizi ayarladığınızı doğrulayın.

echo $OPENAI_API_KEY

API anahtarınızın değeri elde edilen çıktı olacaktır.

Seçenek 2: bash kullanarak “OPENAI_API_KEY” Ortam Değişkeninizi ayarlayın

Seçenek 1’deki yönergeleri izleyin; .zshrc yerine .bash_profile kullanın.

Her şey hazır! Artık anahtara curl içinde başvurabilir veya Python’ınıza yükleyebilirsiniz:

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

5. Bir Anahtar Yönetim Hizmeti kullanın

Gizli API anahtarlarını güvenle yönetmek için çeşitli ürünler mevcuttur. Bu araçlar, anahtarlarınıza erişimi kontrol etmenizi ve genel veri güvenliğinizi iyileştirmenizi sağlar. Uygulamanızda bir veri ihlali olması durumunda, anahtarlarınız şifrelenmiş ve tamamen ayrı bir konumda yönetiliyor olacağından ele geçirilmez.

Uygulamalarını üretime dağıtan ekiplerin bu hizmetlerden birini değerlendirmesini öneririz.

6. Hesap kullanımınızı izleyin ve gerektiğinde anahtarlarınızı yenileyin

Ele geçirilmiş bir API anahtarı, bir kişinin izniniz olmadan hesap kotanıza erişmesine olanak tanır. Bu durum veri kaybına, beklenmedik ücretlere, aylık kotanızın tükenmesine ve API erişiminizin kesintiye uğramasına yol açabilir.

Ekiplerinizin kullanımını Kullanım sayfasından takip edebilirsiniz. Kötüye kullanımla ilgili bir endişeniz olursa hesabınızı korumak için şu adımları atabilirsiniz:

Ekibinizin çalışmalarıyla uyumlu olup olmadığını görmek için kullanımınızı inceleyin. Birden fazla kuruluşa (ör. kurumsal ve kişisel) bağlı kullanıcıların takibi etkinleştirdiğinden ve kullanım ile takip için varsayılan kuruluşlarını belirlediğinden emin olun.
Anahtarınızın sızdırıldığını düşünüyorsanız API Anahtarları sayfasından anahtarınızı hemen yenileyin. Üretim ortamında uygulamaları bulunan müşterilerin anahtar değerlerini buna göre güncellemesi gerekir.
Daha ayrıntılı inceleme için help.openai.com üzerinden bizimle iletişime geçin.

7. IP izin listesi kullanarak API erişimini kısıtlayın

IP izin listesi, OpenAI API’nize hangi IP adreslerinin erişebileceğini kısıtlamanızı sağlar. Etkinleştirildiğinde, yalnızca yapılandırılmış IP adreslerinden veya aralıklarından gelen isteklere izin verilir; geçerli bir API anahtarı içerseler bile diğerlerinin tümü reddedilir.

Bu, API’nize yalnızca arka uç sunucularınız veya bulut ortamınız gibi güvenilir altyapılardan erişilebilmesini sağlayarak ek bir koruma katmanı ekler.

Daha fazla bilgi için OpenAI API için IP izin listesi makalesine bakın.

API Anahtarı Güvenliği için En İyi Uygulamalar