공급망 보안 정보

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: 종속성을 최신 버전으로 유지하기 위해 예약된 업데이트입니다.

GitHub Enterprise Server에서 Dependabot security updates 및 Dependabot version updates를 실행하려면 GitHub Actions가 필요합니다. Dependabot alerts에는 GitHub Actions가 필요하지 않습니다. 자세한 내용은 엔터프라이즈에 Dependabot 사용을(를) 참조하세요.

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

Dependabot 경고란 무엇인가?

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

• Dependabot은 검사를 수행하여 안전하지 않은 종속성을 검색하고 다음과 같은 경우 Dependabot alerts를 보냅니다.
  • GitHub.com에서 매시간 새 권고 데이터가 인스턴스로 동기화됩니다. 자세한 내용은 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:** 기본적으로 활성화되어 있지 않습니다. 두 기능 모두 엔터프라이즈 수준에서 엔터프라이즈 소유자에 의해 구성됩니다. 자세한 내용은 [AUTOTITLE](/admin/code-security/managing-supply-chain-security-for-your-enterprise/enabling-the-dependency-graph-for-your-enterprise) 및 [AUTOTITLE](/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise)을(를) 참조하세요.
  

•         **종속성 검토**: 인스턴스에서 종속성 그래프가 활성화되어 있고 조직 또는 리포지토리에 GitHub Advanced Security가 활성화된 경우 사용할 수 있습니다. 자세한 내용은 [AUTOTITLE](/get-started/learning-about-github/about-github-advanced-security)을(를) 참조하세요.
  

•         **Dependabot security updates:** 기본적으로 활성화되어 있지 않습니다. Dependabot alerts 및 종속성 그래프를 사용하는 리포지토리에 대해 Dependabot security updates를 사용하도록 설정할 수 있습니다. 보안 업데이트를 사용하도록 설정하는 방법에 대한 자세한 내용은 [AUTOTITLE](/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates)을(를) 참조하세요.
  

•         **Dependabot version updates:** 기본적으로 활성화되어 있지 않습니다. 리포지토리에 대한 쓰기 권한이 있는 사용자는 Dependabot version updates를 사용하도록 설정할 수 있습니다. 버전 업데이트를 활성화하는 방법에 대한 자세한 내용은 [AUTOTITLE](/code-security/dependabot/dependabot-version-updates/configuring-dependabot-version-updates)을 참조하세요.