Bir ağ geçidine bağlanın

Bir model ağ geçidi yapılandırın ve yerleşik ağ geçidi OAuth desteği, bir API key veya kimlik bilgisi yardımcısıyla kimlik doğrulaması yapın.

Ağ geçidi ekibinizin sağladığı sağlayıcı ayarlarını ve kimlik doğrulama yöntemini kullanarak Codex'i kuruluşunuzun model ağ geçidine bağlayın. Ağ geçidi, model isteklerini Amazon Bedrock gibi arka uç sisteminize yönlendirir.

Mevcut bir yapılandırma olup olmadığını kontrol edin

Yöneticinizin test ettiği Codex istemcisini ve sürümünü yükleyin. Ayarları kuruluşunuz yönetiyorsa bu istemciyi açın ve size iletilen yönergelerdeki oturum açma adımlarını tamamlayın. Aşağıdaki sağlayıcı yapılandırma örneklerini atlayabilirsiniz.

  • CLI için seçili profili inceleyin ve codex doctor komutunu çalıştırın. Başlangıçtan sonra, etkin modeli ve sağlayıcıyı doğrulamak için /status kullanın.
  • macOS uygulaması için ~/.codex/config.toml dosyasını veya kuruluşunuzun sağladığı yönetilen yapılandırmayı inceleyin.
  • Windows uygulaması için %USERPROFILE%\.codex\config.toml dosyasını veya kuruluşunuzun sağladığı sistem yapılandırmasını inceleyin.

Beklenen ağ geçidi sağlayıcısı ve model zaten etkinse yöneticinizin sağladığı oturum açma adımlarını tamamlayın, ardından Bağlantıyı doğrulama bölümüne geçin. Yönetilen bir makineye ikinci bir sağlayıcı yapılandırması eklemekten kaçının. Ayarlar yöneticinizin ilettiği yönergelerden farklıysa yerel dosyaları düzenlemeden önce bunları hangi yapılandırma katmanının sağlaması gerektiğini sorun.

Ağ geçidi bağlantı bilgilerinizi edinin

Manuel kurulum için ChatGPT çalışma alanında oturum açmanızın mı, ağ geçidi kimlik doğrulamasının mı yoksa her ikisinin de mi gerektiğini doğrulayın.

Codex'i kendiniz yapılandırmak için ağ geçidi ekibinizden şu değerleri alın:

  • API yolu dahil HTTPS ağ geçidi temel URL'si; örneğin https://gateway.example.com/v1.
  • Kullanılacak model adı ve sağlayıcı kimliği.
  • Kimlik doğrulama yöntemi: yerleşik ağ geçidi OAuth, kapsamı sınırlandırılmış bir API key ve ortam değişkeni ya da yüklü bir kimlik bilgisi yardımcısı.
  • OAuth için yetkilendirme URL'si, belirteç URL'si, herkese açık istemci kimliği ve gerekli kapsamlar. Çerez veya özel üstbilgi kullanan ağ geçitleri için bunun adı.
  • Gerekli model kataloğu URL'si veya bir katalog dosyası ve bu dosyanın mutlak yerel yolu.

Sağlayıcıyı yapılandırın

config.toml dosyasını macOS veya Linux'ta ~/.codex/config.toml konumunda ya da Windows'ta %USERPROFILE%\.codex\config.toml konumunda açın.

URL'yi ve modeli yöneticinizin sağladığı değerlerle değiştirerek bu örneği mevcut yapılandırmanızla birleştirin. Mevcut bir anahtar veya tablo için ikinci bir tanım eklemeyin. Bu örnekte gpt-6-sol kullanılır; bunu özel bir katalog olmadan yalnızca yöneticiniz Codex sürümünüzün modeli tanıdığını ve birlikte gelen meta verilerin ağ geçidiyle eşleştiğini doğrularsa kullanın.

model = "gpt-6-sol"
model_provider = "enterprise-gateway"
web_search = "disabled"

[model_providers.enterprise-gateway]
name = "Organization Gateway"
base_url = "https://gateway.example.com/v1"
wire_api = "responses"
requires_openai_auth = false

Ardından ağ geçidi ekibinizin sağladığı kimlik doğrulama ayarlarını ekleyin.

enterprise-gateway örnek bir sağlayıcı kimliğidir. Aynı kimliği model_provider içinde ve bunun sağlayıcı ve kimlik doğrulama tablolarında kullanın. Bu örnek, ilk bağlantı testi için web aramasını devre dışı bırakır; yöneticiniz bu özelliği etkinleştirmeden önce özellik desteğini doğrulamalıdır.

Model kataloğunuzu yapılandırın

Codex'in seçtiğiniz modelin yeteneklerini ve talimatlarını nasıl aldığını ağ geçidi ekibinizle doğrulayın:

  • Yerleşik ad: Ağ geçidi, Codex sürümünüzle birlikte gelen model adını tam olarak kabul ediyor ve bunu eşleşen modele yönlendiriyorsa model değerini bu ada ayarlayın. Codex bu modelin meta verilerine zaten sahiptir.
  • Katalog uç noktası: Ağ geçidi Codex uyumlu meta veriler sunuyorsa tam katalog URL'sini kullanın. Bu, Codex katalog yanıtını uygulayan bir /v1/models uç noktası olabilir. Yalnızca model kimliklerini listeleyen bir yanıt, özel takma adlar için yeterli değildir.
  • Katalog dosyası: Ağ geçidiniz özel takma adlar kullanıyorsa ve yöneticiniz bir dosya dağıtıyorsa yerel models.json örneğini kullanın. Tek kimlik doğrulama yönteminiz yerleşik ağ geçidi OAuth ise ve özel meta verilere ihtiyacınız varsa yerel bir dosya kullanın.

API key veya yardımcıyla kimlik doğrulamasında, yöneticiniz bir katalog URL'si sağlıyorsa bunu mevcut [model_providers.enterprise-gateway] tablosuna ekleyin:

model_catalog_url = "https://gateway.example.com/codex/models.json"

Geçerli olan tüm model_catalog_json ayarlarını kaldırın; bu ayar URL'ye göre önceliklidir. Yöneticiler uç nokta gereksinimlerini uzak katalog kurulumu bölümünde bulabilir.

Yöneticiniz yerel bir model kataloğu dosyası sağlarsa dosyayı kaydedin ve mutlak dosya yolunu kullanarak ilk TOML tablosundan önce model_catalog_json ekleyin. Özel takma adlar, eşleşen katalog meta verileri gerektirir. Örneğin:

model_catalog_json = "/etc/codex/gateway-models.json"

Yöneticinizin birlikte sağladığı model adını ve kataloğu kullanın. Dosya belirtilen konumda mevcut değilse katalog yolu eklemeyin.

Bir kimlik doğrulama yöntemi seçin

Tarayıcıdan oturum açmak için yerleşik ağ geçidi OAuth desteğini, kapsamı belirlenmiş bir kimlik bilgisi için API key veya kuruluşunuz bir komut sağlıyorsa kimlik bilgisi yardımcısını kullanın.

{/* prettier-ignore */}

Yerleşik ağ geçidi OAuth desteğini kullanın

Ağ geçidi OAuth, ChatGPT oturum açma işleminden bağımsız çalışır. Ağ geçidiniz, kuruluşunuzun Microsoft Entra ID gibi kimlik sağlayıcısının verdiği erişim belirteçlerini kabul ediyorsa bunu kullanın. Codex, tarayıcıdan oturum açmayı, kimlik bilgilerinin şifreli saklanmasını ve yetkilendirme sunucusu bir yenileme belirteci verdiğinde belirteç yenilemeyi yönetir.

Yalnızca ağ geçidiyle kimlik doğrulamada, Codex CLI 0.166.0 ve sonraki sürümler erişim belirtecini varsayılan olarak Authorization: Bearer <gateway access token> içinde gönderir. Bu sağlayıcının http_headers veya env_http_headers ayarlarındaki tüm Authorization girdilerini kaldırın.

Ağ geçidi ekibiniz, PKCE ile yetkilendirme kodu akışını destekleyen bir genel OAuth istemcisi kaydetmelidir. Bu tabloyu sağlayıcı yapılandırmasına yani config.toml dosyasına ekleyin; URL'leri ve istemci kimliğini kendi değerlerinizle değiştirin:

[model_providers.enterprise-gateway.gateway_oauth]
authorization_url = "https://login.example.com/oauth/authorize"
token_url = "https://login.example.com/oauth/token"
client_id = "YOUR_PUBLIC_CLIENT_ID"
# redirect_port = 43127

scopes ve gerekirse resource alanlarını, kimlik sağlayıcınızın ve ağ geçidinizin gerektirdiği değerlerle bu tabloya ekleyin. Sağlayıcınız gerektiriyorsa yenileme belirteçleri için gereken kapsamları isteyin. Codex varsayılan olarak kullanılabilir bir geri döngü bağlantı noktası kullanır. Kimlik sağlayıcınız sabit bir yönlendirme URI'si gerektiriyorsa redirect_port alanını ayarlayın ve bu örnek için http://127.0.0.1:43127/callback adresini kaydedin.

Ağ geçidiniz bir çerez veya özel üstbilgi bekliyorsa OAuth tablosunda isteğe bağlı delivery alanını ayarlayın. Ağ geçidinizin doğruladığı yöntemi seçin:

delivery = { kind = "cookie", name = "auth-openid" }
delivery = { kind = "header", name = "X-Gateway-Token", scheme = "Bearer" }

Dağıtımınız ayrıca ChatGPT oturumu açılmasını gerektiriyorsa yukarıda gösterilen çerezi veya ayrı bir ağ geçidi üstbilgisini kullanın. Bkz. ChatGPT ile oturum açmayı etkinleştirme.

Bu akışı kullanabilmeniz için yalnızca statik bir API key kabul eden ağ geçidine OAuth belirteci ve bunun iletim yöntemi için destek eklenmelidir. Ağ geçidi, Bedrock için kullandığı AWS kimlik bilgileri gibi üst hizmetlere ait kendi kimlik bilgilerini yönetmeye devam eder.

Tek kimlik doğrulama yönteminiz OAuth olduğunda requires_openai_auth = false ayarını koruyun ve ağ geçidi kimlik bilgisi için daha önce kullanılan env_key, experimental_bearer_token veya auth ayarlarını kaldırın. Özel model meta verilerine ihtiyacınız varsa bir yerel model kataloğu kullanın; OAuth tek başına uzak katalog keşfini etkinleştirmez.

Masaüstü uygulamasını yeniden başlatın ve tarayıcıyı açmak için ağ geçidi oturum açma istemini izleyin. CLI'de codex komutunu çalıştırın ve Codex ağ geçidine ilk kez eriştiğinde tarayıcıdaki oturum açma adımlarını izleyin. Kuruluşunuzun oturum açma ve MFA işlemlerini tamamlayın, ardından istemciye dönün. Yetkinin süresi dolarsa veya Codex bunu yenileyemezse istendiğinde yeniden oturum açın.

Yerleşik ağ geçidi OAuth desteği, bir tarayıcı ve erişilebilir bir geri döngü geri çağrı adresi gerektirir. Cihaz koduyla alternatif oturum açma seçeneği yoktur. CLI, SSH üzerinden çalışıyorsa OAuth tablosunda redirect_port = 43127 ayarını yapın ve yukarıda açıklanan eşleşen yönlendirme URI'sini kaydedin. Tarayıcınızın bulunduğu makineden, Codex'i başlatmadan önce bu bağlantı noktasını yönlendirin:

ssh -L 43127:127.0.0.1:43127 user@remote

Bu SSH oturumunda codex komutunu çalıştırın ve ağ geçidi oturum açma URL'sini yerel tarayıcınızda açın. Bir kapsayıcı içindeki CLI de tarayıcıdan erişilebilen bir geri çağrı adresi gerektirir. Geri çağrı adresini erişilebilir hâle getiremiyorsanız bunun yerine bir API key veya kimlik bilgisi yardımcısı kullanın.

ChatGPT ile oturum açmayı etkinleştirin (önerilir)

Kuruluşunuz bir ChatGPT çalışma alanı kullanıyorsa oturum açmak, kullanıcıların birinci taraf eklentiler gibi kullanımlarına sunulan özelliklere erişmesini sağlar. Çalışma alanı denetimleriniz uygulanır ve model isteklerini ağ geçidiniz işlemeye devam eder. Özelliklerin kullanılabilirliğini karşılaştırın.

Elle kurulum için oturum açmadan önce mevcut [model_providers.enterprise-gateway] tablosunu güncelleyin:

  1. requires_openai_auth = true ayarını yapın ve base_url ayarının ağ geçidinizi göstermesini sağlayın. Codex'in birincil kimlik doğrulama için OpenAI kimlik bilginizi kullanması amacıyla tüm env_key, experimental_bearer_token ve sağlayıcı auth ayarlarını kaldırın.
  2. Ağ geçidi kimlik bilgisini ayrı olarak gönderin. Yerleşik ağ geçidi OAuth'u için gateway_oauth.delivery ayarını, ağ geçidinizin kabul ettiği çerezi veya özel üstbilgiyi kullanacak şekilde yapılandırın. API key veya kimlik bilgisi yardımcısı için bir özel kimlik doğrulama üstbilgisi kullanın. Authorization üstbilgisini OpenAI kimlik bilgisine ayırın.

Yöneticinizin belirttiği ChatGPT çalışma alanında oturum açın. İstenirse ağ geçidinde oturum açma işlemini tamamlayın, ardından bağlantınızı doğrulayın.

Yöneticiler yönetilen sağlayıcı ayarlarını dağıtabilir ve kimlik bilgilerinin iletilmesini doğrulayabilir.

Kimlik bilgilerini ağ geçidinde işleyin

Ağ geçidi her model isteğinde iki kimlik bilgisi alır. Örneğin, Codex ağ geçidi OAuth belirtecini bir çerezde gönderdiğinde:

POST /backend-api/codex/responses
Authorization: Bearer <ChatGPT token>
ChatGPT-Account-ID: <workspace ID, when available>
Cookie: auth-openid=<gateway token>

Ağ geçidi kimlik bilgisini doğrulayın ve ilgili çerezi veya özel üst bilgiyi kaldırın. Günlüklerdeki kimlik bilgilerini ve hassas istek verilerini maskeleyin. Üst sunucuya gönderilen isteklerde hangi kimlik bilgisinin kullanılacağını seçin:

  • Doğrudan OpenAI çıkarımı için kullanıcının kimlik bilgisini iletin (önerilir). Bu, OpenAI'ın kullanımı ilgili kullanıcıyla ilişkilendirmesini ve o kullanıcının çıkarım ayarlarını uygulamasını sağlar. Bu yol için ağ geçidi, /models ve /responses isteklerini https://chatgpt.com/backend-api/codex adresine vekil olarak iletmeli ve Authorization ile varsa ChatGPT-Account-ID üst bilgisini değiştirmeden aktarmalıdır.
  • Ağ geçidinin çıkarım sağlayıcısında kimlik doğrulaması yapmasını sağlayın. Ağ geçidinde o sağlayıcı için yapılandırılmış kimlik bilgilerini kullanın. Kullanıcının OpenAI belirtecini ve varsa ChatGPT-Account-ID üst bilgisini üst sunucuya gönderilen isteğe dahil etmeyin.

Bu diyagramlar, OpenAI çıkarımı için önerilen yolu gösterir.

Ağ geçidi anahtarının ChatGPT ile oturum açmayla birlikte çalışma şekli
Kimlik bilgisi komutunu bir başlatma yardımcısı aracılığıyla yeniden kullanın. Aynı ağ geçidi anahtarı Authorization üst bilgisinden X-Gateway-Key üst bilgisine taşınırken ChatGPT ile oturum açma, Authorization üst bilgisini sağlar.
Ağ geçidi, X-Gateway-Key üst bilgisini doğrulayıp kaldırır, ardından ChatGPT Authorization üst bilgisini ve varsa hesap kimliğini değiştirmeden Codex arka ucuna iletir.
Ağ geçidi OAuth desteğinin ChatGPT ile oturum açmayla birlikte çalışma şekli
API key tabanlı ağ geçidi kimlik doğrulamasını, ChatGPT ile oturum açmanın yanında yerleşik ağ geçidi OAuth desteğiyle değiştirin.
Ağ geçidi, kendisine ait OAuth çerezini işleyip kaldırır ve ChatGPT kimlik bilgisini Codex arka ucuna iletir.

Yönlendirme üst bilgileri ekleyin (isteğe bağlı)

Yöneticinizin sağladığı yönlendirme ayarlarını kullanın. Ağ geçidi operatörleri bu ayarları dağıtabilir ve seçilen rotayı ağ geçidi günlüklerinden kontrol edebilir.

Bu ağ geçidi yolunu yalnızca model sağlayıcısına yapılan istekler kullanır. Sesli oturumlar ayrı bir yol kullanır. Çalışma alanında oturum açma, MCP server'lar ve eklentiler de başka ağ yollarını kullanabilir.

İstemciyi başlatın

ChatGPT ile oturum açarken istemciyi başlatın ve yönetilen yapılandırmayı sağlayan çalışma alanında oturum açın. Yerleşik ağ geçidi OAuth desteğini kullanıyorsanız istendiğinde kuruluşunuzun ağ geçidinde oturum açma işlemini de tamamlayın. Ardından bağlantıyı doğrulayın.

Yerel olarak yapılandırılmış bir sağlayıcı için istemcinize yönelik talimatları izleyin.

CLI'ı yapılandırın

CLI, macOS veya Linux'ta varsayılan olarak ~/.codex/config.toml dosyasını okur. Sağlayıcı ayarlarını kaydettikten sonra codex komutunu çalıştırın. WSL içinde, CODEX_HOME başka bir konuma işaret etmediği sürece Linux yapılandırmasını ve yollarını kullanın.

macOS uygulamasını yapılandırın

macOS uygulaması aynı ~/.codex/config.toml dosyasını okur. Sağlayıcı ayarlarını kaydettikten sonra uygulamayı yeniden başlatın. Kimlik bilgisi için bir ortam değişkeni kullanıyorsanız bunun uygulama süreci tarafından erişilebilir olduğundan emin olun.

Windows uygulamasını yapılandırın

Sağlayıcı ayarlarını %USERPROFILE%\.codex\config.toml dosyasına yerleştirin, ardından uygulamayı yeniden başlatın. Komut destekli kimlik doğrulama için yöneticinizin yüklediği çözümleyiciyi kullanın. Örneğin, Unix kimlik doğrulama tablosunu şununla değiştirin:

[model_providers.enterprise-gateway.auth]
command = 'C:\Program Files\OpenAI\Codex\fetch-codex-gateway-token.exe'
args = ["print-token"]
timeout_ms = 30000
refresh_interval_ms = 300000

Windows TOML dosyalarında tek tırnaklı sabit dizeler, ters eğik çizgileri korur. Unix katalog yollarını da değiştirin; örneğin yöneticinizin sağladığı gerçek yolu kullanarak 'C:\ProgramData\OpenAI\Codex\models.json' biçiminde yazın.

MCP server'ları ve eklentileri ayrı olarak yapılandırın. Bir model ağ geçidi kimlik bilgisi, araçlarınıza veya bağlı sistemlerinize erişim yetkisi vermez.

Bağlantıyı doğrulayın

Yöneticinizin sağladığı sağlayıcı kimliğini ve model takma adını kullanın. Sağlayıcı, yapılandırılan bağlantıyı; model takma adı ise bu bağlantı üzerinden yönlendirilen bir modeli tanımlar. ChatGPT ile oturum açma ve ağ geçidi kimlik doğrulaması erişimi denetler ve her ikisi de gerekli olabilir.

Yapılandırmayı değiştirdikten sonra istemciyi yeniden başlatın. CLI'da codex başlatın ve etkin modeli ve sağlayıcıyı incelemek için /status kullanın. Masaüstü uygulamasında seçili modeli ve yapılandırmayı kontrol edin.

Yeni bir görevde şu prompt'u gönderin:

Reply with exactly: gateway-ok

Beklenen yanıt gateway-ok şeklindedir. Tek başına bir yanıt, hangi rotanın isteği işlediğini kanıtlamaz: yöneticinizden ağ geçidinin kullanıcı kimliğinizi, model takma adını ve amaçlanan üst hizmet rotasını kaydettiğini doğrulamasını isteyin. Modeli, kendisine adını sorarak belirlemeyin.

Bağlantı sorunlarını giderin

Belirti Kontrol edilecekler
Beklenen sağlayıcı etkin değil. Seçili profili ve yapılandırma önceliğini kontrol edin. Üst düzey anahtarların bir sağlayıcı tablosunun içinde olmadığını doğrulayın.
OAuth ile oturum açma veya belirteç iletimi başarısız oluyor. Genel istemci kaydını, yönlendirme URI'sini, kapsamları ve yapılandırılmış çerezi veya üstbilgiyi kontrol edin. Ağ geçidinin verilen erişim belirtecini kabul ettiğini doğrulayın.
API key veya yardımcı ile kimlik doğrulama başarısız oluyor. Kimlik bilgisi değişkeninin istemci sürecine ulaştığını veya yüklü yardımcının güncel bir belirteç alabildiğini kontrol edin. Yöneticiden ağ geçidi kimlik doğrulaması ile üst sağlayıcı kimlik doğrulamasını ayırt etmesini isteyin.
Model bulunamıyor. Sağlanan model adını doğrulayın ve yöneticiden modelin rotasını kontrol etmesini isteyin.
Model beklenmeyen yetenekler kullanıyor. Yöneticiden katalog meta verilerinin takma adın arkasındaki modelle eşleştiğini kontrol etmesini isteyin.
Akış takılıyor veya takip istekleri başarısız oluyor. Ağ geçidi sorumlusundan proxy arabelleğe almasını, akışı sonlandıran response.completed olayını ve Ağ geçidi uyumluluğunu kontrol etmesini isteyin.
Katalog veya yardımcı yolu çalışmıyor. Dosyanın Codex'in çalıştığı ortamda yapılandırılmış mutlak yolda bulunduğunu doğrulayın.

Yardım isterken istemci sürümünüzü, işletim sisteminizi, beklenen sağlayıcıyı ve model takma adını, kimlik doğrulama yöntemini ve başarısız olan adımı belirtin. Ağ geçidi sahibinin isteği bulabilmesi için hata mesajını ve istek zamanını ekleyin. Belirteçleri, çerezleri, yetkilendirme üstbilgilerini ve hassas promptları kaldırın. Kimlik bilgisi dosyalarını veya gizli bilgiler içeren bir yapılandırma dökümünü göndermeyin.

Mevcut bir ağ geçidi dağıtımını kullanın

Ağ geçidi ekibinizden Codex sağlayıcı ayarlarını ve onaylı model takma adını isteyin. Ekibin henüz bir Codex rotasını etkinleştirmesi gerekiyorsa yönetici geçiş kontrol listesini paylaşın.

İlgili belgeler