OpenShell 0.1.5 makes sandbox policy and audit data operational
The release gives Kubernetes operators explicit control over pod metadata, adds standards-based OCSF export and hardens failure paths around sandbox policy enforcement.
OpenShell 0.1.5 turns two parts of agent sandboxing that are easy to leave implicit—Kubernetes metadata and audit export—into operator-controlled interfaces. The release changes mechanics that platform teams must configure and monitor when OpenShell runs sandboxed workloads.
Kubernetes metadata becomes an allowlist
Sandbox templates can no longer set arbitrary Kubernetes pod labels or annotations. An operator must now permit each key through allowed_pod_labels or allowed_pod_annotations under the Kubernetes driver configuration. Direct API and SDK callers that populate template metadata are affected, including recovery of timed-out sandboxes; OpenShell's own CLI metadata labels are not.
That is a meaningful policy boundary. Labels and annotations are commonly consumed by admission controllers, service meshes, monitoring systems and internal automation. Requiring an operator allowlist prevents a sandbox creator from silently attaching metadata that activates platform behavior outside the sandbox policy itself. OpenShell also reserves the internal.openshell.ai/ annotation prefix: the gateway rejects those keys on sandbox creation and configuration updates.
The release notes make this an upgrade task, not just a new option. Existing templates that set metadata can now fail until their keys are explicitly approved. Operators should inventory SDK and direct-API callers before rolling out 0.1.5.
OCSF moves from local files toward the telemetry pipeline
OpenShell can now export Open Cybersecurity Schema Framework events as OTLP log records. Traces and OCSF events may use separate OTLP endpoints, while existing configurations with a single endpoint continue to work. The gateway also emits OCSF Authentication events for rejected requests, carrying the mechanism, reason category, peer address and request ID.
For security teams, that makes a denied sandbox request correlatable with the rest of an observability stack instead of leaving it only in an OpenShell-specific sink. The release also fixes the required device.os.type_id field so events validate against OCSF 1.8.
There is one collector migration detail: supervisor audit files now use openshell-ocsf.YYYY-MM-DD.jsonl rather than a .log suffix. Old files are not migrated and may be removed, so collectors must update their globs and preserve any history needed before upgrade.
Enforcement fails closed
Several changes reinforce the same operating model. The network broker now denies an operation when it cannot verify a descriptor rather than falling back to native handling. Hostname-based network policy is tied to supervisor-controlled DNS. OpenShell also publishes a versioned Sandbox Protocol for independently implemented backends, replacing the previous bootstrap descriptor field for external compute drivers.
The practical result is not a new agent framework. It is a more explicit contract between sandbox users, Kubernetes operators and security telemetry systems. Teams adopting 0.1.5 should test that contract in admission policy, metadata-dependent automation and observability pipelines before a production rollout.
sources
- OpenShell v0.1.5 release notesgithub.com
comments · 0