공급망 보안 정보

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에서 리포지토리의 기본 페이지를 열고 인사이트 탭으로 이동하여 종속성 그래프를 볼 수 있습니다.
• 리포지토리에 대한 최소한의 읽기 권한이 있는 경우 GitHub UI 또는 GitHub REST API를 통해 리포지토리에 대한 종속성 그래프를 SPDX 호환 SBOM(Software Bill of Materials)으로 내보낼 수 있습니다. 자세한 내용은 "리포지토리에 대한 소프트웨어 자료 청구서 내보내기"을(를) 참조하세요.

또한 매니페스트 또는 잠금 파일 분석을 위한 종속성 그래프에서 지원하지 않는 에코시스템이더라도 종속성 제출 API을(를) 사용하여 원하는 패키지 관리자 또는 에코시스템에서 종속성을 제출할 수 있습니다. 종속성 제출 API을(를) 사용하여 프로젝트에 제출된 종속성에는 제출에 사용된 감지기와 제출 시점이 표시됩니다. 종속성 제출 API에 대한 자세한 내용은, "종속성 제출 API 사용" 항목을 참조하세요.

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

종속성 검토란?

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

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

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

Dependabot이란?

Dependabot은 종속성의 보안 약점을 알려 종속성을 최신 상태로 유지하며 Dependabot 경고가 트리거될 때 사용 가능한 다음 보안 버전으로 또는 릴리스가 게시될 때 최신 버전으로 종속성을 업그레이드하도록 자동으로 끌어오기 요청을 엽니다.

"Dependabot"(이)라는 용어는 다음과 같은 기능을 포함합니다.

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

Dependabot에서 연 끌어오기 요청은 작업을 실행하는 워크플로를 트리거할 수 있습니다. 자세한 내용은 "GitHub Actions를 통한 Dependabot 자동화" 항목을 참조하세요.

기본값으로:

• 리포지토리에 대해 GitHub Actions가 활성화된 경우 GitHub는 GitHub Actions에서 Dependabot updates를 실행합니다.

• 리포지토리에 대해 GitHub Actions가 활성화되지 않은 경우 GitHub는 GitHub의 기본 제공 Dependabot 애플리케이션을 사용하여 Dependabot alerts를 생성합니다.

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

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

Dependabot 경고란?

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

• 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 버전 업데이트 정보"을 참조하세요.

기능 가용성

퍼블릭 리포지토리:

• 종속성 그래프 - 기본적으로 사용하도록 설정되어 있으며, 사용하지 않도록 설정할 수 없습니다.
• 종속성 검토 - 기본적으로 사용하도록 설정되어 있으며, 사용하지 않도록 설정할 수 없습니다.
• Dependabot alerts - 기본적으로 사용하지 않도록 설정됩니다. GitHub는 안전하지 않은 종속성을 검색하고 종속성 그래프에 정보를 표시하지만 기본적으로 Dependabot alerts를 생성하지는 않습니다. 리포지토리 소유자 또는 관리자 액세스 권한이 있는 사용자는 Dependabot alerts를 사용하도록 설정할 수 있습니다. 사용자 계정 또는 조직이 소유한 모든 리포지토리에 대해 Dependabot 경고를 사용하거나 사용하지 않도록 설정할 수도 있습니다. 자세한 내용은 "개인 계정에 대한 보안 및 분석 설정 관리" 또는 "조직의 보안 및 분석 설정 관리"을 참조하세요.

프라이빗 리포지토리:

• 종속성 그래프 - 기본적으로 사용하지 않도록 설정됩니다. 리포지토리 관리자는 이 기능을 사용하도록 설정할 수 있습니다. 자세한 내용은 "리포지토리의 종속성 탐색"을(를) 참조하세요.

• 종속성 검토 - GitHub Enterprise Cloud를 사용하고 GitHub Advanced Security에 대한 라이선스가 있는 조직이 소유한 프라이빗 리포지토리에서 사용할 수 있습니다. 자세한 내용은 GitHub Enterprise Cloud 설명서를 참조하세요.

• Dependabot alerts - 기본적으로 사용하지 않도록 설정됩니다. 프라이빗 리포지토리의 소유자 또는 관리자 액세스 권한이 있는 사용자는 해당 리포지토리에 대해 종속성 그래프 및 Dependabot alerts를 사용하도록 설정하여 Dependabot alerts를 사용하도록 설정할 수 있습니다. 사용자 계정 또는 조직이 소유한 모든 리포지토리에 대해 Dependabot 경고를 사용하거나 사용하지 않도록 설정할 수도 있습니다. 자세한 내용은 "개인 계정에 대한 보안 및 분석 설정 관리" 또는 "조직의 보안 및 분석 설정 관리"을 참조하세요.

모든 리포지토리 유형:

• Dependabot security updates - 기본적으로 사용하지 않도록 설정됩니다. Dependabot alerts 및 종속성 그래프를 사용하는 리포지토리에 대해 Dependabot security updates를 사용하도록 설정할 수 있습니다. 보안 업데이트를 사용하도록 설정하는 방법에 대한 자세한 내용은 "Dependabot 보안 업데이트 구성."을 참조하세요.
• Dependabot version updates - 기본적으로 사용하지 않도록 설정됩니다. 리포지토리에 대한 쓰기 권한이 있는 사용자는 Dependabot version updates를 사용하도록 설정할 수 있습니다. 버전 업데이트를 사용하도록 설정하는 방법에 대한 자세한 내용은 "Dependabot 버전 업데이트 구성"을 참조하세요.