You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[](https://stepsecurity.io/?utm_source=github&utm_medium=organic_oss&utm_campaign=harden-runner)
@@ -18,19 +22,19 @@ Harden-Runner GitHub Action installs a security agent on the GitHub-hosted runne
18
22
19
23
Compromised dependencies and build tools typically make outbound calls to exfiltrate data or credentials, or may modify source code, dependencies, or artifacts during the build.
20
24
21
-
Harden-Runner GitHub Actions installs a daemon that monitors process, file, and network activity.
25
+
Harden-Runner GitHub Actions installs a daemon that monitors process, file, and network activity.
22
26
23
27
1. Blocks outbound calls that are not in the allowed list to prevent exfiltration of credentials (to prevent [Codecov breach](https://github.com/step-security/supply-chain-goat/blob/main/RestrictOutboundTraffic.md) scenario)
24
28
25
29
2. Detects if source code is being overwritten during the build process to inject a backdoor (to detect [SolarWinds incident scenario](https://github.com/step-security/supply-chain-goat/blob/main/MonitorSourceCode.md))
26
30
27
31
3. Detects compromised dependencies that make unexpected outbound network calls (to detect [Dependency confusion](https://github.com/step-security/supply-chain-goat/blob/main/DNSExfiltration.md) and [Malicious dependencies](https://github.com/step-security/supply-chain-goat/blob/main/CompromisedDependency.md))
28
32
29
-
Read this [case study](https://infosecwriteups.com/detecting-malware-packages-in-github-actions-7b93a9985635) on how Harden-Runner detected malicious packages in the NPM registry.
33
+
Read this [case study](https://infosecwriteups.com/detecting-malware-packages-in-github-actions-7b93a9985635) on how Harden-Runner detected malicious packages in the NPM registry.
30
34
31
35
## How
32
36
33
-
1. Add `step-security/harden-runner` to your GitHub Actions workflow file as the first step in each job.
37
+
1. Add `step-security/harden-runner` to your GitHub Actions workflow file as the first step in each job.
34
38
35
39
```yaml
36
40
steps:
@@ -45,7 +49,7 @@ Read this [case study](https://infosecwriteups.com/detecting-malware-packages-in
45
49
<img src="https://github.com/step-security/supply-chain-goat/blob/main/images/harden-runner/ActionLog.png" alt="Link in build log" >
46
50
</p>
47
51
48
-
3. Click on the link ([example link](https://app.stepsecurity.io/github/ossf/scorecard/actions/runs/2265028928)). You will see a process monitor view of what activities happened as part of each step.
52
+
3. Click on the link ([example link](https://app.stepsecurity.io/github/ossf/scorecard/actions/runs/2265028928)). You will see a process monitor view of what activities happened as part of each step.
49
53
50
54
<p align="left">
51
55
<img src="https://github.com/step-security/supply-chain-goat/blob/main/images/harden-runner/OutboundCalls2.png" alt="Insights from harden-runner" >
@@ -67,14 +71,12 @@ Read this [case study](https://infosecwriteups.com/detecting-malware-packages-in
67
71
68
72
Install the [Harden Runner App](https://github.com/marketplace/harden-runner-app) to use Harden-Runner GitHub Action for `Private` repositories.
69
73
70
-
- If you use Harden-Runner GitHub Action in a private repository, the generated insights URL is NOT public.
74
+
- If you use Harden-Runner GitHub Action in a private repository, the generated insights URL is NOT public.
71
75
- You need to authenticate first to access insights URL for private repository. Only those who have access to the repository can view it.
72
-
- [Harden Runner App](https://github.com/marketplace/harden-runner-app) only needs `actions: read` permissions on your repositories.
76
+
- [Harden Runner App](https://github.com/marketplace/harden-runner-app) only needs `actions: read` permissions on your repositories.
73
77
74
78
Read this [case study on how Kapiche uses Harden Runner](https://www.stepsecurity.io/case-studies/kapiche/) to improve software supply chain security in their open source and private repositories.
75
79
76
-
77
-
78
80
## Discussions
79
81
80
82
If you have questions or ideas, please use [discussions](https://github.com/step-security/harden-runner/discussions).
@@ -110,10 +112,11 @@ Some important workflows using harden-runner:
110
112
111
113
## How does it work?
112
114
113
-
Harden-Runner GitHub Action downloads and installs the StepSecurity Agent.
114
-
- The code to monitor file, process, and network activity is in the Agent.
115
+
Harden-Runner GitHub Action downloads and installs the StepSecurity Agent.
116
+
117
+
- The code to monitor file, process, and network activity is in the Agent.
115
118
- The agent is written in Go and is open source at https://github.com/step-security/agent
116
-
- The agent's build is reproducible. You can view the steps to reproduce the build [here](http://app.stepsecurity.io/github/step-security/agent/releases/latest).
119
+
- The agent's build is reproducible. You can view the steps to reproduce the build [here](http://app.stepsecurity.io/github/step-security/agent/releases/latest).
0 commit comments