GitHub App 설치 토큰 형식 변경 예고
새로 발급되는 GitHub App 설치 토큰의 형식이 길고 비상태형으로 바뀌며, 일부 환경부터 단계적으로 적용됩니다.
교안에 영향
설치 토큰 길이를 40자로 가정하거나 ghs_[A-Za-z0-9]{36} 같은 패턴으로 검사하던 기존 안내는 더 이상 맞지 않습니다.
요약
- 새로 발급되는 GitHub App installation tokens의 형식이 바뀌고, 더 긴 비상태형 토큰을 사용합니다. - ghs_ 접두사는 유지되지만 설치 토큰 형식이 ghs_APPID_JWT 로 바뀌며, 토큰 길이는 약 520자로 늘어날 수 있습니다. - 기존 App installation tokens는 만료될 때까지 계속 동작하고, 이번 변경은 GitHub Enterprise Cloud와 Data Residency 환경에 적용됩니다. - GitHub Actions의 GITHUB_TOKEN 과 다른 1차 통합부터 단계적으로 적용되며, user-to-server 토큰 변경은 아직 범위 밖입니다. - 토큰 길이나 정규식에 의존하지 말고, 데이터베이스 컬럼이 520자 이상을 담을 수 있도록 준비하라고 안내합니다.
바뀐 것
기타
- 새로 발급되는 GitHub App installation tokens의 형식이 더 긴 비상태형 토큰으로 바뀝니다.
- 설치 토큰의 형식이 ghs_APPID_JWT 로 변경되지만, ghs_ 접두사는 유지됩니다.
- 토큰 길이는 약 520자로 늘어나며 저장된 데이터에 따라 달라질 수 있습니다.
- 기존 App installation tokens는 만료될 때까지 계속 사용할 수 있습니다.
- 이 변경은 GitHub Enterprise Cloud와 Data Residency 환경에 적용되며, GitHub Enterprise Server는 영향받지 않습니다.
- GitHub Actions의 GITHUB_TOKEN 과 다른 1차 통합부터 먼저 새 형식이 단계적으로 적용됩니다.
- user-to-server 토큰은 아직 변경 범위가 아니며, Copilot code review flows 관련 변경은 추후 안내됩니다.
- 토큰을 고정된 길이나 패턴으로 검증하지 말고, 문자열로 취급하도록 권장합니다.
- ghs_[A-Za-z0-9]{36} 같은 정규식은 새 토큰과 맞지 않을 수 있습니다.
- access tokens를 저장하는 데이터베이스 컬럼은 최소 520자 이상을 담을 수 있어야 합니다.