mirror of
https://github.com/NVIDIA/OpenShell.git
synced 2026-10-25 06:42:52 +08:00
48 lines
2.5 KiB
Plaintext
48 lines
2.5 KiB
Plaintext
---
|
|
# SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
|
|
# SPDX-License-Identifier: Apache-2.0
|
|
title: "Default Policy Reference"
|
|
sidebar-title: "Default Policy"
|
|
description: "Breakdown of the built-in default policy applied when you create an OpenShell sandbox without a custom policy."
|
|
keywords: "Generative AI, Cybersecurity, AI Agents, Sandboxing, Security, Policy"
|
|
position: 2
|
|
---
|
|
The default policy is the policy applied when you create an OpenShell sandbox without `--policy`. It is baked into the community base image ([`ghcr.io/nvidia/openshell-community/sandboxes/base`](https://github.com/NVIDIA/OpenShell-Community)) and defined in the community repo's `dev-sandbox-policy.yaml`.
|
|
|
|
## How the Image Policy Becomes Active
|
|
|
|
On the first supervisor connection, the supervisor offers the policy found in
|
|
the sandbox image to the gateway. If the gateway already has a policy for the
|
|
sandbox, the gateway policy takes precedence. Otherwise, the gateway uses the
|
|
image policy as the initial candidate.
|
|
|
|
The gateway sends the selected policy back to the supervisor on the same
|
|
connection. The supervisor adds filesystem paths that exist in that image, then
|
|
returns either the unchanged policy or the complete prepared policy. The
|
|
gateway validates and persists the result before it accepts the supervisor
|
|
session. An invalid image or prepared policy prevents sandbox startup.
|
|
|
|
The accepted session contains a fresh gateway-owned configuration bootstrap.
|
|
The supervisor initializes from that bootstrap. It does not initialize from
|
|
the image policy or the preparation response. Reconnects skip image-policy
|
|
preparation and use the current gateway configuration.
|
|
|
|
## Agent Compatibility
|
|
|
|
The following table shows the coverage of the default policy for common agents.
|
|
|
|
| Agent | Coverage | Action Required |
|
|
|---|---|---|
|
|
| Claude Code | Full | None. Works out of the box. |
|
|
| OpenCode | Partial | Add `opencode.ai` endpoint and OpenCode binary paths. |
|
|
| Codex | None | Provide a complete custom policy with OpenAI endpoints and Codex binary paths. |
|
|
|
|
<Info>
|
|
If you run a non-Claude agent without a custom policy, the agent's API calls are denied by the proxy. You must provide a policy that declares the agent's endpoints and binaries.
|
|
|
|
</Info>
|
|
|
|
## Default Policy Blocks
|
|
|
|
The default policy blocks are defined in the community base image. Refer to the [OpenShell Community repository](https://github.com/NVIDIA/OpenShell-Community) for the full `dev-sandbox-policy.yaml` source.
|