Sentinel Core v2.2.1 Auditor Core v2.2.1 Embedded Chain Analysis

Stop Threats Before They Emerge

Deterministic security gate for CI/CD pipelines. Intercepts every commit, runs Auditor Core v2.2.1 internally, enforces policy in real-time. ALLOW or BLOCK β€” no ambiguity, no silent bypass. Chain Analysis correlates findings into attack paths – severity escalation triggers BLOCK even on originally LOW findings. Hardware-bound licensing. 100% local execution.

Gate: ACTIVE

$ git push origin main

[SENTINEL] Analyzing commit…

βœ“ Security policy satisfied

2
States Only: ALLOW / BLOCK
11
Embedded Detectors
0
Silent Bypasses
HW
Hardware-Bound License
Chain
Attack Path Detection

Deterministic by Design

Unlike scanners that provide risk opinions, Sentinel delivers authoritative decisions. Every execution results in exactly one of two states. Chain escalation ensures correlated findings are never underreported.

ALLOW (exit 0)

Zero violations detected. Code meets all security policies. Pipeline proceeds without interruption.

Pipeline Proceeds

BLOCK (exit 1)

Critical violations or chain-escalated findings detected. Pipeline terminates immediately. Alert created in GitHub Issues with full chain details.

Pipeline Terminated

WARN (Audited)

Overridden violation with formal justification in sentinel.yaml. Pipeline proceeds with full audit trail.

Audited Exception

Audit-First Exception Model

Violations cannot be silently ignored. Every exception must be formally justified in sentinel.yaml β€” creating an immutable audit trail visible to administrators. Chain findings cannot be overridden individually; the entire chain must be justified.

# sentinel.yaml β€” Policy Overrides
overrides:
- chain_id: "CHAIN_0001"
justification: "Test harness with deliberate vulnerability chain – excluded by security review"

How Sentinel Works

Two enforcement layers β€” pre-commit hook for local development, CI/CD pipeline for every push.
Chain Analysis runs after detectors, before AI, to correlate findings into attack paths.

Developer Commits
git commit β†’ pre-commit hook fires
git commit
Sentinel + Auditor Core
11 detectors scan changed files
SCANNING
Chain Analysis + Policy Decision
Correlate findings β†’ escalate severity β†’ ALLOW/BLOCK/WARN
ALLOW
Pipeline Proceeds
Build β†’ Test β†’ Deploy
Only if ALLOW
1

Pre-commit Hook Intercepts

Installed by start.sh in .git/hooks/pre-commit. Fires before every commit β€” developer cannot bypass without explicit --no-verify flag (which triggers CI/CD alert).

2

Auditor Core v2.2.1 Scans Changed Files

Full 11-engine scan runs internally β€” Bandit, Semgrep, Gitleaks, Secret Detector, CICD Analyzer, IaC Scanner, Dependency Scanner and more. Same engine, same WSPM v2.2 scoring.

3

Chain Analysis – Attack Path Detection

Correlates findings across detectors. A hardcoded API key (LOW) feeding a command injection (MEDIUM) becomes a CRITICAL chain. Severity escalation ensures no underreporting.

Example chain: SECRET_HIGH_ENTROPY (LOW) + SAST_COMMAND_INJECTION (MEDIUM) β†’ CRITICAL
4

AI Verifies Findings (Chain-Aware)

Gemini 2.5 analyzes critical findings β€” including full chain context. Groq (Llama 3.3 70B) fallback. Optional local LLM mode for air‑gapped environments.

Chain+Findings
Gemini
Groq
Chain‑Aware Verdict
5

BLOCK β†’ GitHub Issue Alert (with Chain)

Every blocked commit automatically creates a GitHub Issue in the admin repository β€” machine identity, developer username, timestamp, violation details, and full attack path description.

❌ BLOCK β€” CHAIN_0001: secret_to_command_injection (CRITICAL)
Step 1: SECRET_HIGH_ENTROPY at config.py:42 (LOW β†’ CRITICAL)
Step 2: SAST_COMMAND_INJECTION at config.py:87 (MEDIUM β†’ CRITICAL)
Environment: πŸ’» Local Development Β· Machine: worker-pc-01
πŸš€ Alert sent β†’ admin-repo #47
6

CI/CD Pipeline β€” Second Line of Defence

GitHub Actions workflow runs sentinel scan . on every push. Even if a developer bypasses the local hook, the CI/CD gate blocks the push and alerts the admin.

Built-in Security Rules

Policy-driven enforcement β€” each rule maps to a specific threat class with configurable BLOCK / WARN response.
Chain rules can correlate multiple rule violations into a higher‑severity attack path.

Hardcoded Secrets
SEC-001 Β· BLOCK

AWS keys, API tokens, private keys, passwords hardcoded in source files or committed to git history.

Docker Integrity
SUPPLY-001 Β· BLOCK

Mutable :latest tags prohibited. Pinned digest versions enforced for build reproducibility.

GitHub Actions Pinning
CICD-001 Β· BLOCK

SHA pinning enforced for all GitHub Actions β€” prevents supply chain attacks via compromised action versions.

Kubernetes Security
INFRA-K8S-001 Β· BLOCK

runAsNonRoot and resource limits enforced in all K8s manifests. Privilege escalation blocked.

MQTT IoT Security
IOT-001 Β· WARN

Unencrypted MQTT connections and insecure broker configurations in IoT infrastructure code.

Supply Chain
DEP-001 Β· BLOCK

Unpinned dependencies, known CVEs in requirements. Prevents vulnerable packages from entering the build.

Zero-Leakage Guarantee

Sentinel forbids all unsanctioned network access at runtime by design. Safe for air-gapped environments.

No Telemetry

No usage data collected. Sentinel operates without phoning home under any circumstance.

Air-Gap Ready

Operates without internet access. Safe for classified, banking, and high-security internal environments. Local LLM mode available.

Immutable Logic

Never self-updates or pulls remote rules at runtime. Security logic is Cython-compiled and guaranteed.

Hardware-Bound Licensing

Each license is cryptographically tied to your machine's hardware identifier. Non-transferable by design.

1

Get Your Machine ID

Run on every machine where Sentinel will be deployed:

python3 get_id.py
2

Send Machine ID β†’ Receive License Key

Email your Machine ID to [email protected]. You will receive a License Key unique to that machine.

3

Run start.sh in Target Repository

Installs Sentinel, configures .env, sets up pre-commit hook and CI/CD workflow automatically.

bash start.sh
4

Test the Gate

echo 'password = "admin123"' > test.py
git add test.py && git commit -m "test"

Expected: commit blocked, GitHub Issue created, alert sent.

A License Key issued for one Machine ID will not work on any other machine. Each deployment requires its own key. Cannot be copied, transferred, or shared.
NEW IN v2.2.1

What's New in Sentinel v2.2.1

Every improvement to Auditor Core v2.2.1 propagates automatically to the enforcement gate.

Chain Analysis (Attack Paths)

Correlates findings across detectors. Severity escalation (LOW β†’ CRITICAL) triggers BLOCK. Chains appear in GitHub alerts and JSON.

PDF Evidence Appendix

Every blocked commit report includes source-level code context for CRITICAL/HIGH findings β€” audit-defensible out of the box.

SOC 2 / CIS / ISO 27001 Mapping

Every finding tagged to specific controls. Compliance tags included in every GitHub Issue alert.

Gate Override

Effective grade capped at C when CRITICAL findings exist in production code β€” regardless of SPI score.

Chain‑Aware AI + Local LLM

AI receives full chain context. Optional local LLM mode for air‑gapped environments.

Duplicate Aggregation

Multiple findings in the same file grouped as one block with line list in PDF output.

Frequently Asked Questions

Can a developer bypass Sentinel?

A developer can run git commit --no-verify locally. However, the CI/CD pipeline catches the push, blocks it, and sends an alert to the administrator with the developer's identity, machine ID, and timestamp.

What is Chain Analysis and how does it affect the gate?

Chain Analysis correlates findings that together form a complete attack path (e.g., hardcoded secret + command injection). When a chain is detected, all participating findings are escalated to the chain's resulting risk level (typically CRITICAL), and the gate blocks the commit regardless of individual severities. Chain escalation cannot be suppressed via sentinel.yaml::overrides (only the whole chain can be justified).

Does Sentinel slow down commits?

Basic scanning takes 2–5 seconds on typical projects. With Gemini AI analysis enabled β€” 15–30 seconds depending on project size and number of findings sent for verification.

What if Gemini API is unavailable?

Groq (Llama 3.3 70B) takes over automatically. If both are unavailable, Sentinel continues operating without AI enrichment β€” all core enforcement rules run fully offline at all times.

Is developer activity logged?

Yes. Every blocked commit is recorded as a GitHub Issue with machine identity, username, timestamp, and violation details β€” creating an immutable audit trail. Chain alerts include the full attack path description.

How is Sentinel different from Auditor Core?

Auditor Core is a deep audit engine β€” run on demand to produce comprehensive posture reports with SPI score. Sentinel is a real-time enforcement gate that intercepts every commit. Sentinel uses Auditor Core internally as its scanning engine.

Ready to Secure Your Perimeter?

Stop threats before they emerge. ALLOW or BLOCK β€” no ambiguity.

No telemetry Β· 100% local execution Β· Hardware-bound licensing Β· Python 3.10+ Β· Linux / macOS / Windows