Files
skills/public/cicd-ci-security.html
zeekayandHanzo Dev 9e10c1c10e Each llms index points at the other two
hanzoskills.com/llms.txt now opens with the install line, the API
reference index and the company index, so an agent that lands on any
one of the three can find the rest.

robots.txt claimed 537 documents while llms.txt counts 920. The number
is gone from robots.txt; llms.txt derives it.

public/ is regenerated from scripts/site.py, which it had fallen
behind: the copy-prompt menu and agent bar were in the generator and
not in the committed pages. tests/site.mjs passes against the result.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-11 00:27:59 -07:00

859 lines
31 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>cicd-ci-security</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant —
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="alternate" type="text/markdown" href="/cicd-ci-security.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/cicd-ci-security">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/cicd-ci-security.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>cicd-ci-security</h1><p class="lede">Managing secrets and credentials in CI/CD pipelines</p><h1>CI Security</h1>
<p><strong>Scope</strong>: Secret management, OIDC authentication, supply chain security, SBOM generation, vulnerability scanning, and secure pipeline patterns</p>
<p><strong>Lines</strong>: 390</p>
<p><strong>Last Updated</strong>: 2025-10-18</p>
<p><strong>Format Version</strong>: 1.0 (Atomic)</p>
<hr>
<h2>When to Use This Skill</h2>
<p>Use this skill when:</p>
<ul><li>Managing secrets and credentials in CI/CD pipelines</li><li>Implementing OIDC for passwordless authentication</li><li>Securing supply chain with dependency scanning</li><li>Generating and verifying Software Bill of Materials (SBOM)</li><li>Implementing container image scanning</li><li>Setting up security gates in pipelines</li><li>Auditing and logging security events</li><li>Implementing least-privilege access patterns</li></ul>
<p>Don&#x27;t use this skill for:</p>
<ul><li>General workflow configuration (see <code>github-actions-workflows.md</code>)</li><li>Testing strategies (see <code>ci-testing-strategy.md</code>)</li><li>Deployment patterns (see <code>cd-deployment-patterns.md</code>)</li></ul>
<hr>
<h2>Core Concepts</h2>
<h3>Security Layers in CI/CD</h3>
<pre><code>1. Source Control Security
↓
2. Pipeline Security (secrets, permissions)
↓
3. Build Security (SBOM, signing)
↓
4. Dependency Security (scanning, verification)
↓
5. Runtime Security (container scanning)
↓
6. Deployment Security (OIDC, least privilege)</code></pre>
<h3>Threat Model</h3>
<pre><code>Threat | Mitigation
────────────────────────────────|─────────────────────────────
Leaked secrets | OIDC, secret scanning
Compromised dependencies | Dependency review, SBOM
Malicious code injection | Branch protection, reviews
Supply chain attacks | Provenance, signing
Container vulnerabilities | Image scanning
Privilege escalation | Least privilege, RBAC</code></pre>
<hr>
<h2>Patterns</h2>
<h3>Secret Management with GitHub Secrets</h3>
<pre><code class="lang-yaml">name: Secure Secrets
on: [push]
jobs:
deploy:
runs-on: ubuntu-latest
environment: production
steps:
- uses: actions/checkout@v4
# Access secrets from environment
- name: Deploy with secrets
run: ./deploy.sh
env:
API_KEY: ${{ secrets.API_KEY }}
DATABASE_URL: ${{ secrets.DATABASE_URL }}
# Never log secrets
- name: Safe logging
run: |
echo &quot;Deploying to production&quot;
# DON&#x27;T: echo &quot;API Key: $API_KEY&quot;
# Mask custom values
- name: Mask sensitive values
run: |
echo &quot;::add-mask::$SENSITIVE_VALUE&quot;
echo &quot;Value: $SENSITIVE_VALUE&quot; # Will be masked in logs</code></pre>
<h3>OIDC Authentication (No Long-Lived Secrets)</h3>
<pre><code class="lang-yaml">name: OIDC Deploy
on: [push]
permissions:
id-token: write # Required for OIDC
contents: read
jobs:
deploy-aws:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
# AWS via OIDC
- name: Configure AWS credentials
uses: aws-actions/configure-aws-credentials@v4
with:
role-to-assume: arn:aws:iam::123456789012:role/GitHubActionsRole
aws-region: us-east-1
- name: Deploy to AWS
run: |
aws s3 sync dist/ s3://my-bucket/
deploy-gcp:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
# GCP via OIDC
- name: Authenticate to Google Cloud
uses: google-github-actions/auth@v2
with:
workload_identity_provider: &#x27;projects/123/locations/global/workloadIdentityPools/pool/providers/provider&#x27;
service_account: &#x27;[email protected]&#x27;
- name: Deploy to GCP
run: gcloud app deploy
deploy-azure:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
# Azure via OIDC
- name: Azure Login
uses: azure/login@v2
with:
client-id: ${{ secrets.AZURE_CLIENT_ID }}
tenant-id: ${{ secrets.AZURE_TENANT_ID }}
subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}
- name: Deploy to Azure
run: az webapp deploy --name myapp --resource-group rg</code></pre>
<h3>Dependency Scanning and Review</h3>
<pre><code class="lang-yaml">name: Dependency Security
on:
pull_request:
schedule:
- cron: &#x27;0 0 * * *&#x27; # Daily
jobs:
dependency-review:
runs-on: ubuntu-latest
if: github.event_name == &#x27;pull_request&#x27;
steps:
- uses: actions/checkout@v4
# GitHub native dependency review
- name: Dependency Review
uses: actions/dependency-review-action@v4
with:
fail-on-severity: moderate
deny-licenses: GPL-3.0, AGPL-3.0
vulnerability-scan:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
# npm audit
- name: npm audit
run: |
npm audit --audit-level=moderate
npm audit --json &gt; audit-results.json
# Snyk scanning
- name: Run Snyk
uses: snyk/actions/node@master
env:
SNYK_TOKEN: ${{ secrets.SNYK_TOKEN }}
with:
args: --severity-threshold=high
# OWASP Dependency Check
- name: OWASP Dependency Check
uses: dependency-check/Dependency-Check_Action@main
with:
project: &#x27;myapp&#x27;
path: &#x27;.&#x27;
format: &#x27;HTML&#x27;
args: &gt;
--failOnCVSS 7
--enableRetired
- uses: actions/upload-artifact@v4
if: failure()
with:
name: dependency-check-report
path: reports/
license-check:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
# License compliance
- name: Check licenses
run: |
npx license-checker \
--production \
--onlyAllow=&quot;MIT;Apache-2.0;BSD-2-Clause;BSD-3-Clause;ISC&quot; \
--excludePackages &quot;[email protected]&quot;</code></pre>
<h3>SBOM Generation and Verification</h3>
<pre><code class="lang-yaml">name: SBOM and Provenance
on:
push:
branches: [main]
release:
types: [published]
jobs:
sbom:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
# Generate SBOM with Syft
- name: Generate SBOM
uses: anchore/sbom-action@v0
with:
format: spdx-json
output-file: sbom.spdx.json
# Generate CycloneDX SBOM
- name: Generate CycloneDX SBOM
run: |
npm install -g @cyclonedx/cyclonedx-npm
cyclonedx-npm --output-file sbom.cdx.json
# Upload SBOM as artifact
- uses: actions/upload-artifact@v4
with:
name: sbom
path: |
sbom.spdx.json
sbom.cdx.json
# Attach SBOM to release
- name: Upload to release
if: github.event_name == &#x27;release&#x27;
uses: softprops/action-gh-release@v1
with:
files: |
sbom.spdx.json
sbom.cdx.json
provenance:
runs-on: ubuntu-latest
permissions:
actions: read
id-token: write
contents: write
steps:
- uses: actions/checkout@v4
# Build artifacts
- run: npm ci &amp;&amp; npm run build
# Generate SLSA provenance
- name: Generate provenance
uses: slsa-framework/slsa-github-generator/.github/workflows/[email protected]
with:
base64-subjects: &quot;${{ needs.build.outputs.digests }}&quot;
# Sign with Sigstore
- name: Sign artifacts
uses: sigstore/[email protected]
with:
inputs: ./dist/*
upload-signing-artifacts: true</code></pre>
<h3>Container Image Scanning</h3>
<pre><code class="lang-yaml">name: Container Security
on: [push]
jobs:
scan:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
# Build image
- name: Build Docker image
run: docker build -t myapp:${{ github.sha }} .
# Trivy vulnerability scanning
- name: Run Trivy scanner
uses: aquasecurity/trivy-action@master
with:
image-ref: myapp:${{ github.sha }}
format: &#x27;sarif&#x27;
output: &#x27;trivy-results.sarif&#x27;
severity: &#x27;CRITICAL,HIGH&#x27;
exit-code: &#x27;1&#x27;
# Upload to GitHub Security
- name: Upload Trivy results
uses: github/codeql-action/upload-sarif@v3
if: always()
with:
sarif_file: &#x27;trivy-results.sarif&#x27;
# Grype scanning
- name: Scan with Grype
uses: anchore/scan-action@v3
with:
image: myapp:${{ github.sha }}
fail-build: true
severity-cutoff: high
# Snyk container scanning
- name: Snyk Container scan
uses: snyk/actions/docker@master
env:
SNYK_TOKEN: ${{ secrets.SNYK_TOKEN }}
with:
image: myapp:${{ github.sha }}
args: --severity-threshold=high
# Docker Scout (Docker Hub)
- name: Docker Scout
uses: docker/scout-action@v1
with:
command: cves
image: myapp:${{ github.sha }}
exit-code: true
only-severities: critical,high</code></pre>
<h3>Code Scanning (SAST)</h3>
<pre><code class="lang-yaml">name: Code Security Scanning
on:
push:
branches: [main]
pull_request:
schedule:
- cron: &#x27;0 0 * * 0&#x27; # Weekly
jobs:
codeql:
runs-on: ubuntu-latest
permissions:
security-events: write
contents: read
strategy:
matrix:
language: [javascript, python]
steps:
- uses: actions/checkout@v4
# Initialize CodeQL
- name: Initialize CodeQL
uses: github/codeql-action/init@v3
with:
languages: ${{ matrix.language }}
queries: security-extended
# Autobuild
- name: Autobuild
uses: github/codeql-action/autobuild@v3
# Run analysis
- name: Perform CodeQL Analysis
uses: github/codeql-action/analyze@v3
semgrep:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
# Semgrep SAST
- name: Run Semgrep
uses: returntocorp/semgrep-action@v1
with:
config: &gt;-
p/security-audit
p/secrets
p/owasp-top-ten
sonarcloud:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0 # Full history for accurate analysis
# SonarCloud scan
- name: SonarCloud Scan
uses: SonarSource/sonarcloud-github-action@master
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
with:
args: &gt;
-Dsonar.projectKey=myproject
-Dsonar.organization=myorg</code></pre>
<h3>Secret Scanning</h3>
<pre><code class="lang-yaml">name: Secret Detection
on: [push, pull_request]
jobs:
scan-secrets:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
# Gitleaks
- name: Gitleaks scan
uses: gitleaks/gitleaks-action@v2
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
# TruffleHog
- name: TruffleHog scan
uses: trufflesecurity/trufflehog@main
with:
path: ./
base: ${{ github.event.repository.default_branch }}
head: HEAD
# detect-secrets
- name: detect-secrets scan
run: |
pip install detect-secrets
detect-secrets scan --baseline .secrets.baseline
detect-secrets audit .secrets.baseline</code></pre>
<h3>Least Privilege Permissions</h3>
<pre><code class="lang-yaml">name: Minimal Permissions
on: [push]
# Default: read-only
permissions:
contents: read
jobs:
build:
runs-on: ubuntu-latest
# Explicit minimal permissions
permissions:
contents: read
packages: write # Only for publishing
steps:
- uses: actions/checkout@v4
- run: npm ci &amp;&amp; npm run build
deploy:
needs: build
runs-on: ubuntu-latest
environment: production
# OIDC requires id-token
permissions:
id-token: write
contents: read
steps:
- uses: aws-actions/configure-aws-credentials@v4
with:
role-to-assume: ${{ secrets.AWS_ROLE }}
aws-region: us-east-1
- run: ./deploy.sh</code></pre>
<h3>Security Gates</h3>
<pre><code class="lang-yaml">name: Security Gates
on:
pull_request:
push:
branches: [main]
jobs:
security-gate:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
# Gate 1: No secrets
- name: Secret scan
uses: gitleaks/gitleaks-action@v2
# Gate 2: No critical vulnerabilities
- name: Dependency scan
run: |
npm audit --audit-level=critical
# Gate 3: No license violations
- name: License check
run: |
npx license-checker --onlyAllow &quot;MIT;Apache-2.0;BSD-3-Clause&quot;
# Gate 4: Code quality
- name: SonarCloud gate
uses: SonarSource/sonarcloud-github-action@master
env:
SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
# Gate 5: Container security
- name: Container scan
if: success()
run: |
docker build -t myapp:test .
trivy image --exit-code 1 --severity CRITICAL myapp:test
# All gates passed
- name: Security approval
if: success()
run: |
echo &quot;All security gates passed&quot;
echo &quot;SECURITY_APPROVED=true&quot; &gt;&gt; $GITHUB_ENV</code></pre>
<h3>Audit Logging</h3>
<pre><code class="lang-yaml">name: Security Audit
on:
push:
pull_request:
workflow_dispatch:
jobs:
audit:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
# Log security-relevant events
- name: Audit log
run: |
cat &lt;&lt;EOF &gt; audit.json
{
&quot;timestamp&quot;: &quot;$(date -u +%Y-%m-%dT%H:%M:%SZ)&quot;,
&quot;event&quot;: &quot;${{ github.event_name }}&quot;,
&quot;actor&quot;: &quot;${{ github.actor }}&quot;,
&quot;repository&quot;: &quot;${{ github.repository }}&quot;,
&quot;ref&quot;: &quot;${{ github.ref }}&quot;,
&quot;sha&quot;: &quot;${{ github.sha }}&quot;,
&quot;workflow&quot;: &quot;${{ github.workflow }}&quot;
}
EOF
# Send to SIEM
- name: Send to logging service
run: |
curl -X POST https://logs.example.com/api/events \
-H &quot;Authorization: Bearer ${{ secrets.LOG_TOKEN }}&quot; \
-H &quot;Content-Type: application/json&quot; \
-d @audit.json
# Store audit trail
- uses: actions/upload-artifact@v4
with:
name: audit-log-${{ github.run_id }}
path: audit.json
retention-days: 90</code></pre>
<hr>
<h2>Quick Reference</h2>
<h3>OIDC Setup (AWS)</h3>
<pre><code class="lang-bash"># 1. Create OIDC provider in AWS
aws iam create-open-id-connect-provider \
--url https://token.actions.githubusercontent.com \
--client-id-list sts.amazonaws.com
# 2. Create IAM role with trust policy
{
&quot;Version&quot;: &quot;2012-10-17&quot;,
&quot;Statement&quot;: [{
&quot;Effect&quot;: &quot;Allow&quot;,
&quot;Principal&quot;: {
&quot;Federated&quot;: &quot;arn:aws:iam::ACCOUNT:oidc-provider/token.actions.githubusercontent.com&quot;
},
&quot;Action&quot;: &quot;sts:AssumeRoleWithWebIdentity&quot;,
&quot;Condition&quot;: {
&quot;StringEquals&quot;: {
&quot;token.actions.githubusercontent.com:aud&quot;: &quot;sts.amazonaws.com&quot;,
&quot;token.actions.githubusercontent.com:sub&quot;: &quot;repo:owner/repo:ref:refs/heads/main&quot;
}
}
}]
}</code></pre>
<h3>Security Scanning Tools</h3>
<pre><code class="lang-yaml">Secrets: gitleaks, trufflehog, detect-secrets
Dependencies: npm audit, snyk, dependabot
Containers: trivy, grype, snyk container
Code (SAST): codeql, semgrep, sonarcloud
License: license-checker, fossa
SBOM: syft, cyclonedx</code></pre>
<h3>Severity Thresholds</h3>
<pre><code class="lang-yaml">Development: Allow MEDIUM and below
Staging: Allow LOW and below
Production: Block HIGH and CRITICAL</code></pre>
<hr>
<h2>Anti-Patterns</h2>
<h3>❌ Logging Secrets</h3>
<pre><code class="lang-yaml"># WRONG: Secrets in logs
- run: echo &quot;API Key: ${{ secrets.API_KEY }}&quot;</code></pre>
<pre><code class="lang-yaml"># CORRECT: Never log secrets
- run: echo &quot;Deploying with credentials&quot;
env:
API_KEY: ${{ secrets.API_KEY }}</code></pre>
<h3>❌ Using Long-Lived Credentials</h3>
<pre><code class="lang-yaml"># WRONG: Static credentials
- env:
AWS_ACCESS_KEY_ID: ${{ secrets.AWS_KEY }}
AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET }}</code></pre>
<pre><code class="lang-yaml"># CORRECT: OIDC
- uses: aws-actions/configure-aws-credentials@v4
with:
role-to-assume: ${{ secrets.AWS_ROLE }}</code></pre>
<h3>❌ Overly Permissive Access</h3>
<pre><code class="lang-yaml"># WRONG: Write access to everything
permissions: write-all</code></pre>
<pre><code class="lang-yaml"># CORRECT: Minimal permissions
permissions:
contents: read
id-token: write</code></pre>
<h3>❌ No Vulnerability Scanning</h3>
<pre><code class="lang-yaml"># WRONG: Deploy without scanning
- run: docker push myapp:latest</code></pre>
<pre><code class="lang-yaml"># CORRECT: Scan before push
- run: trivy image --exit-code 1 myapp:latest
- run: docker push myapp:latest</code></pre>
<h3>❌ Ignoring Security Alerts</h3>
<pre><code class="lang-yaml"># WRONG: Bypass security
- run: npm audit || true</code></pre>
<pre><code class="lang-yaml"># CORRECT: Fail on vulnerabilities
- run: npm audit --audit-level=moderate</code></pre>
<hr>
<h2>Related Skills</h2>
<ul><li><code>github-actions-workflows.md</code> - Workflow configuration basics</li><li><code>ci-testing-strategy.md</code> - Security testing integration</li><li><code>cd-deployment-patterns.md</code> - Secure deployment practices</li><li><code>ci-optimization.md</code> - Optimizing security scans</li></ul>
<hr>
<p><strong>Last Updated</strong>: 2025-10-18</p>
<p><strong>Format Version</strong>: 1.0 (Atomic)</p>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/cicd-ci-security.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>