파이썬 패키지 저장소 PyPI가 프로젝트 상세 페이지를 개편해 공개했다. 핵심은 릴리스 파일이 어디에서 왔는지를 사용자가 직관적으로 확인할 수 있도록 '보안(security) 탭'을 신설하고, 파일 목록과 릴리스 이력 탭을 재설계한 것이다. 이번 작업은 지난 7월 예고된 UI 개선 계획의 마무리 단계로, 파이썬 커뮤니티 구성원을 대상으로 한 사용자 조사를 바탕으로 설계됐다. 디자인은 Kabu Creative가 맡았고 OpenSSF(오픈소스 보안 재단)의 자금 지원과 'Attestations Style Guide' 권고안을 토대로 구현됐다.
배경에는 파이썬 생태계의 빠른 성장과 함께 커진 공급망 공격 위험이 있다. PyPI는 악성 행위자에게 점점 더 매력적인 표적이 되고 있으며, 저장소 측은 그동안 여러 보안 기능을 내놓으며 사용자가 패키지 안전성을 스스로 평가할 수 있도록 돕는 역할을 넓혀 왔다. 2024년 도입된 디지털 증명(attestations)이 대표적이다. 이는 릴리스 파일의 출처(provenance)를 검증 가능한 기록으로 남기는 장치다. 문제는 출처나 증명이라는 개념 자체가 많은 사용자에게 여전히 생소했고, 기존 인터페이스는 그 의미와 중요성, 한계를 거의 설명해 주지 못했다는 점이다. 이번 개편은 바로 그 간극을 메우려는 시도다.
보안 탭이 보여주는 출처 상태
새 보안 탭은 릴리스의 출처 상태를 표시하고 파일별 증명을 보여주는 전용 공간이다. PyPI는 릴리스에 속한 각 파일이 증명을 가지고 있는지를 검사해 상태를 계산한다. 모든 파일이 증명을 갖추면 출처가 확인된 릴리스로 간주되며, 지원되는 증명은 두 종류다. 'PyPI Publish' 증명은 해당 파일이 신뢰할 수 있는 발행자(Trusted Publisher)를 통해 올라왔음을 확인해 주고, 'SLSA Build Provenance' 증명은 파일을 정확한 소스 커밋과 빌드 플랫폼, 빌드 지시까지 연결한다. 사용자는 증명 메타데이터를 UI에서 직접 살펴보거나 투명성 로그 링크를 통해 추가 정보를 확인할 수 있다.
반대로 '출처 없음(No provenance)' 상태도 있다. 이는 릴리스의 어떤 파일에도 증명이 없다는 뜻으로, 오래된 릴리스나 아직 Trusted Publishing을 설정하지 않은 프로젝트에서 흔하게 나타난다. 중요한 점은 출처가 없다고 해서 그 파일이 악성이라는 의미는 아니라는 것이다. 단지 파일의 출처를 암호학적으로 검증할 수 없다는 뜻일 뿐이다. 이 경우에는 관리자 이력, 릴리스 패턴, 저장소 활동 같은 주변 신뢰 신호에 의존해 안전성을 판단해야 한다. 자신이 패키지를 관리하는 쪽이라면 다음 릴리스부터 증명을 생성하는 발행자로 Trusted Publishing을 도입하는 것을 고려할 만하다.
경고는 '의심'이 아니라 '확인' 신호
이번 개편에서 실무적으로 가장 유의할 부분은 출처 경고(provenance warning)다. 이 경고는 파일이 프로젝트 관리자에게서 나온 것이 아닐 가능성, 예컨대 계정이나 발행 워크플로가 탈취된 상황을 식별하도록 돕는다. 다만 PyPI는 대부분의 경고에 정당한 이유가 있을 수 있다는 점을 분명히 하면서, 설치 전에 한 번씩 확인할 것을 권한다. 구체적으로는 몇 가지 유형이 있다. 같은 릴리스 안에서 일부 파일만 증명을 가진 경우(예: 휠은 Trusted Publishing으로, 소스 tarball은 API 토큰으로 업로드), 파일들이 서로 다른 빌드 시스템이나 저장소에서 나온 경우, 이번 릴리스가 이전과 다른 저장소·워크플로에서 나온 경우, 그리고 과거에는 증명과 함께 발행하던 프로젝트가 증명 없이 바꾼 경우 등이다.
각 경고의 실무 대응은 결이 같다. 조직명 변경이나 저장소 마이그레이션처럼 정당한 사유가 흔하지만, 동시에 파이프라인 침해나 계정 탈취의 신호일 수도 있다. 따라서 릴리스 노트나 프로젝트의 공식 채널, 이슈 트래커를 통해 인프라 이전이나 발행 방식 변경이 의도된 것인지 먼저 확인하는 것이 안전하다. 특히 증명을 쓰던 프로젝트가 API 토큰으로 회귀하는 등 예상치 못한 변화가 보인다면, 검증되기 전까지는 해당 릴리스를 신중하게 다루는 편이 낫다.
보안 탭 외에 프로젝트 상세 페이지도 손봤다. 재설계된 릴리스 파일 탭은 긴 목록을 검색·필터링할 수 있게 하고, 테이블 안에서 각 파일의 출처 상태를 보여준다. 또한 최초 릴리스 시점으로부터 14일이 지나 업로드된 '늦은 파일(late file)'을 주황색 경고 아이콘으로 표시한다. 이 경고는 14일 이후 신규 파일 업로드를 거부하는 정책이 도입된 2026년 7월 이전 릴리스에만 나타난다. 릴리스 이력 탭 역시 파일 수, 출처 상태, 그리고 격리(quarantined)·철회(yanked)·보관(archived)·사전 릴리스 같은 릴리스 상태를 함께 노출해 한눈에 파악할 수 있게 했다.
한국의 개발 실무 관점에서 이번 변화의 의미는 분명하다. 그동안 '이 패키지가 정말 메인테이너가 올린 것인가'라는 질문은 사실상 감과 평판에 의존해 왔는데, 이제 UI 차원에서 검증 가능한 신호와 그 한계를 함께 읽을 수 있게 됐다. 다만 한계도 뚜렷하다. 증명은 출처를 증명할 뿐 코드의 악성 여부를 판정하지 않으며, 증명이 없는 수많은 기존 패키지에 대해서는 여전히 사람의 판단이 필요하다. PyPI는 이번 작업의 디자인 패턴과 경고 체계를 OpenSSF 스타일 가이드에 사례 연구로 공개했고, 보안 탭을 향후 새로운 증명 유형과 보안 공지를 담을 공간으로 설계했다고 밝혔다. 결국 이 기능은 자동 방패가 아니라 더 나은 판단을 돕는 계기판에 가깝다.