보안 가이드

Microsoft Agent Framework PyPI 패키지(agent-framework 1.26.1 및 1.26.2)에 자격 증명 탈취 코드 배포: 설치했다면 무엇을 교체해야 하는가

PyPI의 agent-framework 1.26.1 및 1.26.2에 자격 증명을 훔치는 코드가 포함되어 있었습니다. GitHub 권고문 기준: 영향 버전, 시간대, 교체해야 할 항목.

게시 2026-11-19 업데이트 2026-11-19 최종 확인 2026-11-19 6분 읽기
이 페이지에서

대상: Microsoft Agent Framework(PyPI의 agent-framework 패키지)를 사용하는 Python 개발자, 그리고 CI나 빌드를 운영하는 모든 분. 이 글은 GitHub 보안 권고문과 PyPI 목록을 기반으로 하며, 공격 기법은 다루지 않습니다.

진행 중: 단체가 추가 내용을 발표하는 대로 이 글을 업데이트합니다

대상

Microsoft Agent Framework(PyPI의 agent-framework 패키지)를 사용하는 Python 개발자, 그리고 CI나 빌드를 운영하는 모든 분.

확인된 영향 범위표 보기 ↓
  • 영향 버전
  • 배포 시각
  • PyPI 상태
1개 더 보기
  • 코드의 동작

가능성이 있다고 한 항목

  • 영향 환경의 자격 증명
아직 확인되지 않은 사항
  • 패키지가 어떻게 배포되었는지, Microsoft가 밝힌 원인
  • 버전이 제거된 시점
  • 영향을 받은 환경의 수
1개 더 보기
  • 탈취된 데이터의 사용 여부
지금 할 일절차 보기 ↓
  1. 1.26.1 또는 1.26.2 설치 기록 찾기
  2. 설치된 환경 다시 구축하기
  3. 해당 환경에서 접근 가능했던 자격 증명 교체하기
2개 더 보기
  1. 교체 후 알 수 없는 사용 기록 확인하기
  2. 지금부터 버전을 고정하고 빌드 입력을 좁히기
마지막 확인
2026년 11월 19일 기준
후속 발표 예정과 확인 기록

권고문은 2026년 11월 18일(UTC)에 게시되었습니다. 이 사이트가 확인할 수 있는 범위에서 Microsoft는 자체 보안 공지를 발표하지 않았습니다. 발표되면 이 글을 업데이트하겠습니다.

설치했다면 오늘 할 일

1

1.26.1 또는 1.26.2 설치 기록 찾기

lockfile, CI 로그, 빌드 캐시, 내부 패키지 미러, 컨테이너 이미지를 검색하십시오. 빌드가 버전을 고정하지 않고 최신 버전을 가져왔다면, 11월 17일 20:35 UTC 이후에 실행된 설치를 자세히 확인하십시오.

PyPI에서 제거되어도 이미 설치되거나 캐시된 복사본은 사라지지 않습니다.

2

설치된 환경 다시 구축하기

권고문은 두 버전 중 하나라도 설치된 환경을 노출된 것으로 간주하라고 안내합니다. 환경을 정리하기보다 가상 환경, 컨테이너, CI 러너를 새로 만드는 것을 계획하십시오. 캐시와 미러에서 해당 버전을 삭제한 뒤, agent-framework==1.26.0과 같이 버전을 고정하여 다시 설치하십시오.

3

해당 환경에서 접근 가능했던 자격 증명 교체하기

그 환경에서 보였던 모든 자격 증명을 교체하십시오. 권고문이 나열한 유형별로 묶어서 확인하십시오.

  • 환경 변수에 저장된 토큰, 비밀번호, API 키
  • 클라우드(예: Azure), npm, Git, Docker의 자격 증명 파일
  • Hugging Face 토큰, Azure DevOps 에이전트 자격 증명, .env 파일
  • CI 토큰(권고문에 따르면 1.26.2는 GitHub Actions 토큰도 노립니다)

클라우드 관리자 권한과 CI 시크릿처럼 권한이 가장 넓은 항목부터 시작하십시오. 폐기 순서는 npm 공급망 웜 방어와 동일합니다.

4

교체 후 알 수 없는 사용 기록 확인하기

클라우드 활동 로그, Git 접근 기록, 패키지 레지스트리 배포 기록을 검토하여 직접 하지 않은 작업이 있는지 확인하십시오. 그런 흔적이 있다면 같은 환경의 다른 자격 증명도 교체하십시오.

5

지금부터 버전을 고정하고 빌드 입력을 좁히기

lockfile과 해시로 의존성을 고정하고, 새 릴리스를 자동으로 가져오지 마십시오. 새로 나온 릴리스의 도입을 늦추는 것도 도움이 됩니다. 시크릿이 어디에 저장되는지는 .env 파일과 API 키가 위험한 이유를 참고하십시오.

무슨 일이 있었나(GitHub 권고문 기준)

아래 내용은 GitHub Advisory Database의 권고문(GHSA-764m-3ppc-5m73, 2026년 11월 18일 게시)을 기반으로 합니다.

  1. 2026년 11월 17일, 20:35 UTC

    agent-framework 1.26.1이 PyPI에 배포되었습니다(wheel 파일만).
  2. 같은 날, 21:08 UTC

    agent-framework 1.26.2가 배포되었습니다.
  3. 이후

    두 버전 모두 PyPI에서 제거되었습니다. 권고문에 따르면 두 버전은 약 33분 간격으로 배포되었습니다.
  4. 11월 18일

    GitHub가 권고문을 게시했습니다.
권고문 내용
패키지
PyPI의 agent-framework(Microsoft Agent Framework)
영향 버전
1.26.1 및 1.26.2; 패치된 버전은 나열되지 않음
영향 없음
1.26.0 이하(권고문 기준)
동작 방식(권고문)
Python이 시작될 때 실행되므로 agent-framework를 import하지 않아도 실행됨
수집 대상
환경 변수, 클라우드·Git·Docker·Hugging Face 자격 증명 파일, CI 토큰; 1.26.2는 GitHub Actions 토큰 추가
권고문 지침
환경을 노출된 것으로 보고, 접근 가능한 자격 증명(CI 및 GitHub Actions 시크릿 포함)을 교체
공격 주체
권고문은 알려진 공격 캠페인과 연관짓지 않았다고 밝힘

확인된 사실과 확인되지 않은 사실

이 내용은 2026년 11월 19일 기준입니다.

항목공지 내용상태
영향 버전agent-framework 1.26.1 및 1.26.2확인됨(GitHub 권고문)
배포 시각11월 17일 1.26.1 20:35 UTC, 1.26.2 21:08 UTC확인됨(GitHub 권고문)
PyPI 상태두 버전 모두 제거됨; PyPI 프로젝트의 최신 버전은 1.26.0확인됨(권고문; PyPI 목록 확인)
코드의 동작자격 증명을 수집해 외부로 전송확인됨(GitHub 권고문)
영향 환경의 자격 증명노출된 것으로 간주가능성 있음(권고문 지침)
1.26.0 이하이번 침해 범위 밖영향 없음(권고문)
패키지 배포 방법권고문에 없음밝혀지지 않음
Microsoft 자체 공지이 사이트가 확인한 범위에서 찾지 못함조사 중
영향을 받은 환경의 수밝혀지지 않음밝혀지지 않음
탈취 데이터의 악용밝혀지지 않음밝혀지지 않음

이 내용의 해석: 노출 기간이 짧다고 안전한 것은 아닙니다

두 버전이 공개되어 있던 기간은 짧았지만, 버전을 고정하지 않고 최신 릴리스를 가져오는 CI 작업이나 그 기간에 실행된 빌드는 이 버전을 가져갈 수 있습니다. 다른 사람이 얼마나 설치했는지가 아니라 내 환경이 두 버전 중 하나를 설치했는지를 기준으로 판단하십시오. 이 사이트는 공개되지 않은 수치를 추측하지 않습니다.

패키지 파이프라인이 악용되면 무슨 일이 일어날 수 있나

패키지 관리자는 정당한 배포자의 이름으로 게시된 새 릴리스를 설치합니다. 일반적으로 배포 권한이 악용되면, 악성 코드는 정상적인 업데이트처럼 보이면서 자격 증명을 가진 환경에 전달됩니다. 권고문이 환경 전체를 노출된 것으로 보라고 하는 지침은 이를 반영합니다.

CI와 클라우드 자격 증명은 소스 코드 배포, 클라우드 리소스 운영, 다른 패키지 배포에 쓰일 수 있으므로 탈취된 자격 증명은 확산될 수 있습니다. 이전 사례는 LiteLLM 1.107.0 사건과 TanStack, Nx Console, GitHub가 연결된 사건에서 다루었습니다.

출처(공개 기록)

이 글의 사실은 아래 공개 정보에서 가져왔습니다. 악성 코드의 세부 내용, 연결을 시도하는 주소, 구체적인 침해 지표 값은 싣지 않았습니다.

  • GitHub Advisory Database, "Malicious code in agent-framework (PyPI)", GHSA-764m-3ppc-5m73(2026년 11월 18일 게시) — github.com
  • agent-framework의 PyPI 프로젝트 페이지(2026년 11월 19일 확인; 최신 버전은 1.26.0이며 1.26.1과 1.26.2는 목록에 없음) — pypi.org

업데이트 기록

2026-11-19: GitHub 권고문과 PyPI 목록을 기반으로 한 첫 번째 버전. 이 사이트가 확인한 범위에서 Microsoft 공지는 찾지 못했으며, 공지가 발표되면 업데이트하겠습니다.

다음으로 읽을 글

최신 속보

FAQ

Q어떤 버전이 영향을 받나요?
A

GitHub 권고문은 PyPI의 agent-framework 1.26.1 및 1.26.2를 나열하며, 패치된 버전은 없다고 명시합니다. 1.26.0 및 이전 버전은 영향을 받지 않는 것으로 나열되어 있습니다. 두 버전 모두 2026년 11월 17일에 배포되었으며, 현재는 PyPI에서 제거되었습니다.

Q언제 배포되어 있었나요?
A

권고문에 따르면 2026년 11월 17일 1.26.1은 20:35 UTC, 1.26.2는 21:08 UTC에 배포되었습니다. 권고문은 제거 시점을 밝히지 않았습니다.

Q악성 코드는 무엇을 가져가나요?
A

권고문에 따르면 토큰이나 비밀번호로 보이는 이름의 환경 변수, 클라우드·패키지·Git 도구의 자격 증명 파일, CI 토큰을 수집해 외부로 전송합니다. 1.26.2에는 GitHub Actions 토큰도 추가되었다고 합니다.

Q내가 설치했는지 어떻게 확인하나요?
A

lockfile, CI 로그, 빌드 캐시, 내부 미러에서 agent-framework 1.26.1 또는 1.26.2를 가져온 기록을 검색하십시오. 빌드가 버전을 고정하지 않았다면 11월 17일 기간에 설치가 실행되었는지 확인하십시오.

Q설치했다면 어떻게 해야 하나요?
A

권고문은 해당 환경을 노출된 것으로 보고, 그 환경에서 접근 가능한 자격 증명(CI 및 GitHub Actions 시크릿 포함)을 교체하라고 안내합니다. 환경을 다시 구축하고 캐시와 미러에서 해당 버전을 삭제하십시오.

Q원인은 무엇인가요?
A

권고문은 이번 사건을 알려진 공격 캠페인과 연결하지 않았고, 패키지가 어떻게 배포되었는지도 설명하지 않습니다. 이 사이트가 확인할 수 있는 범위에서 Microsoft는 원인에 대한 설명을 공개하지 않았습니다.