Skip to main content

코드 스캔을 위한 고급 설정 구성

리포지토리가 코드에서 보안 취약성을 찾도록 고도로 사용자 지정할 수 있는 code scanning 구성을 사용하여고급 설정을(를) 구성할 수 있습니다.

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

People with admin permissions to a repository, or the security manager role for the repository, can configure code scanning for that repository. People with write permissions to a repository can also configure code scanning, but only by creating a workflow file or manually uploading a SARIF file.

Code scanning는 GitHub.com의 모든 퍼블릭 리포지토리에 사용할 수 있습니다. 조직이 소유한 프라이빗 리포지토리에서 code scanning을 사용하려면 GitHub Advanced Security에 대한 라이선스가 있어야 합니다. 자세한 내용은 "GitHub Advanced Security 정보.

code scanning에 대한 고급 설정 정보

code scanning에 대한 고급 설정은 code scanning 구성을 더욱 세분화하여 제어해야 하는 경우에 유용합니다. CodeQL 워크플로 파일을 만들고 편집하면 스캔 일정을 변경하고, 모든 CodeQL지원 언어를 검색하며, 행렬 빌드를 사용하는 등의 작업을 수행할 수 있습니다.

또한 제3자 도구를 사용하여 code scanning을(를) 구성할 수도 있습니다. 자세한 내용은 "제3자의 작업을 사용하여 code scanning 구성"을 참조하세요.

여러 구성을 사용하여 코드 검색을 실행하는 경우 동일한 경고가 두 개 이상의 구성에 의해 생성되는 경우가 있습니다. 경고가 여러 구성에서 제공되는 경우 경고 페이지에서 각 구성에 대한 경고의 상태를 볼 수 있습니다. 자세한 내용은 "코드 검사 경고 정보"을 참조하세요.

고도로 사용자 지정할 수 있는 code scanning 구성이 필요하지 않은 경우 code scanning에 대한 기본 설정을 사용하는 것이 좋습니다. 기본 설정 자격에 대한 자세한 정보는 "코드 스캔을 위한 기본 설정 구성"을(를) 참조하세요.

필수 조건

다음의 경우 고급 설정에 적합한 리포지토리입니다.

  • CodeQL지원되는 언어를 사용하거나 제3자 도구를 사용하여 코드 스캔 결과를 생성할 계획입니다.
  • GitHub Actions이(가) 사용됩니다.
  • 공개적으로 표시되거나 GitHub Advanced Security이(가) 사용됩니다.

리포지토리에 대한 고급 설정 구성

code scanning에 대한 고급 설정은 code scanning을(를) 사용자 지정해야 하는 경우에 유용합니다. 워크플로 파일을 만들고 편집하여 실행할 쿼리를 선택하고, 스캔 일정을 변경하며, 스캔할 언어를 선택하고, 행렬 빌드를 사용하는 등의 작업을 수행할 수 있습니다.

CodeQL을(를) 사용하여 code scanning에 대한 고급 설정 구성

워크플로 파일을 만들고 편집하여 code scanning을(를) 사용자 지정할 수 있습니다. 고급 설정을 선택하면 사용자 지정할 수 있는 기본 워크플로 파일이 생성됩니다.

작업을 사용하여 code scanning를 실행하는 데는 몇 분 정도 걸립니다. 자세한 내용은 "GitHub Actions 요금 청구 정보"을 참조하세요.

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

  2. 리포지토리 이름 아래에서 Settings(설정)를 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다. 탭을 보여 주는 리포지토리 헤더의 스크린샷. "설정" 탭이 진한 주황색 윤곽선으로 강조 표시됩니다.

  3. 사이드바의 "보안" 섹션에서 코드 보안 및 분석을 클릭합니다.

  4. "Code scanning" 섹션까지 아래로 스크롤하여 설정을 선택한 다음, 고급을 클릭합니다.

    참고: "Code scanning" 섹션에서 기본 설정에서 고급 설정으로 전환하는 경우 을(를) 선택한 다음 고급으로 전환을 클릭합니다. 표시되는 팝업 창에서 CodeQL 사용 중지를 클릭합니다.

    "코드 보안 및 분석" 설정의 "Code scanning" 섹션 스크린샷입니다. "고급 설정" 단추가 주황색 윤곽선으로 강조 표시됩니다.

  5. code scanning가 코드를 검사하는 방법을 사용자 지정하려면 워크플로를 편집합니다.

    일반적으로 변경하지 않고 CodeQL 분석 워크플로을(를) 커밋할 수 있습니다. 그러나 대부분의 타사 워크플로에는 추가 구성이 필요하므로 커밋하기 전에 워크플로의 설명을 읽어 봅니다.

    자세한 내용은 "코드 검사를 위한 고급 설정사용자 지정" 및 "컴파일된 언어에 대한 CodeQL 코드 검사하기"을(를) 참조하세요.

  6. 변경 내용 커밋... 을 클릭하여 커밋 변경 형식을 표시합니다.

    새 파일을 만드는 형식의 스크린샷. 파일 이름 오른쪽에는 "변경 내용 커밋…"이라는 녹색 단추가 진한 주황색으로 강조 표시됩니다.

  7. 커밋 메시지 필드에 커밋 메시지를 입력합니다.

  8. 기본 분기에 직접 커밋할지 아니면 새 분기를 만들고 끌어오기 요청을 시작할지 선택합니다.

  9. 새 파일 커밋을 클릭하여 워크플로 파일을 기본값 분기에 커밋하거나 새 파일 제안을 클릭하여 파일을 새 분기에 커밋합니다.

  10. 새 분기를 만든 경우 끌어오기 요청 만들기를 클릭하고 끌어오기 요청 만들기를 열어 변경 내용을 기본값 분기에 병합합니다.

제안된 CodeQL 분석 워크플로에서는 code scanning이(가) 기본 분기 또는 보호된 분기로 변경 내용을 푸시하거나 기본 분기에 대한 끌어오기 요청을 실행할 때마다 코드를 분석하도록 구성됩니다. 따라서 code scanning가 시작됩니다.

코드 검사에 대한 on:pull_requeston:push 트리거가 유용한 용도는 각기 다릅니다. 자세한 내용은 "코드 검사를 위한 고급 설정사용자 지정"을(를) 참조하세요.

대량 사용 설정 방법에 대한 자세한 정보는 "대규모 CodeQL을 사용하여 코드 스캔을 위한고급 설정구성"을(를) 참조하세요.

제3자의 작업을 사용하여 code scanning 구성

참고: Advanced Security에 대한 시작 워크플로가 리포지토리의 작업 탭에 있는 "보안" 범주에 통합되었습니다. 이 새 구성은 현재 베타 버전이며 변경될 수 있습니다.

GitHub Enterprise Cloud은(는) code scanning과 같은 보안 기능에 대한 시작 워크플로를 제공합니다. 처음부터 시작하는 대신 제안된 워크플로를 사용하여 code scanning 워크플로를 구성할 수 있습니다.

작업을 사용하여 code scanning를 실행하는 데는 몇 분 정도 걸립니다. 자세한 내용은 "GitHub Actions 요금 청구 정보"을 참조하세요.

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

  2. 리포지토리 이름 아래에서 작업을 클릭합니다.

    "github/docs" 리포지토리의 탭 스크린샷. "작업" 탭은 주황색 윤곽선으로 강조 표시됩니다.

  3. 리포지토리에 이미 하나 이상의 워크플로가 설정되고 실행되고 있는 경우 새 워크플로를 클릭하고 시작 단계로 이동합니다. 현재 리포지토리에 대해 구성된 워크플로가 없는 경우 다음 단계로 이동합니다.

    리포지토리에 대한 작업 탭의 스크린샷. "새 워크플로" 단추는 진한 주황색으로 강조 표시됩니다.

  4. "워크플로 선택" 또는 "GitHub Actions로 시작" 보기에서 "보안" 범주까지 아래로 스크롤하고 구성하려는 워크플로 아래에서 구성을 클릭합니다. 구성하려는 보안 워크플로를 찾으려면 모두 보기를 클릭해야 할 수 있습니다.

    시작 워크플로의 보안 범주 스크린샷. 구성 단추와 "모두 보기" 링크는 주황색 윤곽선으로 강조 표시됩니다.

  5. 워크플로의 지침에 따라 필요에 맞게 사용자 지정합니다. 워크플로에 대한 일반적인 지원을 받으려면 워크플로 페이지의 오른쪽 창에서 설명서를 클릭합니다.

    편집을 위해 열린 시작 워크플로 파일이 표시된 스크린샷. "설명서" 단추가 주황색 윤곽선으로 강조 표시됩니다.

    자세한 내용은 "시작 워크플로 사용" 및 "코드 검사를 위한 고급 설정사용자 지정"을(를) 참조하세요.

다음 단계

code scanning을(를) 구성하고 작업을 완료하도록 허용한 후에는 다음을 수행할 수 있습니다.