GitHub App 설치 토큰 요청별 형식 전환 헤더
설치 토큰 생성 요청에 임시 헤더를 넣어 새 토큰 형식과 기존 형식을 요청별로 강제할 수 있습니다.
교안에 영향
기존 안내 글에서 설치 토큰 형식을 고정적으로 설명한 부분은 이제 요청 헤더로 형식을 강제할 수 있다는 점을 반영해야 합니다.
요약
- POST /app/installations/:installation_id/access_tokens 요청에 X-GitHub-Stateless-S2S-Token 헤더를 지원합니다. - enabled 를 보내면 롤아웃 상태와 무관하게 stateless (JWT-format) 토큰을 받습니다. - disabled 를 보내면 롤아웃에 포함돼 있어도 stateful (classic opaque) 토큰을 받을 수 있습니다. - 잘못된 값은 무시되며, 이 헤더는 임시로 제공되고 나중에 더 이상 존중되지 않습니다.
바뀐 것
새 기능
- POST /app/installations/:installation_id/access_tokens 요청에 X-GitHub-Stateless-S2S-Token 요청 헤더를 추가했습니다.
- X-GitHub-Stateless-S2S-Token: enabled 로 stateless (JWT-format) 토큰을 강제로 받을 수 있습니다.
- X-GitHub-Stateless-S2S-Token: disabled 로 stateful (classic opaque) 토큰을 강제로 받을 수 있습니다.
개선
- 잘못된 헤더 값은 조용히 무시하고 기본 롤아웃 동작을 따르도록 했습니다.
기타
- 이 헤더는 임시 제공이며, 향후에는 더 이상 적용되지 않도록 할 예정입니다.
- GitHub Enterprise Cloud와 Data Residency 환경에서 이 변경이 적용되며, GitHub Enterprise Server 는 영향을 받지 않습니다.
- 기존 app installation tokens 는 만료될 때까지 계속 사용할 수 있습니다.
- 앞으로의 롤아웃은 GitHub App installation server-to-server tokens 와 Actions GITHUB_TOKEN 에 새 토큰 형식을 적용합니다.
- Copilot code review 흐름에서 사용하는 user-to-server tokens 형식 변경 계획을 별도로 안내할 예정입니다.
- 토큰 형식 확인은 ghs_ 접두사 뒤의 점 개수로 할 수 있으며, stateless JWT-format token 은 점 두 개, stateful opaque token 은 점이 없습니다.