Skip to content

Commit 8261751

Browse files
committed
docs(policy): restore policy.local and policy DNS details from main
Signed-off-by: Johnny Greco <jogreco@nvidia.com>
1 parent c19dd00 commit 8261751

2 files changed

Lines changed: 12 additions & 7 deletions

File tree

‎docs/how-it-works/policies/advisor.mdx‎

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -51,9 +51,12 @@ A proposal goes through these steps:
5151
your reason and can submit a narrower proposal.
5252

5353
OpenShell also drafts proposals on its own from connections that it blocks, in
54-
every sandbox, whether or not the policy advisor is enabled. Each draft allows
55-
one binary to reach one host and port. Drafts go through the same checks and
56-
review as proposals from the agent, and automatic approval applies to them too.
54+
every sandbox, whether or not the policy advisor is enabled. This includes
55+
connections to hostnames that no rule names. Each draft allows one binary to
56+
reach one host and port. Drafts go through the same checks and review as
57+
proposals from the agent, and automatic approval applies to them too. The
58+
blocked request stays denied, so retry it after OpenShell approves the draft and
59+
loads the new rule.
5760

5861
When the policy advisor is enabled, OpenShell adds the following to the sandbox
5962
so the agent can find and use it:
@@ -65,8 +68,8 @@ so the agent can find and use it:
6568
already have one, `/AGENTS.md`.
6669
- The `policy.local` API, which the agent uses to read the current policy and
6770
recent denials, submit proposals, and wait for decisions. OpenShell serves it
68-
at `http://policy.local`, which is reachable only from inside the sandbox.
69-
Refer to [Agent API](#agent-api).
71+
at `http://policy.local`, which is reachable only from inside the sandbox and
72+
needs no network rule or proxy setting. Refer to [Agent API](#agent-api).
7073
- Instructions in the response to each denied HTTP request on an inspected
7174
endpoint, which point the agent to the guide and the API.
7275

‎docs/how-it-works/policies/network-rules.mdx‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -597,8 +597,10 @@ the same connection, because OpenShell cannot check which service a non-HTTP
597597
payload addresses.
598598

599599
OpenShell answers DNS queries for the hosts in your rules with placeholder
600-
addresses whose TTL is at most 30 seconds. Clients must resolve the hostname
601-
again before reconnecting. A client that caches an address indefinitely can fail
600+
addresses whose TTL is at most 30 seconds. This applies to every endpoint, not
601+
only `protocol: tcp`. The sandbox applies no DNS search domains, so request each
602+
hostname exactly as your rules name it. Clients must resolve the hostname again
603+
before reconnecting. A client that caches an address indefinitely can fail
602604
after it expires, even while the endpoint remains allowed. OpenShell returns an
603605
empty answer to AAAA queries, so dual-stack clients must fall back to the A
604606
record.

0 commit comments

Comments
 (0)