GitHub App 설치 토큰, 새 형식 전환 완료…길이 약 520자로 확대

이번 소식

GitHub가 GitHub App 설치 토큰의 새 형식 전환을 완료했습니다. 저장소 작업을 자동화하는 앱이 발급받는 인증 토큰으로, 새로 발급되는 토큰은 기본적으로 ghs_APPID_JWT 형식을 사용합니다.

주요 변경

토큰 길이가 기존 40자에서 약 520자로 늘어납니다. 권한·저장소 접근 범위와 1시간 만료, REST 발급 경로는 그대로입니다. 시험 전환에 쓰던 X-GitHub-Stateless-S2S-Token 헤더는 원문 기준 2026년 11월 30일 폐기 예정이며, 세부 시각·시간대는 공개되지 않았습니다.

영향 대상과 활용

GitHub App 연동을 운영하는 개발자는 토큰을 40자로 제한한 검증 코드나 저장 필드, 긴 인증 헤더를 잘라내는 처리가 없는지 확인해야 합니다. 이전 형식만 인식하는 로그 마스킹도 새 토큰을 가리지 못할 수 있습니다. 직접 영향 대상은 GitHub App 연동을 구현·운영하는 개발자입니다.

사용 전 확인할 점

토큰 문자열을 내부 구조에 의존하지 않는 인증값으로 다루고, 사용 중인 라이브러리·저장·마스킹 처리가 새 길이를 수용하는지 점검하세요. 두 형식의 연동 검증을 마친 뒤 임시 헤더를 폐기일 전에 제거하는 것이 공식 안내입니다. 이번 소식에서는 실제 연동 시험을 수행하지 않았습니다.

공식 출처·발표 시점

발표 시각: 2026년 10월 3일 07:18:23 KST. 이번 공지는 4월에 시작한 전환의 완료를 알립니다. 11월 30일 폐기일은 원문 날짜이며, 정확한 KST 종료 시각은 확정할 수 없습니다.