GitHub CLI lägger till OAuth-token som löper ut: så aktiverar och testar du integrationer

En token som en gång kopierats till en variabel eller ett skript kan sluta fungera när den löper ut. Den 21 oktober 2026 meddelade GitHub en offentlig förhandsversion av OAuth-inloggningsuppgifter som löper ut och förnyas automatiskt i GitHub CLI. Funktionen är valfri och avsedd för arbetsflöden där CLI hanterar autentiseringen.

Så aktiverar du förnybara inloggningsuppgifter

Du behöver GitHub CLI version 2.103.0 eller senare. Lägg till flaggan --expiring för en enskild inloggning:

gh auth login --expiring

Om du vill att CLI ska begära förnybara inloggningsuppgifter vid kommande inloggningar kör du:

gh config set expiring_credentials enabled

CLI lagrar en access token som löper ut tillsammans med en roterande refresh token och förnyar inloggningsuppgifterna när de behövs. Kommandot gh auth status visar autentiseringsstatus och den aktuella tokenens giltighetstid. Flaggan begär förnybara inloggningsuppgifter; om de utfärdas beror på värdtjänstens funktioner och OAuth-appens konfiguration. Om servern inte stöder dem använder CLI en vanlig token utan utgångstid.

Konfigurera Git som användare av inloggningsuppgifterna

För HTTPS-arkiv konfigurerar du GitHub CLI som Git credential helper:

gh auth setup-git

Då hämtar Git inloggningsuppgifter från gh, som kan förnya dem innan de används. GitHub rekommenderar Git version 2.46 eller senare: den gör det möjligt för CLI att markera inloggningsuppgifter som löper ut, så att Git inte cachelagrar dem efter att de blivit ogiltiga. GitHub CLI fungerar även med äldre Git-versioner, men uppmanar en gång att uppgradera.

Efter konfigurationen testar du en vanlig Git-åtgärd över HTTPS, till exempel att läsa fjärrarkivets status. Kontrollera att Git hämtar inloggningsuppgifterna via helpern: då testas hela autentiseringskedjan, inte bara inloggningen i CLI.

Kontrollera skript och externa appar

En svag punkt är ett skript eller tillägg som kör gh auth token en gång, sparar strängen och använder den igen senare: en sådan access token kan löpa ut. Om en extern process behöver en token ska den hämta en ny vid varje körning med gh auth token. Konsumenten måste själv kunna använda det aktuella värdet och hantera att token löper ut.

Innan du aktiverar funktionen i en arbetsmiljö bör du kontrollera CI-jobb, lokala skript, redigerartillägg och verktyg som hämtar token från en miljövariabel eller konfigurationsfil. Ta reda på om de hämtar ett aktuellt värde vid start eller förlitar sig på en sparad kopia. Behåll den tidigare autentiseringslösningen för processer som behöver en token med lång giltighetstid.

Var funktionen är tillgänglig

GitHub meddelade att funktionen stöds på github.com och ghe.com. GitHub Enterprise Server utfärdar sådana inloggningsuppgifter från och med version 3.23; på äldre versioner övergår en begäran om förnybara uppgifter till en vanlig token utan utgångstid. Funktionen är fortfarande valfri, men GitHub planerar att så småningom göra den till standard för nya inloggningar.

Rekommenderad arbetsgång: uppdatera GitHub CLI, aktivera begäran om förnybara inloggningsuppgifter, konfigurera Git med gh auth setup-git och kontrollera att externa processer inte sparar token. Det hjälper dig att upptäcka inkompatibla scenarier innan du byter.

GitHub publicerade detaljer i meddelandet om förhandsversionen och i dokumentationen för kommandot gh auth login.