GitHub Package Firewall 사용법｜npm 설정·설치 차단·예외 승인

GitHub Package Firewall은 npm 패키지를 내려받기 전에 기업 보안 정책으로 검사하는 기능입니다. 2026년 10월 20일 공개 미리보기로 출시됐습니다. 기업 정책을 설정한 뒤 개발 PC·CI·코딩 에이전트의 패키지 요청 경로도 바꿔야 합니다.

2026년 10월 21일 확인 기준
대상: GitHub Enterprise Cloud 및 데이터 레지던시 지원 Enterprise Cloud
지원 패키지: npm만 지원
요금: 미리보기 기간 무료, 정식 출시 시 사용량 기반 과금 예정
상태: 공개 미리보기로 기능·조건 변경 가능

GitHub Package Firewall 사용법｜npm 설정·설치 차단·예외 승인

어디에서 검사하나요?

외부 패키지 저장소와 설치 환경 사이에서 패키지 목록 요청과 다운로드를 검사합니다. 도서관에서 책을 빌리기 전에 확인하는 창구처럼 생각하면 쉽습니다. 정책을 켜도 외부 저장소로 직접 향하는 요청은 이 검사 경로를 통과하지 않습니다.

출처: GitHub 출시 안내

정책과 npm 설정

기업 관리자 또는 기업 보안 관리자가 Enterprise → Policies → Package firewall에서 설정합니다.

검사 항목 확인할 내용
알려진 악성 패키지 Advisory Database 악성 경고 대조
취약점 차단할 최소 심각도 선택
증명 정보 저하 이전 버전에 있던 SLSA 증명이 사라졌는지 검사
새 설치 스크립트 최근 추가된 설치 실행 스크립트 검사
최소 패키지 나이 기본 1일, 1~365일 설정 또는 0으로 비활성화

사용자 수준 .npmrc에 공식 예제를 적용합니다. ENTERPRISE는 기업 slug로 교체합니다. slug는 기업 URL에서 사용하는 식별자입니다. 토큰은 기업 구성원인 사용자·봇 계정과 연결되어야 하며, 문서는 공개 저장소 읽기 외의 상향 권한이 필요하지 않다고 안내합니다.

registry=https://package-firewall.githubapp.com/npm/enterprises/ENTERPRISE
//package-firewall.githubapp.com/npm/enterprises/ENTERPRISE/:_authToken=${GITHUB_TOKEN}

토큰 값은 CI 비밀값 등으로 안전하게 주입하고 저장소에 커밋하지 않습니다. 출처: GitHub 설정·예외 승인 문서

키 유출 경고를 받았다면 별도 대응 절차도 확인하세요.

설치가 차단됐을 때

보안 수정이 들어간 새 버전도 쿨다운 때문에 막힐 수 있습니다. npm 출력이나 CI 로그의 예외 요청 URL을 열고 저장소·패키지명·버전·사유를 제출합니다. 관리자는 Security and quality → Package firewall bypass에서 검토합니다.

운영 시에는 필요한 버전부터 검토하는 편이 좋습니다. *로 승인하면 모든 버전으로 예외가 넓어집니다. 오래된 예외는 Policies → Package firewall → Overrides → Package overrides에서 정리할 수 있습니다.

출처: GitHub 예외 관리 안내

설정 후에도 npm 설치가 안 될 때

설치 실패를 모두 보안 정책 차단으로 판단하지 마세요. 아래 순서는 npm 설정 구조와 GitHub의 인증 조건을 바탕으로 한 점검 제안입니다.

  1. 정책 차단 안내가 있다면: 차단 사유와 예외 요청 링크부터 확인합니다.
  2. 인증 오류라면: 설치를 실행하는 셸·CI 작업에 GITHUB_TOKEN이 전달되는지, 해당 계정이 기업 구성원인지 확인합니다. 토큰 값을 로그에 출력하지 마세요.
  3. 다른 저장소로 요청한다면: 프로젝트의 .npmrc, 명령줄 옵션, 환경변수, 패키지 scope별 registry를 점검합니다. 사용자 설정 한 곳만 바꿔도 모든 요청이 바뀐다고 가정하면 안 됩니다.

현재 프로젝트에서 아래 명령으로 기본 registry 설정을 확인할 수 있습니다. 다만 이 출력만으로 실제 다운로드 전체가 방화벽을 통과했다고 입증되지는 않습니다.

npm config get registry

출처: npm 공식 .npmrc 문서, npm 설정 문서

자주 묻는 질문

개인 무료 계정에서도 사용할 수 있나요?

출시 안내의 제공 대상은 GitHub Enterprise Cloud 고객입니다. 개인 무료 계정 지원으로 안내하지 않습니다.

Python 패키지도 검사하나요?

확인 기준일에는 npm만 지원합니다. 다른 생태계 지원은 공식 변경 내용을 확인해야 합니다.

도입 후 무엇을 점검하면 좋나요?

시험 환경에서 요청 경로, 토큰 주입, 차단 로그, 예외 승인 후 재시도를 확인하세요. 이는 운영 점검 제안이며, 실제 환경에서의 설치 결과는 별도 검증이 필요합니다.

함께 보면 좋은 글

이 블로그의 인기 게시물

갤럭시 S26 AI 기능 실제 활용법｜써보면 유용한 기능과 굳이 안 써도 되는 기능

이미지
갤럭시 S26 AI 기능이 궁금하다면 먼저 알아야 할 것은 “기능이 많다”가 아니라 “내 일상에서 시간을 줄여주는 기능이 무엇인가”입니다. 갤럭시 S26 시리즈는 삼성전자가 3세대 AI폰으로 강조한 모델입니다. 단순히 카메라가 좋아지고 성능이 올라간 스마트폰이 아니라, 사용자의 상황을 이해하고 필요한 기능을 더 빠르게 제안하는 방향으로 발전했습니다. 하지만 AI 기능이 많다고 해서 모든 기능을 매일 쓰는 것은 아닙니다. 어떤 기능은 실제로 자주 쓰면 편하지만, 어떤 기능은 처음에만 신기하고 금방 잊히기도 합니다. 그래서 갤럭시 S26을 구매할 때는 “AI 기능이 있다”보다 “내가 어떤 AI 기능을 실제로 쓸 수 있는지”를 기준으로 봐야 합니다. 이번 글에서는 갤럭시 S26 AI 기능, 나우 넛지, Now Brief, 서클 투 서치, 글쓰기 어시스트, 포토 어시스트, 오디오 지우개, AI 기능 추천 대상 까지 실제 사용 관점에서 정리했습니다. 작성 기준: 2026년 5월 기준 삼성전자 뉴스룸과 삼성닷컴 Galaxy AI 공식 정보를 참고했습니다. AI 기능은 지원 언어, 앱, 네트워크 연결, 삼성 계정 로그인, 기기 설정에 따라 사용 가능 여부가 달라질 수 있습니다. 📌 갤럭시 S26 가격 스펙 총정리 목차 갤럭시 S26 AI 기능, 결론부터 보면? 갤럭시 S26 AI 핵심 기능 한눈에 보기 나우 넛지: 필요한 정보를 먼저 제안하는 기능 Now Brief: 하루 일정을 요약해 주는 기능 서클 투 서치: 검색 시간을 줄여주는 기능 글쓰기 어시스트: 문자·메일·블로그 초안에 유용한 기능 포토 어시스트: 사진 편집을 쉽게 하는 기능 오디오 지우개: 영상 소리를 더 깔끔하게 만드는 기능 갤럭시 S26 AI 기능이 필요한 사람과 아닌 사람 결론: 갤럭시 S26 AI 기능은 실제로 쓸 만할까? 자주 묻는 질문 출처 갤럭시 S26 AI 기능, 결론부터 보면? 갤럭시 S26 AI 기능은 스마트...
Read more »

DISM/SFC 명령어 완전 정리 (초보자용) — Windows 손상·업데이트 오류 복구 가이드

이미지
💻 DISM/SFC 명령어 완전 정리 (초보자용) Windows 손상·업데이트 오류 복구 가이드 Windows 업데이트가 실패하거나 재부팅 후 되돌아가나요? 시스템이 느려지거나 파일과 기능이 비정상적으로 동작하나요? 이럴 때 DISM과 SFC는 "윈도우 자체 파일을 점검하고 복구"하는 대표적인 명령어입니다. 핵심은 순서 입니다. Microsoft는 일반적으로 DISM을 먼저 실행해 복구에 필요한 구성 요소(이미지/저장소)를 정리·복구한 뒤, SFC로 실제 시스템 파일을 최종 복구 하라고 안내합니다. 이 글에서는 초보자 기준으로 "언제 무엇을 입력해야 하는지", "성공/실패 시 다음 행동", "가장 많이 묻는 오류 메시지 대응"까지 한 번에 정리해드릴게요. 📑 목차 DISM과 SFC 차이 (딱 2줄로 이해) 실행 전 필수 준비 (실수 방지) 초보자용 "표준 복구 순서" (가장 추천) 가장 흔한 결과 메시지 해석 (초보자용) Windows 업데이트 "구성요소 초기화"까지 해야 할 때 그래도 해결이 안 되면 (공식 복구 옵션) FAQ (초보자가 가장 많이 묻는 질문) 🔍 DISM과 SFC 차이 (딱 2줄로 이해) 많은 분들이 DISM과 SFC를 헷갈려 하시는데, 각각의 역할을 정확히 이해하면 복구 과정이 훨씬 명확해집니다. 🛠️ DISM (Deployment Image Servicing and ...
Read more »

Microsoft Edge 'ZUM' 시작 페이지 완벽 삭제 가이드

이미지
지긋지긋한 시작 페이지 고정 문제, 초보자도 전문가처럼 100% 해결하는 법 Edge 브라우저를 켤 때마다 원하지 않는 ZUM 페이지가 나타나 당황하셨나요? 많은 분들이 겪는 이 문제는 단순한 설정 오류일 수도 있지만, 때로는 시스템 깊숙이 숨어있는 애드웨어(Adware)가 원인일 수도 있습니다. 보통 알집이나 알약 같은 무료 소프트웨어를 설치할 때 '제휴 서비스 추가' 항목을 체크 해제하지 않아 발생하는 경우가 많습니다. 이 글은 가장 기초적인 브라우저 설정부터, 레지스트리와 시스템 파일을 건드리는 전문가 영역까지 단계별로 안내합니다. 순서대로 하나씩 따라 하신다면 반드시 해결됩니다. 목 차 1단계: 기본 설정 점검 (브라우저 내부) 2단계: 외부 요인 차단 (바로가기 및 프로그램) 3단계: 브라우저 초기화 (설정 리셋) 4단계: 고급 시스템 정밀 진단 (스케줄러/레지스트리) 5단계: 최후의 수단 (재설치 및 계정 분리) 1단계: 기본 설정 점검 (브라우저 내부) 가장 먼저, 브라우저 자체의 설정이 변경되었는지 확인해야 합니다. 대부분의 가벼운 문제는 이 단계에서 해결됩니다. 1-1. 시작 페이지 설정 직접 수정 Edge 우측 상단의 점 3개 아이콘(⋯) > [설정] 으로 진입합니다. 좌측 메뉴 중 [시작, 홈 및 새 탭] 을 클릭합니다. 'Edge가 시작되는 경우' 항목 아래에 ZUM 주소가 등록되어 있는지 확인합니다. 주소 옆의 점 3개 아이콘을 눌러 과감하게...
Read more »