Kimlik doğrulama
ChatGPT web ve Codex istemcileri için oturum açma yöntemleri
- ChatGPT masaüstü uygulaması Masaüstünde projeler, dosyalar ve uzun süren görevler.
- ChatGPT web Tarayıcınızda sohbetler, projeler ve Work.
- Codex CLI Terminalinizde Codex.
- Codex IDE uzantısı Düzenleyicinizde Codex.
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:
ChatGPT ile uygun bir çalışma alanında oturum açın.
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 web
ChatGPT uygulamasını açın, oturum açın ve çalışmak istediğiniz çalışma alanını seçin. ChatGPT web, kimliği doğrulanmış oturumu tarayıcınızda tutar.
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.
Codex CLI
codex login komutunu çalıştırın, ardından tarayıcıdaki akışı tamamlayın. Geçerli bir oturum
olmadığında varsayılan kimlik doğrulama yöntemi budur.
IDE uzantısı
Oturumun kapalı olduğu ekranda Sign in with ChatGPT seçeneğini seçin, ardından tarayıcıdaki akışı 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.
Codex CLI
Anahtarı stdin üzerinden codex login komutuna yönlendirin:
printenv OPENAI_API_KEY | codex login --with-api-keyIDE uzantısı
Oturumun kapalı olduğu ekranda Use API Key seçeneğini seçin, anahtarınızı girin, ardından OK seçeneğini seçin.
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ı ve çalışma alanını doğrulamak için profil menüsünü açın. O tarayıcıdaki ChatGPT web oturumunu sonlandırmak için Log out seçeneğini seçin.
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.
Etkin kimlik doğrulama yöntemini görmek için codex login status komutunu çalıştırın. Kayıtlı
kimlik doğrulamada, mevcut kimlik bilgilerini temizlemek için codex logout komutunu çalıştırın.
İşlem, iş yükü kimliğini seçtiğinde Codex, codex login komutunu ve
codex logout komutunu reddeder; çünkü kimlik doğrulamayı işlem ortamı kontrol eder.
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.
Ortamınız zaten bir Codex erişim belirteci sağlıyorsa bunu CLI'a yönlendirin:
printenv CODEX_ACCESS_TOKEN | codex login --with-access-tokenCodex 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 bilgileriniauth.jsondosyasında,CODEX_HOMEaltı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 takdirdeauth.jsondosyası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.
Oturum açma tanılaması
Doğrudan codex login çalıştırıldığında, yapılandırdığınız günlük dizininde özel bir codex-login.log dosyası
oluşturulur. Tarayıcı üzerinden oturum açma veya cihaz kodu hatalarını ayıklamanız gerektiğinde
ya da destek ekibi oturum açmaya özel günlükler istediğinde bu dosyayı kullanın.
Özel CA bundle'ları
Ağınız kurumsal bir TLS proxy'si veya özel bir kök CA kullanıyorsa oturum açmadan önce
CODEX_CA_CERTIFICATE değişkenini bir PEM bundle'ını gösterecek şekilde ayarlayın.
CODEX_CA_CERTIFICATE ayarlanmamışsa Codex, SSL_CERT_FILE değişkenini kullanır. Aynı
özel CA ayarları oturum açma, normal HTTPS istekleri ve güvenli WebSocket
bağlantıları için geçerlidir.
export CODEX_CA_CERTIFICATE=/path/to/corporate-root-ca.pem
codex loginGrafik arayüzü olmayan cihazlarda oturum açma
Codex CLI ile ChatGPT oturumu açıyorsanız tarayıcı tabanlı oturum açma arayüzü bazı durumlarda çalışmayabilir:
- CLI'yi uzak veya grafik arayüzü olmayan bir ortamda çalıştırıyorsunuz.
- Yerel ağ yapılandırmanız, oturum açtıktan sonra Codex'in OAuth belirtecini CLI'ye döndürmek için kullandığı localhost geri çağrısını engelliyor.
Bu durumlarda cihaz koduyla kimlik doğrulamayı (beta) tercih edin. Etkileşimli oturum açma arayüzünde Sign in with Device Code seçeneğini seçin veya doğrudan codex login --device-auth komutunu çalıştırın. Cihaz koduyla kimlik doğrulama ortamınızda çalışmıyorsa alternatif yöntemlerden birini kullanın.
Önerilen yöntem: Cihaz koduyla kimlik doğrulama (beta)
- ChatGPT güvenlik ayarlarınızda (kişisel hesap) veya ChatGPT çalışma alanı izinlerinde (çalışma alanı yöneticisi) cihaz koduyla oturum açmayı etkinleştirin.
- Codex'i çalıştırdığınız terminalde şu seçeneklerden birini seçin:
- Etkileşimli oturum açma arayüzünde Sign in with Device Code seçeneğini seçin.
codex login --device-authkomutunu çalıştırın.
- Bağlantıyı tarayıcınızda açın, oturum açın ve ardından tek kullanımlık kodu girin.
Ortamınızda cihaz koduyla oturum açma kullanılamıyorsa aşağıdaki alternatif yöntemlerden birini kullanın.
Alternatif yöntem: Yerel olarak kimlik doğrulayın ve kimlik doğrulama önbelleğinizi kopyalayın
Oturum açma akışını tarayıcısı olan bir makinede tamamlayabiliyorsanız önbelleğe alınmış kimlik bilgilerinizi grafik arayüzü olmayan makineye kopyalayabilirsiniz.
- Tarayıcı tabanlı oturum açma akışını kullanabildiğiniz bir makinede
codex loginkomutunu çalıştırın. - Oturum açma önbelleğinin
~/.codex/auth.jsonkonumunda bulunduğunu doğrulayın. ~/.codex/auth.jsondosyasını grafik arayüzü olmayan makinedeki~/.codex/auth.jsonkonumuna kopyalayın.
~/.codex/auth.json dosyasını bir parola gibi koruyun: erişim belirteçleri içerir. Dosyayı commit etmeyin, destek taleplerine yapıştırmayın veya sohbette paylaşmayın.
İşletim sisteminiz kimlik bilgilerini ~/.codex/auth.json yerine bir kimlik bilgisi deposunda saklıyorsa bu yöntem uygulanamayabilir. Dosya tabanlı depolamayı yapılandırmayı öğrenmek için
Kimlik bilgilerini saklama bölümüne bakın.
SSH üzerinden uzak bir makineye kopyalayın:
ssh user@remote 'mkdir -p ~/.codex'
scp ~/.codex/auth.json user@remote:~/.codex/auth.jsonAlternatif olarak, scp kullanmayan tek satırlık bir komut kullanın:
ssh user@remote 'mkdir -p ~/.codex && cat > ~/.codex/auth.json' < ~/.codex/auth.jsonBir Docker konteynerine kopyalayın:
# Replace MY_CONTAINER with the name or ID of your container.
CONTAINER_HOME=$(docker exec MY_CONTAINER printenv HOME)
docker exec MY_CONTAINER mkdir -p "$CONTAINER_HOME/.codex"
docker cp ~/.codex/auth.json MY_CONTAINER:"$CONTAINER_HOME/.codex/auth.json"Aynı yaklaşımın güvenilir CI/CD çalıştırıcılarında kullanılan daha gelişmiş bir sürümü için
CI/CD'de Codex hesabının kimlik doğrulamasını sürdürme (ileri düzey) kılavuzuna bakın.
Bu kılavuz, normal çalıştırmalar sırasında Codex'in auth.json dosyasını yenilemesine nasıl izin vereceğinizi ve
ardından güncellenmiş dosyayı bir sonraki iş için nasıl saklayacağınızı açıklar. API key kullanımı, otomasyon için
önerilen varsayılan yöntem olmaya devam eder.
Alternatif yöntem: localhost geri çağrısını SSH üzerinden yönlendirin
Yerel makineniz ile uzak ana makine arasında bağlantı noktası yönlendirmesi yapabiliyorsanız Codex'in yerel geri çağrı sunucusuna (varsayılan: localhost:1455) tünel açarak standart tarayıcı tabanlı akışı kullanabilirsiniz.
- Yerel makinenizden bağlantı noktası yönlendirmesini başlatın:
ssh -L 1455:localhost:1455 user@remote- Bu SSH oturumunda
codex loginkomutunu çalıştırın ve ekrana yazdırılan adresi yerel makinenizde açı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 = trueayarı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 = trueolduğunda Codex,env_keyayarı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_authayarını tanımsız bırakın veyafalseolarak ayarlayın veenv_key,experimental_bearer_token,authvegateway_oauthdâhil kimlik bilgisi ayarlarını eklemeyin.