Skip to content

Security: Actenon/actenon-kernel

Security

SECURITY.md

Security Policy

Scope

This repository contains an open execution kernel, not a hosted production service.

Security review is still important because the code covers:

  • Action Intent and PCCB handling
  • proof verification
  • well-known key discovery fetch behavior
  • escrow validation
  • replay protection
  • protected-endpoint behavior
  • receipt and refusal generation
  • local proof examples
  • key custody (AWS KMS backend, key-lifecycle state machine)

Related documents:

Supply Chain Posture

The kernel is the trust anchor that the entire ecosystem depends on. Its supply chain must be the strictest in the ecosystem, not the loosest (Fable 5 Part 3G).

The kernel's supply chain is enforced by .github/workflows/supply-chain.yml, which runs on every push, PR, and release tag:

  • SBOM (CycloneDX) — generated for every build; uploaded as an artefact; attested with build provenance on release tags.
  • pip-audit — runs against the OSV vulnerability database on every build. Fails the build on any known vulnerability. SARIF output is uploaded to the GitHub Security tab.
  • Sigstore signing — on release tags, the wheel and sdist are signed with keyless Sigstore (OIDC-bound). Signatures and certificates are uploaded as artefacts. Anyone can verify a published wheel was built by this workflow.
  • Build provenance attestation — on release tags, the SBOM and wheel both get SLSA build provenance attestations.

What this does NOT yet do:

  • Reproducible builds (the wheel is not byte-reproducible across builds; this requires additional hermeticity work and is on the roadmap).
  • SLSA Level 3 (currently Level 2: build provenance exists; Level 3 requires a hardened build platform).
  • Pinned hashes in pyproject.toml (transitive deps are pinned by version range; hash-pinning is on the roadmap).

What Usually Counts As A Kernel Security Issue

  • execution without required proof verification
  • incorrect proof binding checks such as audience, tenant, subject, action, target, or expiry mismatch acceptance
  • replay or duplicate execution acceptance when the documented replay path is in use
  • escrow failures such as accepting revoked, expired, or already-consumed execution state when the documented escrow path is in use
  • well-known discovery fetch behavior that permits redirects or private/internal metadata destinations through the default resolver
  • secret leakage or unsafe disclosure in public refusal or receipt artifacts
  • public documentation or defaults that overstate guarantees the OSS kernel does not actually provide

What Usually Does Not Count As A Kernel Security Issue

  • missing hosted control-plane functionality
  • provider-authenticated reconciliation features not published in the open specs
  • policy disagreements that do not create a verification bypass
  • security properties that depend on infrastructure the adopter did not deploy, such as durable replay storage, correct trust roots, or correct clock handling

When reporting an issue, distinguish clearly between:

  • a flaw in the OSS kernel or published spec surface
  • a deployment or integration mistake
  • a future paid-layer or hosted-service concern

Reporting A Security Concern

Do not open a public issue for a sensitive vulnerability.

Preferred: Use GitHub Security Advisories to file a private report. This is the fastest path and supports coordinated disclosure.

Alternative: Email ross.buckley1990@gmail.com with the subject prefix [ACTENON SECURITY].

The acknowledgement, triage, coordinated-disclosure targets, reassessment cadence, and conformance-release assurance policy are defined in docs/SECURITY_ASSURANCE.md.

Cryptographic review status

No external cryptographic review has been performed. Automated static analysis (bandit) has been run; results are in docs/CRYPTO_REVIEW.md. Security researchers interested in reviewing the crypto surface (canonicalisation, replay atomicity, key lifecycle, attestation envelopes) are invited to file findings via the reporting channels above. The CRYPTO_REVIEW.md document provides exact file pointers and specific reviewer questions for each surface.

What To Include

  • affected file or subsystem
  • impact
  • reproduction steps
  • whether the issue affects local proof only or the kernel design more broadly
  • whether the issue requires a compromised signer, adapter, or external control plane to be exploitable
  • whether the issue depends on bypassing replay, escrow, or protected-endpoint checks that the spec requires

Current Limits

This repository does not claim provider-backed production execution.

Receipts and refusals are structured public artifacts, but they are not cryptographically authenticated public attestations in the active v1 contract set.

Draft attestation groundwork for a future Receipt/Refusal v2 path is described in RECEIPT_V2_DESIGN.md, but it is not an active default or a substitute for the current v1 security statement.

Findings related to hypothetical hosted control-plane features should be clearly marked as future-layer concerns, not current implemented behavior.

There aren't any published security advisories