Huny's Dev Blog
huny.dev

Microsoft agent-framework PyPI 공급망 침해(GHSA-764m-3ppc-5m73) 해부: Python .pth 시작 훅 자동 실행·IMDS/OIDC 토큰 탈취와 무실행(-S) 방어 경계 점검하기

2026년 11월 17일 PyPI에 게시된 Microsoft agent-framework 악성 버전(1.26.1·1.26.2)의 .pth 시작 훅 공격을 해부한다. Python site.py addpackage()가 import 없이도 초기화 단계에서 exec()를 실행하는 원리, 33분 만의 파일명 우회(agent_framework_meta.pth → af_runtime_diag.pth)와 Azure IMDS·GitHub OIDC 토큰 민팅 경로, python -S 정적 스캔·해시 고정·CI 권한 분리 경계를 정리한다.

Hun Jang
Hun Jang Nov 22, 2026

Microsoft agent-framework PyPI 공급망 침해(GHSA-764m-3ppc-5m73) 추상 표지 아트워크: 패키지 입력이 Python 런타임 초기화 경계에서 분기·검증되는 구조를 표현한 기하학 그래픽

Microsoft의 공식 Python AI 에이전트 패키지 agent-framework 악성 릴리스(1.26.1·1.26.2) 침해 사고의 핵심은 애플리케이션 코드가 해당 라이브러리를 단 한 줄도 import하지 않아도, 가상환경 안의 pip·pytest·python이 기동하는 매 순간 site-packages/*.pth 시작 훅이 exec()로 자동 실행돼 Azure IMDS와 CI/CD OIDC 토큰까지 능동 탈취했다는 점이다.

2026년 11월 17일(UTC) PyPI에 Microsoft의 공식 패키지 agent-framework의 변조 버전 1.26.1과 1.26.2가 약 33분 간격으로 연속 게시됐다(GHSA-764m-3ppc-5m73, Elastic Security Labs). 두 릴리스는 설치 시 site-packages 루트에 .pth 파일을 심어 Python 인터프리터가 시작될 때마다 백그라운드에서 환경변수·자격 증명 파일을 긁어모으고 클라우드 메타데이터 및 OIDC 엔드포인트에서 새 토큰을 발급해 외부(webhook.site)로 전송했다. PyPI는 두 버전을 즉시 격리(quarantine)하고 삭제했지만, 이미 설치된 캐시·가상환경·CI 러너에는 .pth 아티팩트와 유출 여파가 그대로 남는다.

이 글은 확인 기준일 November 22, 2026 시점의 GitHub 보안 권고(GHSA-764m-3ppc-5m73), Elastic Security Labs 침해 분석, 그리고 Python 공식 site 모듈 명세를 교차 확인해 정리했다. 격리·삭제된 악성 릴리스 바이너리를 직접 내려받아 실행하지 않았으며, 대신 로컬 Python 3.13.3의 Lib/site.py 실제 구현과 자체 작성한 정적 스캐너 및 격리 검증 스크립트(verify_pth_startup_hook_guard.py)로 .pth 자동 실행 조건과 python -S 우회 경계를 직접 검증했다.

1. 흔한 오해와 핵심 경계 3가지

.pth 기반 Python 공급망 공격을 일반 악성 패키지(__init__.py 변조 등)와 같은 모델로 대응하면 점검 단계에서 오히려 2차 실행을 유발할 수 있다. 반드시 구분해야 할 경계는 세 가지다.

  1. import agent_framework를 호출하지 않아도 페이로드가 즉시 실행된다: Python 인터프리터는 초기화 과정에서 site.py를 통해 site-packages 안의 모든 .pth 파일을 읽고, import 또는 import\t로 시작하는 줄을 exec()로 실행한다. 따라서 개발자가 agent-framework를 직접 임포트하지 않고 단순히 pip list, pytest, python --version 외의 어떤 스크립트(python -c ...)를 실행해도 페이로드가 매번 발동한다.
  1. 1차 격리 33분 만에 파일명을 바꿔 탐지를 회피한 1.26.2가 재업로드됐다: 2026년 11월 17일 20:35 UTC에 게시된 1.26.1은 agent_framework_meta.pth와 변조된 __init__.py를 사용했으나, PyPI 격리 직후인 21:08 UTC에 게시된 1.26.2는 af_runtime_diag.pth와 af_runtime_diag.py로 파일명을 바꿔 초기 IoC(침해 지표) 파일명 필터와 단순 diff 탐지를 우회했다. 의존성 패키지(agent-framework-core)는 정상 동작했기 때문에 기능 장애로 알아채기도 어렵다.
  1. 감염된 가상환경 안에서 pip uninstall로 복구하려 하면 그 자체가 트리거가 된다: pip 역시 Python 인터프리터 위에서 실행되므로, 의심 환경 내부의 python이나 pip를 호출하는 순간 site.py가 먼저 로드돼 .pth 페이로드가 한 번 더 실행된다. 트리아지(점검) 단계에서는 반드시 python -S로 site 모듈 초기화를 건너뛰거나, 가상환경 외부에서 파일 시스템 바이트를 직접 읽는 정적 스캐너로 먼저 확인해야 한다.

2. 공격 흐름·방어 경계 도식 및 릴리스 비교 표

Python .pth 시작 훅 공급망 침해 경로와 무실행(-S) 방어 경계 도식: site.py addpackage()의 자동 exec() 실행 단계와 해시 고정·python -S 정적 스캔·OIDC/IMDS 권한 분리 게이트 비교

정상 기준 버전(1.26.0)과 1·2차 악성 릴리스(1.26.1, 1.26.2)의 주요 차이를 비교하면 다음과 같다.

비교 항목
1.26.0 (정상 기준)
1.26.1 (1차 악성 릴리스)
1.26.2 (2차 회피 릴리스)
PyPI 게시 시점 (UTC)
침해 이전 정상 배포본
2026-11-17 20:35 UTC 게시 후 신속 격리
2026-11-17 21:08 UTC (33분 후 재게시) 후 격리
주요 아티팩트 / .pth
악성 .pth 훅 없음
agent_framework_meta.pth
변조된 __init__.py 포함
af_runtime_diag.pth
af_runtime_diag.py (파일명 위장)
실행 트리거
명시적 패키지 임포트 시에만 로드
가상환경 내 모든 Python 인터프리터 기동 (pip, pytest, 앱 실행 포함)
동일 (임포트 없이 site.py 초기화 단계에서 즉시 실행)
수집 및 능동 탈취 대상
해당 없음
최대 300개 프로세스 환경변수 · ~/.azure, ~/.npmrc, ~/.netrc, ~/.git-credentials, ~/.docker/config.json, .env · Azure IMDS
동일 + Azure DevOps OIDC(SYSTEM_ACCESSTOKEN) · GitHub Actions OIDC(id-token: write) 토큰 능동 요청 확대
유출 및 조치
신뢰 해시 핀닝 기준 버전으로 사용 가능
zlib 압축 + Base64 인코딩 후 webhook.site HTTP POST 전송
→ 환경 전량 폐기 및 키 회전 필수
동일 유출 경로 및 CI/CD OIDC 권한 탈취
→ 클라우드·GitHub·AI API 키 전면 재발급 필수

3. CPython site.py의 .pth 자동 실행 메커니즘과 OIDC 탈취 경계

3.1 CPython 3.13.3 addpackage() 실제 동작 확인

로컬 Python 3.13.3의 표준 라이브러리(Lib/site.py)를 직접 확인하면 .pth 파일이 인터프리터 기동 시 어떤 규칙으로 코드 실행으로 이어지는지 명확히 드러난다.

여기서 실무 보안 점검 시 놓치기 쉬운 두 가지 디테일이 확인된다. 첫째, utf-8-sig 디코딩 때문에 파일 맨 앞에 UTF-8 BOM(\xef\xbb\xbf)이 붙어 있어도 line.startswith(("import ", "import\t"))가 참이 되어 exec(line)가 정상 실행된다. 반대로 앞에 공백 한 칸( import ...)이 들어가면 실행 문이 아니라 디렉터리 경로로 취급된다. 둘째, 한 줄에 세미콜론(;)으로 연결된 구문(import threading, os; ...)도 단일 line 문자열로 exec()에 그대로 전달된다.

Python 공식 site 문서에서도 .pth 파일 내 import 줄 실행은 보안상 위험으로 인해 현재 deprecated 처리되었으며, 향후 pkg.mod:callable 형태의 명시적 .start 엔트리포인트 파일로 대체될 예정이다. 그러나 현재 배포된 대다수 Python 3.10~3.13 운영 환경에서는 여전히 .pth import 실행이 기본 활성화되어 있다.

3.2 정적 비밀 파일 수집을 넘어선 IMDS·OIDC 능동 민팅

이번 agent-framework 침해가 특히 치명적이었던 이유는 디스크에 저장된 정적 비밀(~/.azure, ~/.npmrc, ~/.docker/config.json, .env)만 읽는 데 그치지 않고 런타임에 유효한 단기 토큰을 능동적으로 발급(Minting)했다는 점이다.

  • Azure Managed Identity (IMDS): 클라우드 VM이나 컨테이너 러너에서 169.254.169.254 또는 IDENTITY_ENDPOINT에 접근해 해당 호스트 권한의 액세스 토큰을 실시간으로 요청했다.
  • CI/CD OIDC 토큰 (GitHub Actions / Azure DevOps): 워크플로에 id-token: write 권한이 부여되어 있거나 SYSTEM_ACCESSTOKEN이 노출된 잡에서는, 빌드 중 pip install 직후 실행되는 pytest·린터·테스트 스크립트가 site.py를 통해 .pth 훅을 가동시키며 즉시 OIDC 토큰을 탈취할 수 있다.

4. 로컬 Python 검증 스크립트 작성 및 실행 결과

의심 환경의 Python이나 pip를 직접 실행하지 않고도 .pth 동작 경계와 침해 지표를 점검할 수 있도록 로컬 검증 스크립트를 작성해 실행했다.

로컬 환경에서 python C:/Users/admin/.gemini/antigravity/scratch/verify_pth_startup_hook_guard.py를 실행한 결과는 다음과 같다.

  • CPython 3.13.3 site.py 및 -S 플래그 검증 (Check 1): 임시 디렉터리에서 site.addsitedir()를 호출했을 때 일반 import 훅(hook: 'FIRED')과 UTF-8 BOM 선행 import 훅(bom_hook: 'FIRED')은 모두 실행됐고, 선행 공백 줄( import ...)은 실행되지 않았다(leading_space: None). 반면 python -S로 실행한 서브프로세스는 site 모듈 자체가 로드되지 않아(python_minus_S_site_loaded: False) .pth 훅이 원천 차단됐다.
  • IoC 및 락파일·CI 경계 차단 검증 (Check 2): 모의 site-packages에서 agent_framework_meta.pth, af_runtime_diag.pth, af_runtime_diag.py 등 5건의 IoC 및 실행 훅을 무실행 스캐너로 전량 적발했다. 또한 정책 검증기에서 agent-framework==1.26.1·1.26.2, 범위 미고정(>=1.26.0), 그리고 해시/쿨다운 없이 id-token: write가 노출된 CI 설정이 모두 예외로 차단됐다.
  • 로컬 site-packages 읽기 전용 감사 (Check 3): 현재 시스템의 C:\Python313 및 C:\Python313\Lib\site-packages를 정적 감사한 결과 .pth 파일 0건, 침해 지표 0건으로 확인됐으며 전체 스크립트가 ALL CHECKS PASSED (checks passed)로 종료됐다.

5. 실무 도입 및 사고 대응 체크리스트

Python 기반 AI 에이전트 스택(agent-framework 등)을 운영하는 팀은 이번 GHSA-764m-3ppc-5m73 사례를 기준으로 패키지 설치 전·중·후 경계를 아래와 같이 점검해야 한다.

  • 의존성 해시 고정 및 신규 배포 쿨다운(Cooldown) 적용: 운영·CI 빌드의 pip install에는 --require-hashes가 포함된 락파일을 강제하고, uv를 사용하는 환경이라면 --exclude-newer로 최근 24~72시간 이내 신규 업로드된 버전의 자동 유입을 차단했는가? (이번 사고에서도 1.26.1과 1.26.2는 모두 게시 후 1시간 이내에 격리됐다.)
  • 트리아지 시 python -S 및 외부 정적 스캔 원칙 준수: 2026년 11월 17일 전후 빌드된 가상환경이나 컨테이너 이미지에 agent-framework 1.26.1·1.26.2 잔재가 있는지 점검할 때, 해당 환경 안의 pip·python을 직접 실행하지 않고 python -S 또는 외부 스크립트로 site-packages/*.pth 내 import 줄과 agent_framework_meta.pth, af_runtime_diag.pth 유무를 먼저 확인했는가?
  • CI/CD OIDC 권한(id-token: write) 및 IMDS 접근 격리: 의존성 설치·테스트 잡과 클라우드 배포용 OIDC 토큰 발급 잡을 분리하고, 빌드 러너 컨테이너에서 호스트 IMDS(169.254.169.254) 접근 및 임의 외부 도메인 이그레스(webhook.site 등)를 차단했는가?
  • 노출 환경 폐기 및 자격 증명 전량 회전: 영향 버전이 한 번이라도 설치·기동된 개발자 PC, CI 러너 캐시, Docker 레이어는 단순 다운그레이드로 끝내지 말고 환경 자체를 폐기한 뒤 Azure 서비스 주체·GitHub 토큰·AWS 키·LLM API 키를 전량 재발급했는가?

참고 자료 (References, 2026-11-22 확인)

확인 기준일: November 22, 2026

추천 글