← 목록으로

PyPI, 보안 신호를 더 명확히 보여주는 개편된 프로젝트 페이지 공개

요약
  • PyPI가 보안 신호를 명확하게 전달하기 위해 프로젝트 페이지를 개편하고 보안 탭을 추가했습니다.
  • 사용자는 디지털 증명을 통해 파일의 출처와 빌드 정보를 확인할 수 있으며, 출처가 불분명하거나 비정상적인 경우 경고를 통해 보안 위협을 파악할 수 있습니다.
  • PyPI 프로젝트 페이지에 보안 탭이 추가됨. 파일별 디지털 증명으로 어떤 워크플로가 파일을 게시했는지, 빌드 증명이 있다면 어느 소스 커밋에서 빌드됐는지 확인할 수 있음
  • 출처 상태는 릴리스 파일의 증명 보유 여부로 계산함. 증명이 없다는 사실만으로 악성 파일인 것은 아니며, 파일의 출처를 암호학적으로 검증할 수 없다는 뜻임
  • 일부 파일에만 증명이 있거나, 같은 릴리스의 파일이 서로 다른 저장소나 빌드 시스템에서 만들어지면 경고를 표시함. 이전 릴리스와 비교해 저장소나 워크플로가 바뀌거나 증명이 사라진 경우도 알림
  • 프로젝트 상세 페이지는 출처 경고를 상단에 표시하고, 메타데이터를 검증 여부 대신 유용성에 따라 정렬함
  • 릴리스 파일 탭에 검색과 필터링, 파일별 출처 상태가 추가됨. 릴리스 이력 탭에서도 파일 수, 출처 상태, 릴리스 상태를 확인할 수 있음
개편 목적과 보안 신호
  • 7월 예고한 UI 업데이트가 완료돼 PyPI에 적용됨. Python 커뮤니티 사용자 조사를 바탕으로 보안 신호와 패키지 정보 표시를 개선함
  • Python 생태계가 빠르게 성장하면서 PyPI는 악의적 행위자에게 더 매력적인 표적이 됨. PyPI는 여러 보안 기능을 도입하고 사용자의 패키지 보안 판단을 돕는 역할을 확대함
  • 2024년 도입한 디지털 증명(digital attestations)은 릴리스 파일의 출처(provenance) 를 검증할 수 있는 기록을 제공함
    • 출처와 증명은 여전히 많은 사용자에게 낯설며, 기존 UI는 그 의미와 중요성, 한계를 충분히 전달하지 못했음
    • 이를 개선하기 위해 Kabu Creative와 협력해 OpenSSF Attestations Style Guide의 권고를 구현함
새 보안 탭과 출처 상태
  • 보안 탭은 릴리스의 출처 상태와 파일별 증명을 모아 릴리스 파일이 어디에서 왔는지 확인하는 전용 공간임
  • 각 릴리스의 출처 상태는 파일마다 증명이 있는지 확인해 계산하며, 일반적으로 다음 두 상태 중 하나임
    • Full Provenance: 릴리스 파일 100%에 지원되는 증명 유형 중 하나 이상이 있음
    • No Provenance: 릴리스의 어떤 파일에도 증명이 없음
  • 지원하는 증명 유형은 두 가지임
    • PyPI Publish: 파일을 PyPI Trusted Publisher가 게시했음을 확인함
    • SLSA Build Provenance: 파일을 정확한 소스 커밋, 빌드 플랫폼, 빌드 지침과 연결함
  • 증명 메타데이터는 UI에서 직접 확인할 수 있으며, 투명성 로그 링크에서 추가 정보를 볼 수 있음
  • No Provenance는 악성 판정이 아님. 오래된 릴리스나 Trusted Publishing을 아직 설정하지 않은 프로젝트에서 흔하며, 파일 출처를 암호학적으로 검증할 수 없다는 뜻임
    • 사용자는 유지관리 이력, 릴리스 패턴, 저장소 활동 등 다른 신뢰 신호로 보안을 평가해야 함
    • 패키지 유지관리자는 다음 릴리스에 Trusted Publishing과 증명을 생성하는 게시자 사용을 고려할 수 있음
출처 경고의 유형과 확인 방법
  • 출처 경고는 계정이나 게시 워크플로 탈취 등으로 파일이 프로젝트 유지관리자에게서 오지 않았을 가능성을 파악하도록 도움
    • 출처 메타데이터가 비정상적이거나 프로젝트 이력과 충돌하면 눈에 띄는 경고를 표시함
    • 정상적인 이유가 있는 경고도 많지만, 각각 설치 전에 확인할 필요가 있음
  • Incomplete Provenance는 일부 파일에만 증명이 있는 상태임
    • 예를 들어 wheel은 Trusted Publishing으로 게시했지만 소스 tarball은 API 토큰으로 업로드한 경우임
    • 설치 전에 릴리스 노트에서 빌드 문제를 확인하거나 프로젝트 이슈 트래커에 문의해야 함
  • Inconsistent Provenance는 같은 릴리스의 파일들이 서로 다른 빌드 시스템이나 소스 저장소에서 왔다는 뜻임
    • 증명 메타데이터를 확인해 모든 파일이 유지관리자가 통제하는 출처에서 왔는지 점검해야 함
  • Change of Provenance는 이전 릴리스와 다른 저장소나 워크플로에서 파일이 생성됐다는 뜻임
    • 조직 이름 변경이나 저장소 이전처럼 정상적인 경우가 많지만, 파이프라인 침해나 계정 탈취의 신호일 수도 있음
    • 릴리스 노트나 공식 채널에서 예정된 인프라 이전인지 확인해야 함
  • Loss of Provenance는 이전에 증명을 포함해 게시하던 프로젝트가 증명 없이 파일을 업로드하기 시작했다는 뜻임
    • API 토큰으로 되돌아갔거나 증명을 생성하지 않도록 설정을 바꾸는 등 의도적인 게시 절차 변경인지 확인해야 함
    • 예상하지 못한 변경이라면 검증될 때까지 해당 릴리스를 의심해야 함
  • 출처와 증명, 경고에 대한 추가 안내는 사용자 문서에서 확인할 수 있음
프로젝트 상세 페이지와 메타데이터
  • 출처 경고는 페이지 상단에 철회된 릴리스, 보관 처리된 프로젝트, 사전 릴리스 상태 배너와 함께 표시됨
    • 프로젝트나 릴리스가 격리된 상태라면 격리 배너만 표시하며, 다른 모든 경고와 배너보다 우선함
  • 릴리스가 Full Provenance 상태이거나 출처 경고가 있으면 사이드바에 출처 상태를 표시하고 보안 탭으로 연결함
  • 메타데이터는 기존의 검증 여부별 그룹화와 정렬 대신 유용성에 따라 정렬함
    • 각 항목에는 “PyPI data” 또는 “Data verified by PyPI” 라벨을 붙임
릴리스 파일과 릴리스 이력
  • 개편된 릴리스 파일 탭은 긴 파일 목록을 검색하고 필터링할 수 있음
    • 표에서 파일별 출처 상태를 확인할 수 있음
    • 늦게 업로드된 파일은 주황색 경고 아이콘으로 표시함
  • 지연 업로드 경고는 최초 릴리스 시각으로부터 14일이 지난 뒤 업로드된 파일이 하나 이상 있을 때 나타남
    • 이 경고는 2026년 7월 이전 릴리스에만 적용됨
    • 2026년 7월부터는 릴리스 후 14일이 지나면 새 파일을 거부하는 정책이 도입됨
  • 릴리스 이력 탭은 릴리스별 파일 수와 출처 상태를 보여줌
    • 격리, 철회, 보관 처리, 사전 릴리스 여부도 함께 확인할 수 있음
보안 안내 문서와 향후 활용
  • PyPI 사용자 문서도 확장됐으며, 패키지 보안 가이드에서 다음 항목을 안내함
    • 소스 코드 보안 평가
    • 패키지 출처 확인
    • 패키지 무결성 검증
    • 일반적인 보안 공격으로부터 보호
    • 보안 문제 신고
  • 새 보안 탭은 향후 추가될 증명 유형과 보안 공지를 위한 전용 공간으로 활용할 수 있음
  • 더 넓은 오픈소스 생태계에서도 활용할 수 있도록 이번 프로젝트의 디자인 패턴과 경고를 정리한 사례 연구를 OpenSSF Attestations Style Guide에 공개함
그냥 목록으로
원문 보기 ↗