Kimlik doğrulama

ChatGPT web ve Codex istemcileri için oturum açma yöntemleri

Yerel bir istemciyi ChatGPT oturumu açarak veya açmadan kuruluşunuzun ağ geçidine bağlamak için Bir ağ geçidine bağlanma bölümüne bakın. Bedrock'a doğrudan erişimde Amazon Bedrock kimlik doğrulama seçenekleri kullanılır.

OpenAI kimlik doğrulaması

Codex, OpenAI modellerini kullanırken bir kişinin oturum açması için iki yöntemi 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ı izinlerinizi, 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

Work Cloud ile yerel bilgisayar erişimini masaüstünde, mobilde ve web'de kullanmak için:

  1. ChatGPT ile uygun bir çalışma alanında oturum açın.

  2. Bir çalışma alanı sahibinden Work Cloud'u etkinleştirmesini, ardından Work Cloud altındaki Allow local computer access seçeneğini açmasını isteyin. Use Codex locally on the ChatGPT desktop app bir ön koşul değildir.

API key'ler ve Codex erişim belirteçleri, Work Cloud ile yerel bilgisayar erişimini etkinleştirmez. Ön koşullar için Roller ve çalışma alanı izinleri ve Work yöneticileri için SSS sayfalarına, kurulum için ise Work Cloud ve dots için yerel bilgisayar erişimi sayfasına bakın.

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.

Codex CLI'da ve ChatGPT masaüstü uygulamasındaki Codex'te API key ile kimlik doğrulama, OpenAI tarafından seçilmiş, desteklenen eklentilere erişim sağlar. Bazı eklentiler, bağlantı akışları desteklenmeyen OAuth yetenekleri gerektirdiği için kullanılamaz. Eklentileri kullanma bölümüne bakı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. Mevcut kimlik bilgilerini silmek için Log out seçeneğini seçin.

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, kimlik bilgilerini yenileme 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.:

ChatGPT'ye tek 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 | ephemeral
cli_auth_credentials_store = "keyring"
  • file, kimlik bilgilerini auth.json dosyasında, CODEX_HOME altında saklar (varsayılan konum ~/.codex).
  • keyring, kimlik bilgilerini işletim sisteminizin kimlik bilgisi deposunda saklar ve bu depo kullanılamıyorsa başarısız olur.
  • auto, kullanılabiliyorsa işletim sisteminin kimlik bilgisi deposunu kullanır; aksi takdirde auth.json dosyasına başvurur.
  • ephemeral, kimlik bilgilerini yalnızca geçerli süreç için bellekte tutar.

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

Yöneticiler, cli_auth_credentials_store ve chatgpt_base_url ayarlarını yerel kimlik doğrulama gereksinimleri aracılığıyla zorunlu kılabilir. Kullanıcılar bu gereksinimleri config.toml veya CLI geçersiz kılmaları aracılığıyla geçersiz kılamaz.

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, eski yönetilen yapılandırma aracılığıyla da sağlanabilir. Yöneticilerin zorunlu kıldığı oturum açma kısıtlamaları için Kimlik doğrulamayı yerel olarak yönetme bölümüne bakın.

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 ayarını yapın. Ardından ChatGPT veya bir API key ile oturum açabilirsiniz. Bu, OpenAI modellerine bir LLM proxy sunucusu üzerinden eriştiğinizde yararlıdır. requires_openai_auth = true olduğunda Codex, env_key ayarını yok sayar.
  • Ortam değişkeniyle kimlik doğrulama: env_key = "<ENV_VARIABLE_NAME>" ayarını, <ENV_VARIABLE_NAME> adlı yerel ortam değişkenindeki sağlayıcıya özgü API key değerini kullanacak şekilde yapılandırın.
  • Yerleşik ağ geçidi OAuth desteği: Kuruluşunuzun kimlik sağlayıcısı üzerinden tarayıcıda oturum açmak için [model_providers.<id>.gateway_oauth] ayarını yapılandırın. ChatGPT oturumu açıkken de kapalıyken de çalışır. Ağ geçidi gereksinimleri ve yapılandırma için Yerleşik ağ geçidi OAuth desteği bölümüne bakın.
  • Komut destekli kimlik doğrulama: Yüklü bir kimlik bilgisi yardımcısından belirteç almak için [model_providers.<id>.auth] ayarını yapılandırın.
  • Kimlik doğrulama yok: Kimlik bilgileri gerektirmeyen yerel bir model için requires_openai_auth ayarını tanımsız bırakın veya false olarak ayarlayın ve env_key, experimental_bearer_token, auth ve gateway_oauth dâhil kimlik bilgisi ayarlarını eklemeyin.