작성 시점 2026-11-10 기준출처 대조 B · 출처 5곳읽기 5분

GitHub Actions 로그 secret scanning 퍼블릭 프리뷰: 켜는 법과 한계

GitHub secret scanning이 Actions 워크플로 로그에서도 시크릿을 찾는다. Enterprise Cloud 퍼블릭 프리뷰이고 기본은 꺼짐이며 알림이 가지 않는다. 켜는 법과 한계를 정리했다.

한눈에 보기

  • Actions 로그의 시크릿 탐지는 GitHub Enterprise Cloud의 퍼블릭 프리뷰이고, 기본으로 꺼져 있으며 프리뷰 동안 알림도 가지 않는다.
  • 대상 조직은 정책을 켜고 알림 목록을 직접 확인하고, 그 밖의 저장소는 로그에 시크릿이 찍히지 않게 스스로 막는다.
  • 2026년 11월 9일 GitHub 변경 기록에 올라왔다. 기존에 스캔하던 이슈·위키·디스커션·풀 리퀘스트에 워크플로 로그가 더해졌다.
  • 켠 뒤에 끝난 워크플로 실행만 검사한다. 과거 로그는 소급하지 않는다.
  • 제공업체 패턴만 찾는다. 일반 패턴, 커스텀 패턴, AI로 탐지한 시크릿은 대상이 아니다.

무슨 일이 있었나

CI 로그에 토큰이 그대로 찍힌 것을 나중에야 발견한 적이 있다면 이번 변경이 반가울 것이다. 시크릿이 코드가 아니라 echo나 디버그 출력, 도구의 상세 로그에 섞여 나오는 경우는 저장소 코드만 검사해서는 놓친다.

2026년 11월 9일 GitHub는 secret scanning이 GitHub Actions 워크플로 로그에서도 시크릿을 탐지한다고 발표했다. 이슈, 위키, 디스커션, 풀 리퀘스트에 이어 스캔 위치가 하나 늘었다. 기능은 퍼블릭 프리뷰다.

동작은 이렇다.

  • 워크플로 실행이 끝나면 GitHub가 로그에서 제공업체별 패턴을 찾는다.
  • 결과는 저장소의 secret scanning 알림 목록에 다른 알림과 함께 나오고, 해당 Actions 로그로 가는 링크가 붙는다.
  • 지원하는 시크릿 유형은 유효성 검사를 한다.
  • 로그를 지워도 알림은 남는다.

같은 시크릿이 여러 실행이나 작업(job)에 나오면 알림 하나에 위치가 여러 개 담길 수 있다. 각 위치는 시크릿이 시작된 워크플로 파일과 출력된 로그 줄로 연결되고, 알림에는 로그 내용의 인라인 미리보기가 없다.

왜 중요한가

로그는 코드 리뷰를 거치지 않는다. 시크릿이 코드에 들어가면 푸시 전후로 눈에 띄지만, 로그에 찍힌 값은 실행이 끝난 뒤에야 누군가 열어 봐야 보인다. 이 변경은 그 틈을 GitHub가 대신 훑어 준다는 뜻이다.

다만 기본값과 제한 때문에 켜 놓기만 해서는 안전해지지 않는다.

  • 정책이 기본으로 꺼져 있다.
  • 프리뷰 기간에는 알림이 발송되지 않아 알림 목록을 직접 열어야 한다.
  • 제공업체 패턴만 찾는다. 일반 패턴, 커스텀 패턴, AI로 탐지한 시크릿은 찾지 않는다.
  • Actions가 이미 마스킹한 값은 탐지 대상이 아니다.

누구에게 어떤 영향이 있나

대상은 GitHub Enterprise Cloud에서 GitHub Secret Protection 또는 GitHub Advanced Security를 쓰는 엔터프라이즈다. GHE.com 데이터 상주 환경도 포함한다. 해당 라이선스로 secret scanning을 켠 저장소에만 적용된다.

공식 문서의 일반 secret scanning 안내는 다음과 같다. 공개 저장소는 무료로 자동 실행된다. 조직 소유 비공개·내부 저장소는 GitHub Team 또는 GitHub Enterprise Cloud에서 GitHub Secret Protection을 켜야 한다. 다만 이번 Actions 로그 스캔의 대상 플랜은 변경 기록이 말한 Enterprise Cloud 쪽이다.

상황해야 할 일
엔터프라이즈 소유자정책을 켜고 이후 알림 목록을 정기적으로 확인한다
저장소 관리자알림 목록에 항목이 생기면 해당 로그 위치를 보고 자격 증명을 교체한다
대상이 아닌 저장소로그에 시크릿이 출력되지 않게 워크플로를 점검한다

직접 해보기

엔터프라이즈 소유자라면 다음 순서로 켠다. 이 정책은 기본으로 꺼져 있다.

  1. 엔터프라이즈 설정을 연다.
  2. Policies에서 Advanced Security를 선택한다.
  3. 「Secret scanning for Actions workflow logs」 정책을 찾는다.
  4. All repositories 드롭다운에서 Enabled를 선택한다.

켠 뒤에는 다음을 챙긴다.

  • 켠 뒤에 완료된 실행부터 검사하므로, 이미 쌓인 로그는 따로 확인한다. 소급 스캔은 없다.
  • 프리뷰 중에는 알림이 안 가니 저장소의 secret scanning 알림 목록을 주기적으로 연다.
  • 알림 목록에서 항목을 발견하면 해당 자격 증명을 즉시 교체한다. 공식 문서는 「When you receive an alert, rotate the affected credential immediately to prevent unauthorized access.」라고 안내한다. 로그를 지워도 알림은 남으므로 로그 삭제를 대응으로 여기지 않는다.
  • 일반 패턴이나 커스텀 패턴 형식의 값은 이 기능이 찾지 않으니, 그런 값이 로그에 나오지 않는지 워크플로를 따로 점검한다.

대상이 아닌 저장소라면

GitHub Actions 공식 문서에서 확인되는 방법이다.

  • GitHub 시크릿이 아닌 민감한 값, 예를 들어 실행 중에 만든 값은 출력하기 전에 echo "::add-mask::$MY_NAME"처럼 등록해 로그에서 가린다. 값마다 job당 한 번 해야 한다.
  • 워크플로가 실행되는 동안 시크릿이 출력되지 않게 주의하고, 시크릿을 echo 같은 출력문으로 찍지 않는다.

검증 범위: 이 글은 실행으로 확인한 내용이 없고, 위 출처의 변경 기록과 공식 문서를 대조해 썼다. 기능은 퍼블릭 프리뷰라서 동작과 대상이 바뀔 수 있다.

출처

이 글은 2026-11-10 기준으로 작성했습니다. 이후 달라진 내용은 2027-05-10에 확인해 이 자리에 추가합니다.