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 권한 분리 경계를 정리한다.
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차 실행을 유발할 수 있다. 반드시 구분해야 할 경계는 세 가지다.
import agent_framework를 호출하지 않아도 페이로드가 즉시 실행된다: Python 인터프리터는 초기화 과정에서site.py를 통해site-packages안의 모든.pth파일을 읽고,import또는import\t로 시작하는 줄을exec()로 실행한다. 따라서 개발자가agent-framework를 직접 임포트하지 않고 단순히pip list,pytest,python --version외의 어떤 스크립트(python -c ...)를 실행해도 페이로드가 매번 발동한다.
- 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)는 정상 동작했기 때문에 기능 장애로 알아채기도 어렵다.
- 감염된 가상환경 안에서
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.pthaf_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-framework1.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