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. Son kullanma tarihi olan API anahtarları oluşturun ve bir anahtar yenileme süreci belirleyin

Proje anahtarları bir son kullanma tarihiyle oluşturulabilir. Bu tarihten sonra bu anahtarlarla yapılan tüm istekler reddedilir. Son kullanma tarihi olan anahtarlar oluşturmanızı ve düzenli bir anahtar yenileme süreci belirlemenizi önemle tavsiye ederiz. Bir anahtarın süresi dolmadan önce yerine yenisini oluşturun, uygulamalarınızı yeni anahtarı kullanacak şekilde güncelleyin ve yeni anahtarın çalıştığını doğruladıktan sonra eski anahtarı iptal edin. Bu uygulamalar, API anahtarlarının sızdırılması durumunda oluşabilecek zararı büyük ölçüde azaltabilir.

Yöneticiler, Platform ayarlarından kuruluş veya proje düzeyinde API anahtarları için azami geçerlilik süresi belirleyebilir. Yeni anahtarların izin verilen sınırlar içinde yapılandırılması gerekir. Böylece süresiz olarak geçerli kalmaları önlenir. Proje sınırları, kuruluş sınırını aşamaz.

Desteklenen iş yüklerinde, uzun süre geçerli bir OpenAI API anahtarını saklamak yerine iş yükü kimlik federasyonunu kullanın. İş yükünüz, güvenilir bir sağlayıcıdan aldığı kimliği kısa süre geçerli bir OpenAI erişim belirteciyle değiştirir. İş yüküne özel bir hizmet hesabı yapılandırın ve yalnızca iş yükünün ihtiyaç duyduğu izinleri verin.

3. Anahtarınızı asla tarayıcılar veya mobil uygulamalar gibi istemci tarafı ortamlara yerleştirmeyin.

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ı ele geçirip sizin adınıza istek göndermesine olanak tanır. Bu da beklenmedik ücretlere veya bazı hesap verilerinin ele geçirilmesine yol açabilir. İstekler her zaman API anahtarınızı güvende tutabileceğiniz kendi arka uç sunucunuz üzerinden yönlendirilmelidir.

4. Anahtarınızı deponuza asla işlemeyin

Bir API anahtarını kaynak koda işlemek, kimlik bilgilerinin ele geçirilmesine sıkça yol açar. Herkese açık depolar kullanıyorsanız anahtarınızı farkında olmadan internette paylaşmanızın en yaygın yollarından biri budur. Özel depolar daha güvenlidir ancak veri ihlali sonucunda anahtarlarınız yine de sızdırılabilir. Bu nedenlerle, anahtar güvenliğini proaktif olarak sağlamak için ortam değişkenlerini kullanmanızı önemle tavsiye ederiz.

5. 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 belirlemenizi öneririz. Bu değişken adını ekibiniz genelinde aynı tutarak API anahtarınızı açığa çıkarma riski olmadan kodunuzu depoya işleyebilir ve paylaşabilirsiniz.


Windows Kurulumu

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

<yourkey> yerine API anahtarınızı yazarak aşağıdaki komutu cmd komut isteminde çalıştırın:

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

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

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

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

1. 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.

Linux/macOS Kurulumu

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

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

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

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

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:

6. 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 etmenize ve genel veri güvenliğinizi artırmanıza olanak tanır. Uygulamanızda bir veri ihlali yaşansa bile anahtarlarınız şifrelenip tamamen ayrı bir konumda yönetildiği için ele geçirilmez.

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

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

Kuruluşunuz veya projeleriniz için aylık harcama limitleri belirleyin. Sızdırılan bir anahtarın yol açabileceği beklenmedik maliyetleri sınırlamaya yardımcı olmak için limitlerin zorunlu olarak uygulanmasını etkinleştirin. Harcama uyarıları tek başına API trafiğini durdurmaz. Limitlerin zorunlu olarak uygulanması meşru istekleri de engelleyebilir. Ayrıca limitler anında uygulanmadığından harcama, limiti az da olsa aşabilir.

Ele geçirilmiş bir API anahtarı, bir başkasının 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ımdan şüpheleniyorsanız hesabınızı korumak için şu adımları atabilirsiniz:

• Kullanımınızı inceleyerek ekibinizin çalışmalarıyla uyumlu olup olmadığını kontrol edin. Birden fazla kuruluşa (ör. kurumsal ve kişisel) üye olan kullanıcıların, kullanım takibini 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 çalışan uygulamalarınız varsa bu uygulamalardaki anahtar değerlerini de güncellemeniz gerekir.

• Daha ayrıntılı inceleme için help.openai.com üzerinden bizimle iletişime geçin.

8. API erişimini ağ kontrolleriyle koruyun

IP izin listesi, OpenAI API'nize hangi IP adreslerinin erişebileceğini sınırlamanızı sağlar. Etkinleştirildiğinde yalnızca yapılandırılmış IP adreslerinden veya adres aralıklarından gelen isteklere izin verilir. Diğer tüm istekler, geçerli bir API anahtarı içerseler bile reddedilir.

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

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

Private Link, özel ağ erişimine ihtiyaç duyan kuruluşlar için başka bir seçenektir. Azure iş yüklerinin Azure Private Link üzerinden bölgesel OpenAI API uç noktalarına bağlanmasını sağlar. Erişim talep etmek için OpenAI temsilcinizle veya satış ekibiyle iletişime geçin. API kimlik doğrulaması yine de gereklidir. Private Link, IP izin listesi veya karşılıklı TLS (mTLS) ile uyumlu değildir. Kurulum ayrıntıları için Private Link kılavuzuna bakın.