Skip to main content

코드 검사 병합 보호 설정

code scanning 검사를 통과하지 못한 풀 리퀘스트를 차단함으로써 코드베이스의 보안을 철저히 유지합니다.

누가 이 기능을 사용할 수 있나요?

관리자 역할이 있는 조직 소유자, 보안 관리자 및 조직 구성원

Code scanning은 다음 리포지토리 유형에서 사용할 수 있습니다.

  • GitHub.com에 대한 퍼블릭 리포지토리
  • GitHub Team, GitHub Enterprise Cloud 또는 GitHub Enterprise Server에 대한 조직 소유의 리포지토리로, GitHub Code Security 가 활성화되어 있습니다.

리포지토리의 병합을 보호하기 위한 규칙 집합을 구성하기

  1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.

  2. 리포지토리 이름 아래에서 Settings를 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.

    탭을 보여 주는 리포지토리 헤더의 스크린샷. "설정" 탭이 진한 주황색 윤곽선으로 강조 표시됩니다.

  3. 왼쪽 사이드바의 "코드 및 자동화"에서 규칙을 클릭한 다음 규칙 세트를 클릭합니다.

    리포지토리에 대한 "설정" 페이지의 사이드바 스크린샷. "규칙" 하위 메뉴가 확장되고 "규칙 세트" 옵션이 주황색 윤곽선으로 표시되어 있습니다.

  4.        **새 규칙 세트**를 클릭합니다.
    
  5. 분기에 적용할 규칙 세트를 생성하려면 새 분기 규칙 세트를 선택하세요.

  6. "규칙 집합 이름" 아래에 규칙 집합의 이름을 입력합니다.

  7. 필요에 따라 기본 적용 상태를 변경하려면 Disabled 를 클릭하고 적용 상태를 선택합니다.

  8. "분기 보호"에서 code scanning 결과 필요를 선택합니다.

  9. "Required tools and alert thresholds"에서 Add tool을 클릭하고 드롭다운에서 code scanning 도구를 선택합니다. 예를 들어 "CodeQL"을(를) 선택합니다.

  10. code scanning 도구의 이름 옆에서:

    • 경고를 클릭하고 없음, 오류, 오류 및 경고 또는 모두 중 하나를 선택합니다.
    • 보안 경고를 클릭하고 없음, 위험, 높음 이상, 중간 이상 또는 모두 중 하나를 선택합니다.

    "규칙 집합" 설정의 "필수 도구 및 경고 임계값" 섹션 스크린샷

경고 심각도 및 보안 심각도 수준에 대한 자세한 내용은 코드 검사 경고 정보을(를) 참조하세요.

규칙 집합을 리포지토리에서 관리하는 구체적인 방법은 리포지토리에 대한 규칙 세트 관리를 확인하시기 바랍니다.

조직 전체의 모든 리포지토리에 적용할 병합 보호 규칙 세트를 구성하기

  1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음, Your organizations를 클릭합니다.

  2. 조직 옆에 있는 설정을 클릭합니다.

  3. 왼쪽 사이드바의 "Code, planning, and automation" 섹션에서 Repository를 클릭한 다음 Rulesets를 클릭합니다.

    조직의 설정 페이지 스크린샷. 사이드바에서 "규칙 집합"이라는 레이블이 지정된 링크가 주황색 윤곽선으로 표시되어 있습니다.

  4.        **새 규칙 세트**를 클릭합니다.
    
  5. 분기에 적용할 규칙 세트를 생성하려면 새 분기 규칙 세트를 선택하세요.

  6. "규칙 집합 이름" 아래에 규칙 집합의 이름을 입력합니다.

  7. 필요에 따라 기본 적용 상태를 변경하려면 Disabled 를 클릭하고 적용 상태를 선택합니다.

  8. "분기 보호"에서 code scanning 결과 필요를 선택합니다.

  9. "Required tools and alert thresholds"에서 Add tool을 클릭하고 드롭다운에서 code scanning 도구를 선택합니다. 예를 들어 "CodeQL"을(를) 선택합니다.

  10. code scanning 도구의 이름 옆에서:

    • 경고를 클릭하고 없음, 오류, 오류 및 경고 또는 모두 중 하나를 선택합니다.
    • 보안 경고를 클릭하고 없음, 위험, 높음 이상, 중간 이상 또는 모두 중 하나를 선택합니다.

    "규칙 집합" 설정의 "필수 도구 및 경고 임계값" 섹션 스크린샷

경고 심각도 및 보안 심각도 수준에 대한 자세한 내용은 코드 검사 경고 정보을(를) 참조하세요.

조직 내 리포지토리 규칙을 관리하는 방법에 대해 알아보려면 조직의 리포지토리에 대한 규칙 집합 관리을 참조하시기 바랍니다.

REST API를 활용해 병합 보호 규칙 집합을 생성하세요

REST API를 활용하면 code_scanning 규칙들을 조합하여 규칙 집합을 구성할 수 있으며, 이를 통해 특정 도구를 정의하고 경고 임계값을 설정하는 것이 가능합니다. 자세한 내용은 규칙에 대한 REST API 엔드포인트을(를) 참조하세요.