의존성과 공급망 - AI 가 추천한 패키지를 믿기 전에
이 장에서 배우는 것
앞 장에서 게시판이 사용하는 비밀값을 코드와 저장소 밖으로 옮겼다. 이번에는 저장소에 들어오는 외부 코드를 살핀다. 게시글의 태그를 정리하는 기능을 부탁했더니 AI가 패키지 이름과 버전을 제안했다. 설치 목록에 옮기기 전에 그 이름이 의도한 프로젝트를 가리키는지, 선택한 버전에 알려진 문제가 있는지, 게시판 배포에 필요한 라이선스 조건을 충족하는지 확인해야 한다.
- AI가 제안한 패키지 이름을 설치 전에 확인한다.
- 버전 고정과 잠금 파일(lock file)이 각각 기록하는 범위를 설명한다.
- 의존성 목록을 알려진 취약 버전 표와 대조하고 결과의 범위를 읽는다.
- 배포할 버전의 라이선스 조건과 확인 근거를 기록한다.
문제 상황
운영자가 태그 목록에 Python과 python이 따로 표시된다는 문제를 알려 왔다. 개발자는 AI에게 공백을 정리하고 대소문자를 통일하는 함수를 요청했다. AI는 함수와 함께 아래와 같은 변경을 제안했다. 이 장의 패키지 이름과 버전, 취약점 기록은 모두 실습용 가상 데이터다.
태그 앞뒤의 공백을 제거하고 표기를 통일하는 데
demo-tag-neaten==1.2.0을 사용할 수 있다. 기존 의존성 목록에 한 줄을 추가하면 된다.
설치 목록의 변경 비교(diff)를 보면 추가된 것은 한 줄이다. 그러나 외부 코드를 도입하는 결정은 그 한 줄에서 시작된다. 설치 과정에는 패키지에 따라 빌드 코드가 관여할 수 있고, 게시판이 그 패키지를 가져다 쓰면 외부 코드도 서비스와 함께 실행될 수 있다. 기존 검사 함수는 목록에 버전 문자열이 들어 있는지만 보고 통과를 출력했다. 그 결과 담당자는 이름 확인과 취약점 대조까지 마쳤다고 생각하기 쉬웠다.
이번 변경에서는 태그 정리에 필요한 범위를 먼저 좁힌다. 게시판이 요구하는 동작이 양끝 공백 제거와 대소문자 무시 비교라면 str.strip()과 str.casefold()로 구현할 수 있다. 외부 패키지가 필요한 변경이라면 이름 확인을 거친 뒤 채택 여부를 결정한다. 실습 코드는 그 검토 과정 중에서 목록에 남은 이름과 버전을 자동으로 대조한다. 새 추천 이름, 취약 버전 기록이 있는 기존 항목, 표에서 일치 기록을 찾지 못한 기존 항목을 한 번에 검사한다.
설치 전에 이름과 출처를 확인한다
AI의 환각은 그럴듯한 이름을 실제로 존재하는 프로젝트처럼 제시하는 형태로 나타날 수 있다. 이름이 등록되어 있다는 사실만으로도 확인은 끝나지 않는다. 비슷한 이름의 별개 프로젝트가 있을 수 있고, 이전 검토 때 검색 결과가 없었던 이름이 나중에 등록될 수도 있다. 검토 기록에는 이름을 확인한 시점과 함께 어느 프로젝트를 의도했는지 식별할 수 있는 근거를 남긴다.
자기 서비스의 의존성을 검토할 때는 프로젝트 문서가 안내하는 배포 이름과 패키지 저장소의 배포 정보를 대조한다. 배포 정보가 가리키는 소스 저장소와 해당 버전의 릴리스도 살핀다. 문서에 나온 가져오기 이름과 설치 목록의 배포 이름은 서로 다를 수 있으므로 두 이름을 각각 기록한다. 제안한 AI가 준 링크 하나로 판단을 마치면 이름과 출처를 같은 답변에 의존하게 된다. 게시판 팀은 확인할 근거가 부족한 항목을 보류하고 설치 목록에 넣기 전에 표준 라이브러리로 요구사항을 충족할 수 있는지 판단한다.
실습에서는 팀이 이름과 출처 대조를 마쳤다고 가정한 목록을 코드 안에 둔다. 여기에 없는 이름에는 확인 필요를 표시한다. 실습 데이터만으로는 공개 저장소에 그 이름이 등록되어 있는지 판단할 수 없다. 또한 목록에 들어 있는 항목은 이름 확인 단계만 거친 것으로 해석한다. 버전별 취약점과 라이선스는 별도의 근거가 필요하다.
고정한 버전과 실제 해석 결과를 기록한다
의존성 파일의 demo-feed-reader==2.4.1은 게시판이 직접 사용하는 패키지의 버전을 지정한다. 직접 의존성이 다시 요구하는 패키지를 전이 의존성(transitive dependency)이라고 한다. 직접 의존성 하나를 고정해도 그 패키지가 허용 범위로 요구하는 하위 패키지는 다른 버전으로 해석될 수 있다. 게시판의 코드와 직접 의존성 목록에 변화가 없는데도 다른 날 설치한 환경에서 하위 패키지가 달라질 수 있는 이유다.
잠금 파일은 의존성을 해석한 결과를 기록한다. 도구와 형식에 따라 직접·전이 의존성의 버전에 더해 플랫폼별 조건이나 배포 파일의 해시(hash)를 담을 수 있다. 해시는 내려받은 파일의 내용이 기록과 일치하는지 대조하는 데 쓴다. 파일이 일치해도 그 버전에 알려진 취약점이 있는지는 별도로 확인한다. macOS에서 개발하고 Linux에서 배포한다면 잠금 결과가 어떤 Python 버전과 운영체제 조건을 다루는지도 검토한다.
| 기록 | 답할 수 있는 질문 | 게시판 변경에서 볼 곳 |
|---|---|---|
| 직접 의존성의 버전 지정 | 게시판이 이 패키지에 어떤 버전을 요구하는가 | 추가하거나 바꾼 요구사항 한 줄 |
| 잠금 파일의 해석 결과 | 해당 환경 조건에서 어떤 하위 패키지와 버전이 선택되는가 | 함께 추가·갱신·제거된 의존성과 적용 조건 |
| 잠금 파일에 기록된 해시 | 설치할 배포 파일의 내용이 기록과 일치하는가 | 새 버전과 배포 파일에 대응하는 해시 |
패키지를 갱신할 때는 요구사항 파일과 잠금 파일의 변경을 함께 검토한다. 예를 들어 피드 읽기 패키지의 버전 한 줄을 바꿨는데 잠금 결과에 파서와 문자 처리 패키지가 함께 들어왔다면, 두 항목에도 취약점과 라이선스 확인이 필요하다. 이 장의 목록은 검토할 배포 이름과 버전을 꺼내 놓은 작은 예다. 실제 잠금 파일을 생성하거나 해석하는 과정은 실습에 포함하지 않는다.
취약점 기록과 라이선스 근거를 대조한다
알려진 취약점을 확인할 때는 배포 이름과 선택된 버전을 보안 권고(advisory)의 영향 범위와 대조한다. 어떤 권고에는 영향받는 버전 구간과 수정판이 함께 적혀 있다. 실제 점검에서는 잠금 결과에 든 하위 패키지도 포함하고, 어떤 권고 자료를 언제 확인했는지 남긴다. 표에서 일치 항목을 찾지 못했다는 말은 사용한 자료와 검사 범위 안에서의 관찰이다. 같은 잠금 파일을 배포하더라도 권고 자료가 갱신되면 결과가 바뀔 수 있다.
이 장의 내장 표에는 영향받는 버전을 정확한 문자열로 열거한다. 버전 구간, 사전 배포판, 또는 버전 표기가 달라도 같은 버전으로 취급되는 경우를 해석하지 않는다. 실습에서 2.4.1과 2.4.2를 대조하는 이유는 버전 순서를 정하기 위해서가 아니라 표에 적힌 버전과 목록의 버전이 같은지 확인하기 위해서다. 운영 코드에서는 프로젝트가 따르는 버전 규칙과 권고의 범위 의미를 처리하는 점검 도구가 필요하다.
라이선스는 코드 사용과 배포 조건에 관한 검토다. 저장소에 표시된 요약을 단서로 삼고, 실제로 선택한 버전의 배포물에 포함된 라이선스 본문과 고지 파일을 찾아 근거를 남긴다. 게시판을 서버에서 운영하는 경우와 설치 이미지나 패키지를 다른 사람에게 전달하는 경우에는 살펴야 할 조건이 달라질 수 있다. 하위 패키지도 같은 방식으로 검토하고, 조건을 확인하기 어려운 항목에는 담당자와 확인할 질문을 기록한다. 이번 프로그램이 출력하는 위험도는 내장 취약점 표에서 가져오며, 라이선스 확인은 이 기록과 별도로 진행한다.
완성 코드
main.py
파일 맨 위에 게시판의 점검 대상, 출처를 확인했다고 가정한 이름, 내장 취약 버전 표를 둔다. 앞 장의 파일이나 설치된 외부 패키지를 읽지 않는다. 검사 함수는 상태와 설명을 돌려주므로 화면에 출력하기 전에 기대한 결과를 검증할 수 있다.
import re
DEPENDENCIES = (
("demo-tag-neaten", "1.2.0"),
("Demo_Feed.Reader", "2.4.1"),
("demo-page-format", "3.0.0"),
)
REVIEWED_NAMES = frozenset({
"demo-feed-reader",
"demo-page-format",
})
VULNERABLE_VERSIONS = {
("demo-feed-reader", "2.4.1"): (
"높음",
"DEMO-01 (내장 표의 취약 버전)",
),
}
def normalize_name(name):
return re.sub(r"[-_.]+", "-", name).lower()
def before_check(dependencies):
return "통과" if all(version for _, version in dependencies) else "보류"
def check_dependency(name, version):
normalized = normalize_name(name)
if normalized not in REVIEWED_NAMES:
return "확인 필요", "출처 확인 목록에 없는 이름"
return VULNERABLE_VERSIONS.get(
(normalized, version),
("일치 기록 없음", "내장 표 기준"),
)
def verify():
assert normalize_name("Demo__Feed.Reader") == "demo-feed-reader"
assert before_check(DEPENDENCIES) == "통과"
assert check_dependency("demo-tag-neaten", "1.2.0") == (
"확인 필요",
"출처 확인 목록에 없는 이름",
)
assert check_dependency("Demo_Feed.Reader", "2.4.1") == (
"높음",
"DEMO-01 (내장 표의 취약 버전)",
)
assert check_dependency("demo-feed-reader", "2.4.2") == (
"일치 기록 없음",
"내장 표 기준",
)
assert check_dependency("demo-page-format", "3.0.0") == (
"일치 기록 없음",
"내장 표 기준",
)
def main():
verify()
print(f"수정 전 검사: {before_check(DEPENDENCIES)}")
print("수정 후 검사:")
for name, version in DEPENDENCIES:
status, detail = check_dependency(name, version)
print(f"{name}=={version} | {status} | {detail}")
print("테스트: 통과")
if __name__ == "__main__":
main()
줄별 해설
import re는 배포 이름 표기를 통일하는 데 필요한 표준 라이브러리를 가져온다. DEPENDENCIES에는 이름과 선택된 버전의 쌍을 표시 순서대로 둔다. 이름을 원래 표기로 저장해 두면 출력에서 검토 중인 의존성 목록과 바로 비교할 수 있다. 여기서는 이름과 버전이 이미 분리된 데이터를 받으므로 요구사항 파일의 주석, 환경 조건, 버전 범위를 읽는 파서가 필요 없다.
REVIEWED_NAMES는 이름과 출처를 확인했다고 가정한 배포 이름의 집합이다. VULNERABLE_VERSIONS는 정규화한 이름과 버전을 함께 키로 쓴다. 같은 버전 문자열을 쓰는 다른 패키지에 이 기록이 붙는 일을 막기 위해서다. 키에 대응하는 값은 예제 위험도와 확인 근거다. DEMO-01은 이 프로그램 안에서 해당 기록을 다시 찾기 위한 예제 식별자다.
normalize_name()은 하이픈, 밑줄, 마침표가 연속된 부분을 하이픈 하나로 바꾸고 알파벳을 소문자로 바꾼다. 예제의 Demo_Feed.Reader가 표의 demo-feed-reader와 일치하게 되는 지점이다. 이 함수는 비교용 키를 만든다. 입력 이름이 올바른 배포 이름인지 검사하거나 배포 이름을 가져오기 이름으로 바꾸는 용도는 없다.
before_check()의 all()은 모든 버전 값이 비어 있지 않으면 참을 돌려준다. 버전 칸이 채워졌는지 확인하는 데는 쓸 수 있다. 이 결과를 보안 검사 전체의 결과로 사용하면 새로 제안된 이름과 내장 표에 올라 있는 버전이 모두 통과한다. check_dependency()는 먼저 비교용 이름을 만들고, 출처 확인 목록에 이름이 없으면 그 단계에서 확인 필요 상태를 반환한다. 이름을 확인한 항목은 사전의 get()으로 이름과 버전의 쌍을 조회한다. 키가 없을 때도 어떤 표를 기준으로 판단했는지 돌려준다.
verify()는 구분자가 연속된 이름의 변환, 수정 전 검사의 누락, 미확인 이름, 취약 버전과 일치하는 경우, 같은 패키지의 다른 버전, 기록이 없는 패키지를 검사한다. 특히 같은 패키지의 두 버전에 다른 결과를 기대하므로 키에서 버전을 빠뜨리는 변경을 잡을 수 있다. main()은 검증을 먼저 수행하고 각 상태를 목록 순서대로 출력한다. 마지막 조건문은 파일을 직접 실행했을 때만 main()을 호출한다. 시간이나 임의 값이 출력에 관여하지 않아 같은 파일을 다시 실행하면 같은 결과를 얻는다.
실행 결과
다음 두 명령을 main.py가 있는 디렉터리에서 차례로 실행한다. 첫 명령은 컴파일 경고를 오류로 취급해 확인하며 정상일 때 출력이 없다. 두 번째 명령은 검사와 출력까지 실행한다.
python3 -W error -m py_compile main.py
python3 main.py
예상 출력은 다음과 같다.
수정 전 검사: 통과
수정 후 검사:
demo-tag-neaten==1.2.0 | 확인 필요 | 출처 확인 목록에 없는 이름
Demo_Feed.Reader==2.4.1 | 높음 | DEMO-01 (내장 표의 취약 버전)
demo-page-format==3.0.0 | 일치 기록 없음 | 내장 표 기준
테스트: 통과
첫 줄의 통과는 버전 값 세 개가 모두 채워져 있었다는 뜻이다. 수정 후에는 추천받은 이름을 보류할 근거와 기존 패키지 버전을 다시 검토할 근거가 각각 드러난다. 맨 아래 테스트 통과는 검사 함수가 예제에서 기대한 상태를 반환했다는 뜻이다. 의존성 변경을 리뷰할 때도 이렇게 함수의 테스트 결과와 의존성별 판정을 따로 읽는다.
실무에서 자주 틀리는 것
아래의 틀린 코드와 고친 코드는 각각 main.py의 정의를 가져오는 짧은 실행 예다. 같은 디렉터리에서 Python 대화형 실행기에 한 블록씩 입력하면 두 판단의 차이를 볼 수 있다.
버전 칸이 채워지면 출처 확인도 끝난 것으로 처리한다
틀린 코드는 버전 값의 참·거짓을 설치 검토의 결과로 사용한다. 예제의 새 추천 이름도 버전 값이 있으므로 통과가 나온다.
from main import DEPENDENCIES, before_check
print(before_check(DEPENDENCIES[:1]))
고친 코드는 이름과 버전을 함께 검사 함수에 넘긴다. 출처를 확인할 근거가 없으므로 확인 필요가 나온다.
from main import DEPENDENCIES, check_dependency
status, _ = check_dependency(*DEPENDENCIES[0])
print(status)
목록의 배포 이름 표기를 그대로 키로 사용한다
틀린 코드는 구분자와 대소문자가 다른 키를 그대로 찾는다. 표에 해당하는 기록이 있는데도 None을 얻는다.
from main import DEPENDENCIES, VULNERABLE_VERSIONS
print(VULNERABLE_VERSIONS.get(DEPENDENCIES[1]))
고친 코드는 조회 전에 배포 이름을 정규화하는 검사 함수를 쓴다. 출력에서 원래 이름을 확인하면서 조회에는 통일된 키를 사용할 수 있다.
from main import DEPENDENCIES, check_dependency
print(check_dependency(*DEPENDENCIES[1]))
표에 없는 항목을 안전하다고 표시한다
틀린 코드는 내장 표의 조회 실패를 서비스가 사용해도 된다는 판정으로 바꾼다. 표가 비어 있어도 같은 판정이 나오는 방식이다.
from main import DEPENDENCIES, VULNERABLE_VERSIONS
print(VULNERABLE_VERSIONS.get(DEPENDENCIES[2], "안전"))
고친 코드는 일치 여부와 자료의 범위를 함께 출력한다. 운영자가 후속 검토 기록에 옮길 때도 판정의 범위를 유지할 수 있다.
from main import DEPENDENCIES, check_dependency
status, detail = check_dependency(*DEPENDENCIES[2])
print(status, detail)
한눈에 보기
| 검토 항목 | 대조할 자료 | 기록할 결과 |
|---|---|---|
| 이름과 출처 | 프로젝트 문서, 배포 정보, 릴리스 | 배포 이름, 확인한 출처, 보류 사유 |
| 고정과 잠금 | 요구사항과 잠금 파일의 변경 비교 | 직접·전이 의존성 버전과 적용 환경 |
| 알려진 취약점 | 선택 버전과 권고의 영향 범위 | 일치 기록, 확인 자료와 시점 |
| 라이선스 | 선택한 배포물의 본문과 고지 파일 | 배포 방식에 따른 조건과 확인 근거 |
연습 문제
check_dependency("DEMO..FEED_reader", "2.4.1")을 호출하면 어떤 상태가 나오는지 예측한다. 어떤 두 값으로 표를 조회하는지 적고 실행으로 확인한다.- 예제 표에서
demo-feed-reader의2.4.0도 같은 기록의 영향 버전이라고 가정한다. 기존 판정을 유지하면서 표와 테스트를 수정한다. - 게시판의 직접 의존성 한 줄을 갱신했다. 잠금 파일에는 별도의 하위 패키지도 새로 추가되었다. 배포 전에 그 항목에 대해 확인할 정보를 세 가지 적는다.
정답과 해설
상태는 높음이다. 연속된 마침표가 하이픈 하나로 바뀌고 밑줄도 하이픈으로 바뀐다. 소문자로 바꾼 이름
demo-feed-reader와 버전2.4.1이 조회 키다.VULNERABLE_VERSIONS에 키("demo-feed-reader", "2.4.0")을 더하고2.4.1과 같은 값을 연결한다.verify()에2.4.0이 높음을 반환하는 검사를 추가한다. 기존의2.4.1일치 검사와2.4.2불일치 검사를 함께 실행하면 새 기록의 적용 범위를 확인할 수 있다.먼저 잠금 파일에서 하위 패키지의 정확한 이름과 선택 버전, 그 항목이 들어오는 환경 조건을 확인한다. 다음으로 해당 버전을 보안 권고의 영향 범위에 대조한다. 마지막으로 그 버전의 배포물에서 라이선스 본문과 고지 파일을 찾아 게시판의 배포 방식에 적용되는 조건을 기록한다.
현업에서 이렇게 본다
의존성 변경을 리뷰할 때 나는 먼저 게시판이 그 코드에 어떤 일을 맡기는지 본다. 태그 양끝의 공백을 지우는 변경이라면 표준 라이브러리 함수의 동작을 테스트하는 것으로 검토를 끝낼 수 있다. 외부 패키지가 필요한 변경이라면 작은 기능 설명 옆에 배포 이름의 출처와 잠금 파일의 변경을 함께 두는 편이 판단하기 쉽다. 나중에 새 권고를 받았을 때도 그때 선택한 버전과 그 버전이 들어간 이유를 한곳에서 추적할 수 있다. 다음 장에서는 외부 코드를 들이는 결정에 이어, 게시판이 언어 모델에 어떤 데이터와 권한을 건네는지 살핀다.