GitHub CLI toi vanhenevat OAuth-tunnukset: käyttöönotto ja integraatioiden tarkistus

Muuttujaan tai skriptiin kerran kopioitu tunnus voi lakata toimimasta vanhennuttuaan. GitHub ilmoitti 21. lokakuuta 2026 GitHub CLI:n julkisesta esikatselusta, jossa vanhenevat OAuth-tunnistetiedot päivittyvät automaattisesti. Ominaisuus otetaan käyttöön haluttaessa, ja se on tarkoitettu työnkulkuihin, joissa CLI hoitaa tunnistautumisen itse.

Vanhenevien tunnistetietojen käyttöönotto

Tarvitset GitHub CLI:n version 2.103.0 tai uudemman. Lisää lippu --expiring, kun kirjaudut sisään yksittäisen kerran:

gh auth login --expiring

Jos haluat pyytää päivittyviä tunnistetietoja myös tulevilla kirjautumiskerroilla, suorita:

gh config set expiring_credentials enabled

CLI tallentaa vanhenevan käyttöoikeustunnuksen yhdessä kiertävän virkistystunnuksen kanssa ja päivittää tunnistetiedot, kun niitä tarvitaan. Komento gh auth status näyttää tunnistautumisen tilan ja nykyisen tunnuksen voimassaoloajan. Lippu pyytää päivittyviä tunnistetietoja, mutta niiden myöntäminen riippuu isännän ominaisuuksista ja OAuth-sovelluksen asetuksista. Jos palvelin ei tue niitä, CLI käyttää tavallista, vanhenematonta tunnusta.

Määritä Git käyttämään tunnistetietoja

Määritä HTTPS-yhteydellä käytettäville repositorioille GitHub CLI Gitin tunnistetietojen apuohjelmaksi:

gh auth setup-git

Tällöin Git pyytää tunnistetiedot gh-komennolta, joka voi päivittää ne ennen käyttöä. GitHub suosittelee Gitin versiota 2.46 tai uudempaa: sen avulla CLI voi merkitä vanhenevat tunnistetiedot, jotta Git ei välimuistita niitä niiden vanhennuttua. Myös vanhemmat Git-versiot toimivat, mutta GitHub CLI pyytää päivittämään ne kerran.

Kun määritys on valmis, kokeile tavallista Git-toimintoa HTTPS-yhteydellä, esimerkiksi etärepositorion tilan lukemista. Varmista, että Git saa tunnistetiedot apuohjelmalta: näin testaat koko tunnistautumisketjun, et pelkkää CLI:hin kirjautumista.

Tarkista skriptit ja ulkoiset sovellukset

Riskikohta on skripti tai laajennus, joka suorittaa kerran komennon gh auth token, tallentaa tuloksen ja käyttää sitä myöhemmin uudelleen: käyttöoikeustunnus voi vanhentua. Jos ulkoinen prosessi tarvitsee tunnuksen, hae se tuoreena jokaisella käynnistyskerralla komennolla gh auth token. Kuluttajan on pystyttävä käyttämään ajantasaista arvoa ja huomioimaan tunnuksen vanheneminen.

Tarkista ennen ominaisuuden käyttöönottoa tuotantoympäristössä CI-tehtävät, paikalliset skriptit, editorilaajennukset ja työkalut, jotka saavat tunnuksen ympäristömuuttujasta tai asetustiedostosta. Selvitä, hakevatko ne ajantasaisen arvon käynnistyessään vai turvautuvatko tallennettuun kopioon. Säilytä aiempi tunnistautumistapa prosesseissa, jotka tarvitsevat pitkään voimassa olevan tunnuksen.

Missä ominaisuus on käytettävissä

GitHub ilmoitti tuen olevan saatavilla osoitteissa github.com ja ghe.com. GitHub Enterprise Server myöntää tällaisia tunnistetietoja versiosta 3.23 alkaen; vanhemmissa versioissa pyyntö päivittyvistä tunnistetiedoista vaihtuu tavalliseksi, vanhenemattomaksi tunnukseksi. Ominaisuuden käyttöönotto on toistaiseksi vapaaehtoista, mutta GitHub suunnittelee tekevänsä siitä ajan mittaan uusien kirjautumisten oletuksen.

Käytännössä kannattaa päivittää GitHub CLI, ottaa päivittyvien tunnistetietojen pyyntö käyttöön, määrittää Git komennolla gh auth setup-git ja tarkistaa, tallentavatko ulkoiset prosessit tunnuksia. Näin yhteensopimattomat käyttötavat voi havaita ennen käyttöönottoa.

GitHub julkaisi lisätiedot ominaisuuden esikatseluilmoituksessa sekä komennon gh auth login ohjeissa.