Michael Johnson서버가 허용된 IP 주소에서만 GitHub 웹훅을 받도록 설정되어 있다면 새 접두사 3개를 허용 목록에 추가하세요. 2026년 10월 29일 GitHub는 github.com으로 전송되는 웹훅의 새 범위가 Meta API의 hooks 필드에 추가됐다고 발표했습니다. 이 변경은 GitHub Enterprise Cloud를 포함한 모든 요금제에서 github.com으로 전송되는 웹훅에 적용됩니다.
추가할 범위
수동으로 업데이트하는 경우 GitHub가 안내한 CIDR 접두사는 다음과 같습니다.
9.234.98.160/289.234.98.176/289.234.106.48/28
기존에 허용된 GitHub 주소는 그대로 두고 이 주소들을 추가하세요. 허용 목록이 이미 Meta API를 통해 업데이트된다면 이 접두사를 따로 수정할 필요는 없습니다. 최신 웹훅 목록은 hooks 필드에 반환됩니다. Meta API 문서는 응답 예시의 값이 시연용이라고 안내하므로, 실제 구성에는 최신 데이터를 직접 요청하세요.
허용 목록 구성 방식 확인하기
먼저 허용된 주소 목록이 애플리케이션의 네트워크 방화벽, 리버스 프록시, 클라우드 정책 또는 기업 방화벽 중 어디에 설정되어 있는지 확인하세요. 그런 다음 시스템이 GET /meta의 전체 목록을 업데이트하는지, 아니면 수동으로 추가한 항목만 저장하는지 살펴보세요. 전자라면 hooks 필드가 동기화에 포함되는지 확인하고, 후자라면 이전 접두사를 삭제하지 말고 새 접두사 3개를 추가하세요.
GET /meta의 공개 데이터는 인증 없이 이용할 수 있습니다. GitHub는 서비스 주소가 바뀔 수 있으므로 허용 목록을 주기적으로 업데이트할 것을 권장합니다. 자동화를 위해 응답에서 hooks 필드를 가져와 네트워크 규칙을 적용하기 전에 전체 목록을 로컬 구성과 대조하세요.
업데이트 후 확인할 사항
새 CIDR 접두사가 활성 구성에 포함됐고 기존 항목도 유지됐는지 확인하세요. 그런 다음 웹훅 전송 기록과 네트워크 로그를 살펴 변경 후 거부된 요청이 있는지 확인합니다. IP 필터는 다른 검사와 함께 사용하는 것이 좋습니다. GitHub 권장 사항에는 인증서 검증을 포함한 HTTPS, 웹훅 비밀 키, 처리 전 이벤트 유형 확인이 포함됩니다.
GitHub는 웹훅 전송에 10초 이내에 2xx 코드를 응답할 것을 권장하며, 오래 걸리는 처리는 대기열로 넘길 수 있습니다. X-GitHub-Delivery 헤더를 사용하면 전송의 고유성을 확인하고 요청 재생 공격을 방지하는 데 도움이 됩니다.
정적 허용 목록을 사용한다면 공개된 접두사 3개를 모두 수동으로 추가하세요. 구성을 자동으로 관리한다면 Meta API를 통해 hooks 필드를 업데이트하고 현재 값과 로컬 목록을 주기적으로 대조하세요. 이렇게 하면 새 주소가 수신 웹훅을 필터링하는 규칙에서 빠지는 일을 방지할 수 있습니다.
