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

GitHub가 4월 27일 시작한 무상태 설치 토큰 전환을 완료했다. 새 토큰은 약 40자에서 520자로 길어졌으며 권한·저장소 범위·1시간 만료는 유지된다. 전환 시험용 요청 헤더는 11월 30일 폐지되므로, 연동 시스템의 길이 제한과 비밀정보 마스킹 규칙을 점검해야 한다.

새로 발급되는 설치 토큰은 기본적으로 ghs_APPID_JWT 형식을 사용하며, ghs_ 접두사는 유지된다.

기존 토큰은 만료될 때까지 유효하고 설치 액세스 토큰 REST API 엔드포인트도 그대로다.

GitHub는 정확히 40자를 요구하는 검증, 저장소 길이 제한, 긴 Authorization 헤더를 거부하는 미들웨어, 구형 패턴만 인식하는 마스킹 규칙을 확인하라고 안내했다.

두 형식의 호환성을 검증한 뒤 11월 30일 전에 운영 코드에서 X-GitHub-Stateless-S2S-Token 헤더를 제거해야 한다.

인증 API를 바꾸지 않아도 토큰 저장 칸이나 프록시의 길이 제한 때문에 기존 연동이 실패할 수 있다.