Kimlik doğrulama

OpenAI kimlik doğrulaması

Codex, OpenAI modellerini kullanırken iki oturum açma yöntemini destekler:

• Abonelik erişimi için ChatGPT ile oturum açma
• Kullanıma dayalı erişim için API key ile oturum açma

ChatGPT masaüstü uygulaması, Codex CLI ve IDE uzantısı, yerel çalışmalar için her iki oturum açma yöntemini de destekler. Codex cloud, ChatGPT ile oturum açmayı gerektirir.

Oturum açma yönteminiz, hangi yönetici denetimlerinin ve veri işleme politikalarının uygulanacağını da belirler.

• ChatGPT ile oturum açtığınızda Codex kullanımı; ChatGPT çalışma alanı izinlarınızı, rol tabanlı erişim denetimini (RBAC) ve ChatGPT Enterprise saklama ve yerleşim ayarlarını izler.
• API key kullanıldığında ise kullanım, API kuruluşunuzun saklama ve veri paylaşımı ayarlarını izler.

Yönetilen çalışma alanlarında kimlik doğrulama, erişimin yalnızca bir katmanıdır. Çalışma alanı üyeliği ve sağlama, kimin oturum açabileceğini; lisanslar ve çalışma alanı rolleri ise hangi ürün arayüzlerini ve özellikleri kullanabileceklerini belirler. ChatGPT masaüstü uygulamasında, Codex CLI'da veya IDE uzantısında yerel çalışma için izin profilleri, ajanın cihazda neler yapabileceğini sınırlar. Bu denetimleri planlamak için Gruplar ve sağlama ve Roller ve çalışma alanı izinleri sayfalarına bakın.

ChatGPT ile oturum açma

ChatGPT masaüstü uygulamasından, Codex CLI'dan veya IDE uzantısından ChatGPT ile oturum açtığınızda oturum açma akışı bir tarayıcı penceresi açar. Oturum açmanızın ardından tarayıcı, kimlik bilgilerinizi Codex'e döndürür.

ChatGPT masaüstü uygulaması

Oturumun kapalı olduğu ekranda Continue to sign in seçeneğini belirleyin, ardından tarayıcı akışını tamamlayın.

API key ile oturum açma

ChatGPT masaüstü uygulamasında, Codex CLI'da veya IDE uzantısında API key ile de oturum açabilirsiniz. API key'inizi OpenAI dashboard üzerinden alın.

ChatGPT masaüstü uygulaması

Oturumun kapalı olduğu ekranda Sign in another way seçeneğini belirleyin, anahtarınızı girin ve ardından Continue seçeneğini belirleyin.

OpenAI, API key kullanımını OpenAI Platform hesabınız üzerinden standart API ücretleriyle faturalandırır. Bkz. API fiyatlandırma sayfası.

API key kimlik doğrulaması yerel Codex iş akışlarını destekler, ancak ChatGPT çalışma alanı erişimine veya bulut hizmetlerine dayanan bazı özellikler sınırlıdır ya da kullanılamaz. Planlara göre desteği Özellik kullanılabilirliği sayfasında karşılaştırın.

API key ile oturum açtığınızda Codex, dâhil edilen ChatGPT planı kredileri yerine standart API fiyatlandırmasını kullanır.

API key kimlik doğrulamasını CI/CD işleri gibi programatik Codex CLI iş akışları için kullanın. Codex yürütmesini güvenilmeyen veya herkese açık ortamlarda kullanıma açmayın.

Kimlik doğrulamayı denetleme veya oturumu kapatma

Etkin hesabı veya API key durumunu görmek için profil menüsünü açın. Geçerli kimlik bilgilerini temizlemek için Log out seçeneğini belirleyin.

Kurumsal otomasyon için Codex erişim belirteçlerini kullanma

ChatGPT Enterprise çalışma alanlarında yöneticiler, izin verilen üyelerin güvenilir, etkileşimsiz yerel Codex iş akışları için Codex erişim belirteçleri oluşturabilmesi amacıyla erişim belirteci izni verebilir. Otomasyon; tarayıcıda oturum açmadan ChatGPT çalışma alanı erişimine, ChatGPT tarafından yönetilen Codex yetkilerine veya kurumsal çalışma alanı denetimlerine ihtiyaç duyduğunda erişim belirteci kullanın.

Erişim belirteçleri güvenilir betikler, zamanlayıcılar ve özel CI çalıştırıcıları için tasarlanmıştır. Genel OpenAI API çağrıları için Platform API anahtarlarını kullanmaya devam edin.

Kurulum adımları, izinler, döndürme ve erişim iptali kılavuzu için Erişim belirteçleri sayfasına bakın.

Codex cloud hesabınızı güvenceye alın

Codex cloud doğrudan kod tabanınızla etkileşime girdiğinden diğer birçok ChatGPT özelliğine kıyasla daha güçlü güvenlik gerektirir. Çok faktörlü kimlik doğrulamayı (MFA) etkinleştirin.

Bir sosyal oturum açma sağlayıcısı (Google, Microsoft, Apple) kullanıyorsanız ChatGPT hesabınızda MFA'yı etkinleştirmeniz gerekmez, ancak bunu sosyal oturum açma sağlayıcınızda ayarlayabilirsiniz.

Kurulum talimatları için bkz.:

• Google
• Microsoft
• Apple

ChatGPT'ye çoklu oturum açma (SSO) üzerinden erişiyorsanız kuruluşunuzun SSO yöneticisi tüm kullanıcılar için MFA'yı zorunlu kılmalıdır.

E-posta ve parola kullanarak oturum açıyorsanız Codex cloud'a erişmeden önce hesabınızda MFA'yı ayarlamalısınız.

Hesabınız birden fazla oturum açma yöntemini destekliyorsa ve bunlardan biri e-posta ve parola ise başka bir yöntemle oturum açsanız bile Codex'e erişmeden önce MFA'yı ayarlamalısınız.

Oturum açma bilgilerini önbelleğe alma

ChatGPT veya API key kullanarak ChatGPT masaüstü uygulamasında, Codex CLI'da ya da IDE uzantısında oturum açtığınızda oturum açma bilgileriniz önbelleğe alınır ve yeniden kullanılır. CLI ve uzantı, önbelleğe alınan aynı oturum açma bilgilerini paylaşır. Bunlardan birinde oturumu kapatırsanız CLI veya uzantıyı bir sonraki başlatışınızda yeniden oturum açmanız gerekir.

Codex, oturum açma bilgilerini yerel olarak ~/.codex/auth.json konumundaki bir düz metin dosyasında veya işletim sisteminize özgü kimlik bilgisi deposunda önbelleğe alır.

ChatGPT ile oturum açılan oturumlarda Codex, belirteçleri kullanım sırasında süreleri dolmadan önce otomatik olarak yeniler; bu nedenle etkin oturumlar genellikle tarayıcıda yeniden oturum açmayı gerektirmeden devam eder.

Kimlik bilgilerini depolama

Codex CLI'ın önbelleğe alınmış kimlik bilgilerini nerede saklayacağını denetlemek için cli_auth_credentials_store kullanın:

# file | keyring | auto
cli_auth_credentials_store = "keyring"

• file, kimlik bilgilerini CODEX_HOME (varsayılanı ~/.codex) altındaki auth.json içinde saklar.
• keyring, kimlik bilgilerini işletim sisteminizin kimlik bilgisi deposunda saklar.
• auto, varsa işletim sistemi kimlik bilgisi deposunu kullanır; yoksa auth.json seçeneğine geri döner.

config.toml şemasının tamamı için yapılandırma referansına bakın.

Bir oturum açma yöntemini veya çalışma alanını zorunlu kılma

Yönetilen ortamlarda yöneticiler, kullanıcıların nasıl kimlik doğrulayabileceğini kısıtlayabilir:

# Only allow ChatGPT login or only allow API key login.
forced_login_method = "chatgpt" # or "api"

# When using ChatGPT login, restrict users to a specific workspace.
forced_chatgpt_workspace_id = "00000000-0000-0000-0000-000000000000"

Etkin kimlik bilgileri yapılandırılmış kısıtlamalarla eşleşmezse Codex kullanıcının oturumunu kapatır ve sonlanır.

Bu ayarlar genellikle kullanıcı başına kurulum yerine yönetilen yapılandırma üzerinden uygulanır. Bkz. Yönetilen yapılandırma.

Alternatif model sağlayıcıları

Yapılandırma dosyanızda bir özel model sağlayıcısı tanımladığınızda şu kimlik doğrulama yöntemlerinden birini seçebilirsiniz:

• OpenAI kimlik doğrulaması: OpenAI kimlik doğrulamasını kullanmak için requires_openai_auth = true ayarlayın. Ardından ChatGPT veya API key ile oturum açabilirsiniz. Bu, OpenAI modellerine bir LLM proxy sunucusu üzerinden eriştiğinizde kullanışlıdır. requires_openai_auth = true olduğunda Codex, env_key değerini yok sayar.
• Ortam değişkeniyle kimlik doğrulama: <ENV_VARIABLE_NAME> adlı yerel ortam değişkeninden sağlayıcıya özgü bir API key kullanmak için env_key = "<ENV_VARIABLE_NAME>" ayarlayın.
• Kimlik doğrulama yok: requires_openai_auth ayarlamazsanız (veya false olarak ayarlarsanız) ve env_key değerini de ayarlamazsanız Codex, sağlayıcının kimlik doğrulama gerektirmediğini varsayar. Bu, yerel modeller için kullanışlıdır.