GitHub CLI’ye süresi dolan OAuth belirteçleri eklendi: etkinleştirme ve entegrasyonları denetleme

Bir değişkene veya komut dosyasına bir kez kopyalanan belirteç, süresi dolduktan sonra çalışmayı durdurabilir. 21 Ekim 2026’da GitHub, GitHub CLI’de otomatik yenilemeyle süresi dolan OAuth kimlik bilgilerinin herkese açık önizlemesini duyurdu. Bu isteğe bağlı mod, kimlik doğrulamasını CLI’nin yönettiği iş akışları için tasarlandı.

Yenilenen kimlik bilgileri nasıl etkinleştirilir?

GitHub CLI sürümünüz 2.103.0 veya üzeri olmalı. Tek seferlik oturum açmak için --expiring bayrağını ekleyin:

gh auth login --expiring

Sonraki oturum açma işlemlerinde yenilenebilir kimlik bilgilerini istemek için şu komutu çalıştırın:

gh config set expiring_credentials enabled

CLI, süresi dolan erişim belirtecini dönen bir yenileme belirteciyle birlikte saklar ve ihtiyaç duyulduğunda kimlik bilgilerini yeniler. Kimlik doğrulama durumunu ve mevcut belirtecin geçerlilik süresini gh auth status komutuyla görebilirsiniz. Bayrak, yenilenebilir kimlik bilgileri ister; bunların verilip verilmeyeceği sunucunun yeteneklerine ve OAuth uygulamasının yapılandırmasına bağlıdır. Sunucu bunları desteklemiyorsa CLI, süresi dolmayan normal bir belirteç kullanır.

Git’i kimlik bilgisi tüketicisi olarak yapılandırın

HTTPS kullanan depolar için GitHub CLI’yi Git kimlik bilgisi yardımcısı olarak yapılandırın:

gh auth setup-git

Böylece Git, kimlik bilgilerini gh üzerinden ister; gh de bunları kullanılmadan önce yenileyebilir. GitHub, süresi dolan kimlik bilgilerinin geçerlilik süresi bittikten sonra önbelleğe alınmasını önlemek üzere CLI’nin bunları işaretlemesine olanak tanıyan Git 2.46 veya üzeri bir sürümü öneriyor. Daha eski Git sürümleriyle GitHub CLI çalışmaya devam eder, ancak bir kez güncelleme yapmanızı önerir.

Kurulumdan sonra, örneğin uzak deponun durumunu okuyarak HTTPS üzerinden sıradan bir Git işlemini deneyin. Git’in kimlik bilgilerini yardımcı üzerinden aldığını doğrulayın: böylece yalnızca CLI’de oturum açmayı değil, tüm kimlik doğrulama yolunu sınamış olursunuz.

Komut dosyalarını ve harici uygulamaları denetleyin

Riskli noktalardan biri, gh auth token komutunu bir kez çalıştırıp çıktıyı kaydeden ve daha sonra yeniden kullanan bir komut dosyası veya uzantıdır: bu erişim belirtecinin süresi dolabilir. Harici bir sürecin belirtece ihtiyacı varsa, her çalıştırmada gh auth token aracılığıyla güncel bir belirteç isteyin. Tüketici, güncel değeri kullanabilmeli ve belirtecin süresinin dolabileceğini hesaba katmalıdır.

Bu modu iş ortamında etkinleştirmeden önce CI görevlerini, yerel komut dosyalarını, düzenleyici uzantılarını ve belirteci bir ortam değişkeninden ya da yapılandırma dosyasından alan araçları denetleyin. Bunların çalıştırıldıklarında güncel bir değer isteyip istemediğini veya kayıtlı bir kopyaya güvenip güvenmediğini belirleyin. Uzun süre geçerli bir belirtece ihtiyaç duyan süreçler için mevcut kimlik doğrulama yöntemini koruyun.

Özellik nerelerde kullanılabilir?

GitHub, bu desteğin github.com ve ghe.com’da sunulduğunu duyurdu. GitHub Enterprise Server, bu tür kimlik bilgilerini 3.23 sürümünden itibaren verir; daha eski sürümlerde yenilenebilir kimlik bilgisi isteği, süresi dolmayan normal bir belirteçle sonuçlanır. Mod şu an için isteğe bağlıdır; GitHub, zaman içinde yeni oturum açma işlemlerinde varsayılan hâle getirmeyi planlıyor.

Uygulanabilir sıra şöyle: GitHub CLI’yi güncelleyin, yenilenebilir kimlik bilgisi isteğini etkinleştirin, gh auth setup-git ile Git’i yapılandırın ve harici süreçlerin belirteçleri kaydedip kaydetmediğini denetleyin. Bu, geçişten önce uyumsuz senaryoları tespit etmeye yardımcı olur.

GitHub, ayrıntıları önizleme duyurusunda ve gh auth login komutunun belgelerinde yayımladı.