mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
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]>
859 lines
31 KiB
HTML
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'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 "Deploying to production"
|
|
# DON'T: echo "API Key: $API_KEY"
|
|
|
|
# Mask custom values
|
|
- name: Mask sensitive values
|
|
run: |
|
|
echo "::add-mask::$SENSITIVE_VALUE"
|
|
echo "Value: $SENSITIVE_VALUE" # 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: 'projects/123/locations/global/workloadIdentityPools/pool/providers/provider'
|
|
service_account: '[email protected]'
|
|
|
|
- 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: '0 0 * * *' # Daily
|
|
|
|
jobs:
|
|
dependency-review:
|
|
runs-on: ubuntu-latest
|
|
if: github.event_name == 'pull_request'
|
|
|
|
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 > 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: 'myapp'
|
|
path: '.'
|
|
format: 'HTML'
|
|
args: >
|
|
--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="MIT;Apache-2.0;BSD-2-Clause;BSD-3-Clause;ISC" \
|
|
--excludePackages "[email protected]"</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 == 'release'
|
|
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 && npm run build
|
|
|
|
# Generate SLSA provenance
|
|
- name: Generate provenance
|
|
uses: slsa-framework/slsa-github-generator/.github/workflows/[email protected]
|
|
with:
|
|
base64-subjects: "${{ needs.build.outputs.digests }}"
|
|
|
|
# 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: 'sarif'
|
|
output: 'trivy-results.sarif'
|
|
severity: 'CRITICAL,HIGH'
|
|
exit-code: '1'
|
|
|
|
# Upload to GitHub Security
|
|
- name: Upload Trivy results
|
|
uses: github/codeql-action/upload-sarif@v3
|
|
if: always()
|
|
with:
|
|
sarif_file: 'trivy-results.sarif'
|
|
|
|
# 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: '0 0 * * 0' # 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: >-
|
|
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: >
|
|
-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 && 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 "MIT;Apache-2.0;BSD-3-Clause"
|
|
|
|
# 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 "All security gates passed"
|
|
echo "SECURITY_APPROVED=true" >> $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 <<EOF > audit.json
|
|
{
|
|
"timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
|
|
"event": "${{ github.event_name }}",
|
|
"actor": "${{ github.actor }}",
|
|
"repository": "${{ github.repository }}",
|
|
"ref": "${{ github.ref }}",
|
|
"sha": "${{ github.sha }}",
|
|
"workflow": "${{ github.workflow }}"
|
|
}
|
|
EOF
|
|
|
|
# Send to SIEM
|
|
- name: Send to logging service
|
|
run: |
|
|
curl -X POST https://logs.example.com/api/events \
|
|
-H "Authorization: Bearer ${{ secrets.LOG_TOKEN }}" \
|
|
-H "Content-Type: application/json" \
|
|
-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
|
|
{
|
|
"Version": "2012-10-17",
|
|
"Statement": [{
|
|
"Effect": "Allow",
|
|
"Principal": {
|
|
"Federated": "arn:aws:iam::ACCOUNT:oidc-provider/token.actions.githubusercontent.com"
|
|
},
|
|
"Action": "sts:AssumeRoleWithWebIdentity",
|
|
"Condition": {
|
|
"StringEquals": {
|
|
"token.actions.githubusercontent.com:aud": "sts.amazonaws.com",
|
|
"token.actions.githubusercontent.com:sub": "repo:owner/repo:ref:refs/heads/main"
|
|
}
|
|
}
|
|
}]
|
|
}</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 "API Key: ${{ secrets.API_KEY }}"</code></pre>
|
|
<pre><code class="lang-yaml"># CORRECT: Never log secrets
|
|
- run: echo "Deploying with credentials"
|
|
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> |