공급망 보안 정보

GitHub의 공급망 보안 정보

소프트웨어 프로젝트를 개발할 때, 오픈 소스 라이브러리, 프레임워크 또는 기타 도구와 같이 애플리케이션을 빌드하고 실행하기 위해 다른 소프트웨어를 사용하는 경우가 많습니다. 이러한 리소스는 프로젝트가 정상적으로 작동하기 위해 의존하므로, 통칭하여 “종속성”이라고 합니다. 프로젝트는 이러한 수백 개의 종속성에 의존할 수 있으며, 이는 이른바 “공급망”을 형성합니다.

공급망은 보안 문제를 야기할 수 있습니다. 종속성 중 하나에 알려진 보안 취약점이나 버그가 있는 경우, 악의적인 행위자가 해당 취약성을 악용하여 예를 들어 악성 코드(“멀웨어”)를 삽입하거나, 민감한 데이터를 탈취하거나, 프로젝트에 기타 형태의 장애를 초래할 수 있습니다. 이러한 유형의 위협을 “공급망 공격”이라고 합니다. 공급망에 취약한 종속성이 포함되어 있으면 자체 프로젝트의 보안이 저하되며, 사용자 또한 위험에 노출됩니다.

공급망을 보호하기 위해 수행할 수 있는 가장 중요한 작업 중 하나는 취약한 종속성을 패치하고 모든 멀웨어를 교체하는 것입니다.

매니페스트 파일 또는 잠금 파일에서 종속성을 지정할 때 공급망에 직접 종속성을 추가합니다. 종속성을 전이적으로 포함할 수도 있습니다. 즉, 특정 종속성을 지정하지 않더라도 자신의 종속성에서 이를 사용하므로 해당 종속성에 종속됩니다.

GitHub는 환경에 포함된 종속성을 이해하고, 해당 종속성의 취약성을 파악하며, 이를 패치할 수 있도록 다양한 기능을 제공합니다.

GitHub의 공급망 기능은 다음과 같습니다. * 종속성 그래프 * 종속성 검토 * Dependabot alerts * Dependabot updates * Dependabot security updates * Dependabot version updates * 변경할 수 없는 릴리스 * 아티팩트 증명

종속성 그래프는 공급망 보안의 핵심입니다. 종속성 그래프는 리포지토리 또는 패키지의 모든 업스트림 종속성 및 퍼블릭 다운스트림 종속 항목을 식별합니다. 리포지토리의 종속성 그래프는 종속성과 취약성 정보와 같은 일부 속성을 추적하고 표시합니다.

GitHub의 다음 공급망 기능은 종속성 그래프에서 제공하는 정보를 사용합니다.

• 종속성 검토는 종속성 그래프를 사용하여 종속성 변경 내용을 식별하고 끌어오기 요청을 검토할 때 변경 내용의 보안 영향을 이해하는 데 도움이 됩니다.
• 종속성 그래프에서 제공되는 종속성 데이터를 Dependabot은 GitHub Advisory Database에 게시된 권고 목록과 교차 참조하고, 종속성을 검사하여 잠재적인 취약성이 감지되면 Dependabot alerts를 생성합니다.
• Dependabot security updates는 종속성 그래프와 Dependabot alerts를 사용하여 리포지토리에 존재하는 알려진 취약성이 있는 종속성을 업데이트하는 데 도움을 줍니다.

Dependabot version updates는 종속성 그래프를 사용하지 않고 종속성의 의미 체계 버전 관리를 대신 사용합니다. Dependabot version updates는 취약성이 없는 경우에도 종속성을 업데이트된 상태로 유지하는 데 도움이 됩니다.

개인 계정, 코드 및 빌드 프로세스 보호를 포함한 엔드투엔드 공급망 보안에 대한 모범 사례 가이드는 엔드투엔드 공급망 보안을 참조하세요.

기능 개요

종속성 그래프란?

종속성 그래프를 생성하기 위해 GitHub는 매니페스트 및 잠금 파일에 선언된 리포지토리의 명시적 종속성을 확인합니다. 사용하도록 설정하면 종속성 그래프는 리포지토리의 알려진 모든 패키지 매니페스트 파일을 자동으로 구문 분석하고 이를 사용하여 알려진 종속성 이름 및 버전으로 그래프를 생성합니다.

• 종속성 그래프에는 직접 종속성 및 전이적 종속성에 대한 정보가 포함됩니다.
• 기본 분기에 지원되는 매니페스트 또는 잠금 파일을 변경하거나 추가하는 GitHub에 커밋을 푸시하고, 누군가가 종속성 중 하나의 리포지토리에 변경 내용을 푸시할 때 종속성 그래프가 자동으로 업데이트됩니다.
• GitHub Actions를 사용하여 프로젝트를 빌드하는 과정에서 제공하는 정보도 종속성 그래프에 포함할 수 있습니다. 일부 패키지 에코시스템은 빌드 시점에 대부분의 전이적 종속성을 가져오므로, 빌드가 진행되는 동안 종속성 정보를 제출하면 공급망을 보다 완전하게 파악할 수 있습니다.
• GitHub에서 리포지토리의 기본 페이지를 연 다음 인사이트 탭으로 이동하여 종속성 그래프를 확인할 수 있습니다.
• 리포지토리에 대한 최소한의 읽기 권한이 있는 경우 GitHub UI 또는 GitHub REST API를 통해 리포지토리에 대한 종속성 그래프를 SPDX 호환 SBOM(Software Bill of Materials)으로 내보낼 수 있습니다. 자세한 내용은 리포지토리에 대한 소프트웨어 자료 청구서 내보내기을(를) 참조하세요.

종속성 제출 API을(를) 사용하여 선택한 패키지 관리자나 에코시스템의 종속성을 제출할 수 있습니다. 에코시스템이 매니페스트나 잠금 파일 분석용 종속성 그래프에서 지원되지 않는 경우에도 수행할 수 있습니다. 종속성 제출 API을 사용하여 프로젝트에 제출된 종속성은 제출에 사용된 탐지기와 제출된 시점을 표시합니다. 종속성 제출 API에 대한 자세한 내용은 종속성 제출 API 사용을 참조하세요.

종속성 그래프에 대한 자세한 내용은 종속성 그래프 정보을 참조하세요.

종속성 검토란 무엇인가?

종속성 검토는 검토자와 기여자가 모든 끌어오기 요청에서 종속성 변경 내용과 그 보안 영향을 이해하는 데 도움이 됩니다.

• 종속성 검토는 끌어오기 요청에서 추가, 제거 또는 업데이트된 종속성을 알려줍니다. 릴리스 날짜, 종속성 인기도 및 취약성 정보를 사용하여 변경 내용을 허용할지 여부를 결정할 수 있습니다.

•         **변경된 파일** 탭에 rich diff를 표시하여 끌어오기 요청에 대한 종속성 검토를 볼 수 있습니다.
  

종속서 검토에 대한 자세한 내용은 종속성 검토 정보을 참조하세요.

Dependabot이란 무엇인가?

Dependabot는 종속성에 존재하는 모든 보안 취약성에 대해 알려 주고, 종속성을 업그레이드하기 위한 풀 요청을 자동으로 열어 종속성을 최신 상태로 유지합니다. Dependabot 경고가 트리거되면 Dependabot 풀 요청은 사용 가능한 다음 보안 버전을 대상으로 하며, 새 릴리스가 게시되면 최신 버전을 대상으로 합니다.

“Dependabot”라는 용어에는 다음 기능이 포함됩니다.

• Dependabot alerts: 리포지토리의 보안 탭과 리포지토리의 종속성 그래프에 표시되는 알림입니다. 경고에는 프로젝트에서 영향을 받는 파일에 대한 링크와 고정 버전에 대한 정보가 포함됩니다.
• Dependabot updates:
  • Dependabot security updates: 경고가 트리거될 때 종속성을 보안 버전으로 업그레이드하도록 업데이트를 트리거합니다.
  • Dependabot version updates: 종속성을 최신 버전으로 유지하기 위해 예약된 업데이트입니다.

Dependabot에서 열리는 풀 요청은 작업을 실행하는 workflow를 트리거할 수 있습니다. 자세한 내용은 GitHub Actions를 통한 Dependabot 자동화에서 확인할 수 있습니다.

기본적으로 다음과 같습니다.

• GitHub은 리포지토리에 GitHub Actions가 활성화되어 있으면 GitHub Actions에서 Dependabot updates를 실행합니다.

• GitHub는 리포지토리에 GitHub Actions가 활성화되어 있지 않으면 기본 제공 Dependabot 애플리케이션을 사용하여 Dependabot alerts를 생성합니다.

자세한 내용은 GitHub Actions 실행기의 Dependabot 정보을(를) 참조하세요.

Dependabot security updates은(는) GitHub Actions의 취약한 종속성을 해결할 수 있습니다. 보안 업데이트를 사용하도록 설정하면 Dependabot은(는) 워크플로에 사용된 취약한 GitHub Actions을(를) 패치된 최소 버전으로 업데이트하기 위한 끌어오기 요청을 자동으로 발생합니다. 자세한 내용은 Dependabot 보안 업데이트 정보을 참조하세요.

Dependabot 경고란 무엇인가?

종속성 그래프와 알려진 취약성에 대한 권고를 포함하는 GitHub Advisory Database를 기반으로 Dependabot alerts는 새로 발견된 취약성의 영향을 받는 리포지토리를 강조 표시합니다.

• Dependabot은 검사를 수행하여 안전하지 않은 종속성을 검색하고 다음과 같은 경우 Dependabot alerts를 보냅니다.
  • GitHub Advisory Database에 새 권고가 추가됩니다.
  • 리포지토리에 대한 종속성 그래프가 변경됩니다.
• Dependabot alerts는 리포지토리의 보안 탭과 리포지토리의 종속성 그래프에 표시됩니다. 경고에는 프로젝트에서 영향을 받는 파일에 대한 링크와 고정 버전에 대한 정보가 포함됩니다.

자세한 내용은 Dependabot 경고 정보을(를) 참조하세요.

Dependabot 업데이트란 무엇인가?

Dependabot updates의 두 가지 유형은 Dependabot 보안 업데이트와 버전 업데이트입니다. Dependabot은 두 경우 모두 종속성을 업데이트하기 위한 자동 끌어오기 요청을 생성하지만 몇 가지 차이점이 있습니다.

Dependabot security updates:

• Dependabot 경고에 의해 트리거됨
• 알려진 취약성을 해결하는 최소 버전으로 종속성 업데이트
• 종속성 그래프에서 지원하는 에코시스템 지원
• 구성 파일이 필요하지 않지만 구성 파일을 사용하여 기본 동작을 재정의할 수 있습니다.

Dependabot version updates:

• 구성 파일 필요
• 구성한 일정에 따라 실행
• 구성과 일치하는 최신 버전으로 종속성 업데이트
• 다른 에코시스템 그룹 지원

Dependabot updates에 대한 자세한 내용은 Dependabot 보안 업데이트 정보 및 Dependabot 버전 업데이트 정보을 참조하세요.

변경할 수 없는 릴리스란?

리포지토리는 변경 불가능한 릴리스를 사용하도록 설정하여 게시 후 릴리스의 자산 및 관련 Git 태그가 변경되지 않도록 할 수 있습니다. 이렇게 하면 공격자가 사용하는 릴리스에 취약성을 주입하지 못하게 하여 공급망 공격의 위험을 줄일 수 있습니다. 또한 특정 릴리스에 의존하는 프로젝트가 중단될 가능성이 적다는 것을 의미합니다.

변경할 수 없는 릴리스를 만들면 릴리스에 대한 증명이 자동으로 생성됩니다. 이 증명을 사용하여 릴리스 및 해당 아티팩트가 게시된 정보와 일치하는지 확인할 수 있습니다.

아티팩트 증명이란?

소프트웨어 공급자는 GitHub Actions로 빌드된 소프트웨어에 대한 증명을 생성할 수 있습니다. 증명은 빌드의 출처(빌드에 사용되는 소스 코드 및 워크플로 실행) 또는 관련 SBOM(소프트웨어 청구서)을 설정하는 암호화 서명된 클레임입니다.

종속성에 대한 증명을 확인하여 공급망 보안을 강화할 수 있습니다. 증명은 보안을 보장하지는 않지만 소프트웨어가 빌드된 위치와 방법에 대한 정보를 제공하므로 종속성이 변조되지 않았음을 더 확신할 수 있습니다. Kubernetes 허용 컨트롤러와 같은 도구를 사용하여 배포를 제어하여 테스트되지 않은 빌드가 배포되지 않도록 방지할 수 있습니다.

GitHub Actions를 사용하여 조직의 자체 빌드에 대한 증명을 생성하면 빌드된 아티팩트가 linked artifacts page에 자동으로 업로드됩니다. 이 플랫폼을 사용하면 연결된 모든 아티팩트에서 스토리지 및 배포 레코드를 볼 수 있으므로 아티팩트를 빌드하거나 배포 컨텍스트에 따라 보안 경고를 필터링하는 데 사용되는 소스 코드 및 워크플로 실행을 찾을 수 있습니다.

기능 가용성

퍼블릭 리포지토리: * 종속성 그래프: 기본적으로 활성화되어 있으며 비활성화할 수 없습니다. * 종속성 검토: 기본적으로 활성화되어 있으며 비활성화할 수 없습니다. * Dependabot alerts: 기본적으로 활성화되어 있지 않습니다. GitHub는 안전하지 않은 종속성을 검색하고 종속성 그래프에 정보를 표시하지만 기본적으로 Dependabot alerts를 생성하지는 않습니다. 리포지토리 소유자 또는 관리자 액세스 권한이 있는 사용자는 Dependabot alerts를 사용하도록 설정할 수 있습니다. 사용자 계정 또는 조직이 소유한 모든 리포지토리에 대해 Dependabot 경고를 사용하거나 사용하지 않도록 설정할 수도 있습니다. 자세한 내용은 보안 및 분석 기능 관리 또는 조직의 보안 및 분석 설정 관리을(를) 참조하세요. * 아티팩트 증명: 모든 공용 리포지토리에서 사용할 수 있지만 빌드 워크플로에서 증명을 명시적으로 생성해야 합니다. 아티팩트 증명을 사용하여 빌드의 출처 설정을(를) 참조하세요.

프라이빗 리포지토리: * 종속성 그래프: 기본적으로 활성화되어 있지 않습니다. 리포지토리 관리자는 이 기능을 사용하도록 설정할 수 있습니다. 자세한 내용은 리포지토리의 종속성 탐색을(를) 참조하세요. * 종속성 검토: GitHub Team 또는 GitHub Enterprise Cloud를 사용하는 조직이 소유한 비공개 리포지토리에서 사용할 수 있으며, GitHub Code Security or GitHub Advanced Security 라이선스를 보유해야 합니다. 자세한 내용은 GitHub Advanced Security 소개 및 리포지토리의 종속성 탐색을(를) 참조하세요. * Dependabot alerts: 기본적으로 활성화되어 있지 않습니다. 프라이빗 리포지토리의 소유자 또는 관리자 액세스 권한이 있는 사용자는 해당 리포지토리에 대해 종속성 그래프 및 Dependabot alerts를 사용하도록 설정하여 Dependabot alerts를 사용하도록 설정할 수 있습니다. 사용자 계정 또는 조직이 소유한 모든 리포지토리에 대해 Dependabot 경고를 사용하거나 사용하지 않도록 설정할 수도 있습니다. 자세한 내용은 보안 및 분석 기능 관리 또는 조직의 보안 및 분석 설정 관리을(를) 참조하세요. * 아티팩트 증명서: GitHub Enterprise Cloud의 비공개 저장소에서만 사용할 수 있습니다.

모든 리포지토리 유형: * Dependabot security updates: 기본적으로 활성화되어 있지 않습니다. Dependabot alerts 및 종속성 그래프를 사용하는 리포지토리에 대해 Dependabot security updates를 사용하도록 설정할 수 있습니다. 보안 업데이트를 사용하도록 설정하는 방법에 대한 자세한 내용은 Dependabot 보안 업데이트 구성을(를) 참조하세요. * Dependabot version updates: 기본적으로 활성화되어 있지 않습니다. 리포지토리에 대한 쓰기 권한이 있는 사용자는 Dependabot version updates를 사용하도록 설정할 수 있습니다. 버전 업데이트를 활성화하는 방법에 대한 자세한 내용은 Dependabot 버전 업데이트 구성을 참조하세요. * 변경할 수 없는 릴리스:* 기본적으로 사용하도록 설정되지 않습니다. 리포지토리 또는 조직에 대해 릴리스 불변성을 사용하도록 설정할 수 있습니다. 릴리스 변경 방지을(를) 참조하세요.