step-security/harden-runner

어떤 프로젝트인가요?

핵심 기능

• 01각 외부 네트워크 연결, 파일 쓰기, 프로세스 실행을 해당 워크플로 스텝에 연결합니다.
• 02작업별 외부 연결 기준선을 만들고 새로운 대상이 나타나면 경고합니다.
• 03차단 모드에서 도메인 허용 목록으로 송신 트래픽을 제한합니다.
• 04현재 진행 중인 공급망 공격과 관련된 도메인 및 IP의 전역 차단 목록을 적용합니다.
• 05Linux, Windows, macOS GitHub 호스팅 러너를 지원하며, 차단 모드는 Linux에서만 사용할 수 있습니다.
• 06Enterprise 티어에서 ARC를 포함한 셀프 호스팅 러너를 지원합니다.

활용 사례

• 빌드 중 시크릿을 유출하는 침해된 서드파티 GitHub Actions를 탐지합니다.
• 송신 규칙을 강화하기 전에 CI 파이프라인이 접속하는 외부 호스트를 감사합니다.
• 사용자에게 아티팩트를 배포하는 오픈소스 프로젝트의 빌드 파이프라인을 모니터링합니다.
• GITHUB_TOKEN 권한을 워크플로에 필요한 최소 수준으로 줄입니다.

빠른 시작

1. 1

   GitHub Actions 워크플로 파일의 각 작업에서 첫 번째 단계로 Harden-Runner를 추가하세요

2. 2

   워크플로를 실행한 다음 작업 로그의 링크를 열어 네트워크 및 파일 이벤트를 확인하세요

사용 전 알아둘 점

• !무료 Community 등급은 GitHub 호스팅 러너의 공개 저장소만 지원합니다.
• !비공개 저장소와 자체 호스팅 러너를 사용하려면 유료 Enterprise 구독이 필요합니다.
• !GitHub Actions 워크플로 내에서만 작동하며, 다른 CI/CD 시스템에서는 사용할 수 없습니다.

포함된 컬렉션

토픽

자주 묻는 질문

harden-runner은(는) 무엇인가요?

GitHub Actions 러너의 네트워크 송신, 파일 쓰기, 프로세스 활동을 모니터링해 공급망 공격을 탐지하는 CI/CD 보안 에이전트입니다. Harden-Runner는 CI/CD 작업 안에서 실행되며 GitHub Actions 러너의 엔드포인트 탐지 도구처럼 동작하는 보안 에이전트입니다. 외부로 나가는 네트워크 연결, 파일 쓰기, 프로세스 실행을 기록하고 각 이벤트가 발생한 구체적인 스텝, 작업, 워크플로와 연결합니다. 이는 임시 빌드 러너가 다른 중요 시스템에 적용되는 모니터링 없이 시크릿을 다루고 프로덕션 아티팩트를 생성하는 경우가 많다는 보안 공백을 해소합니다.

harden-runner은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

harden-runner은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

harden-runner은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. harden-runner의 마지막 커밋은 2026년 10월 19일입니다.

harden-runner은(는) 어디에 사용할 수 있나요?

빌드 중 시크릿을 유출하는 침해된 서드파티 GitHub Actions를 탐지합니다. 송신 규칙을 강화하기 전에 CI 파이프라인이 접속하는 외부 호스트를 감사합니다. 사용자에게 아티팩트를 배포하는 오픈소스 프로젝트의 빌드 파이프라인을 모니터링합니다. GITHUB_TOKEN 권한을 워크플로에 필요한 최소 수준으로 줄입니다.

harden-runner는 어떻게 설치하나요?

GitHub Actions 워크플로 파일의 각 작업에서 첫 번째 단계로 Harden-Runner를 추가하세요 워크플로를 실행한 다음 작업 로그의 링크를 열어 네트워크 및 파일 이벤트를 확인하세요

harden-runner은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/step-security/harden-runner