Limits¶
Each answer names the limits that apply to it, as a note, a doubt or an unresolved entry. The sections below group the limits by command.
Versions¶
- One schema digest reads every version. It comes from PAN-OS 11.2. A field that a release added or moved, and that the digest does not describe, gives no reference. The answer does not say so.
- Panorama configurations are refused. Read each firewall's own export instead. A managed firewall already carries the rules that Panorama pushed to it.
What a configuration does not hold¶
- Predefined content. Regions and PAN-DB URL categories live in content that the firewall downloads. A rule that names one of them stays in a simulation's candidate list, in doubt.
- Predefined applications come from the device.
fetchstores the App-ID data of each content version once, in the store. A snapshot without it keeps a rule that names an application in doubt. See Applications. - Predefined services come from the device.
fetchstoresservice-httpandservice-httpswith each snapshot, inpredefined.xml. A snapshot stored before, a firewall that refused them, or--filewithoutpredefined.xmlnext to the configuration keeps a rule that names one, or a service group that holds one, in doubt. - External dynamic lists. The firewall fetches their contents at runtime.
- User-to-group mapping. It comes from User-ID. Give Proteus a user snapshot.
simulate policy¶
- No return path. Only the forward path is checked. Asymmetric routing is not detected.
- Doubtful rules can leave a hop undecided. Absent services, predefined
services the snapshot does not hold, user, HIP, schedule, PAN-DB URL categories,
regions, external dynamic lists and dynamic address groups are not evaluated. A
rule that names one of them before the match makes the hop undecided, unless it
has the same action as the match. The application and
application-defaultare evaluated with--applicationand App-ID data; see Applications. - Default-rule overrides that disagree. When the local and the pushed override of a default rule have different actions, the hop is undecided. The precedence is not verified on a Panorama-managed firewall.
- Routing limits apply to the path. See simulate routing. An ECMP, a PBF rule that can match, or a start that only a default route places leaves the hop undecided.
- Shared gateways are not verified. A shared gateway's vsys name comes from routing; such a path is not verified on a device.
- Hidden firewalls are only named. Proteus names a firewall in virtual wire or Layer 2 mode on the path, and does not check its policy.
- The answer is static. It analyzes stored snapshots and never sees live sessions.
--filedoes not check NAT. It reads one configuration without interfaces or a forwarding table. A derived destination zone is the zone before destination NAT, and a given zone gets no note when NAT would give another. Path mode applies NAT on each hop.- Derived zones are inferred. With
--fileand no zones, the zones come from the configuration. Measured against a lab firewall's owntest security-policy-match: with zones given, 7 of 7 probe flows agreed; with derived zones, 3 of 7. The misses are traffic that arrives through a tunnel zone, and destinations that the firewall sends by policy-based forwarding.
Measured agreement of path mode¶
scripts/device-probe.sh --path <flows-file> runs path mode per flow and asks each
hop's firewall the same question with test security-policy-match. On fw02,
2026-10-08:
- 9 of 9 decided hops agreed. 7 named the same rule. 2 agreed by action: the test sends no application, so the firewall stops at a rule that Proteus holds in doubt. That rule has the same action as Proteus's answer.
- 1 hop was undecided: a rule on fw01 with service
application-default. - fw01 is not probed yet.
Applications¶
simulate policy --application matches the flow's application against the
names, groups, filters and containers of each rule, with implicit use and the
default ports of application-default. These cases stay in doubt or are not
evaluated:
- No App-ID data. A snapshot that names no content version, a content file
that is missing or cannot be read, or
--filewithoutapps.xml.gzbeside the configuration gives the notenote.app-data-missing. The answer is then as without--application: a rule that names an application stays in doubt. - No
--application. A rule that names an application other thanany, or usesapplication-default, stays in doubt. - A name the data does not hold. A rule, a group or a filter
excludethat names an application or a container that neither the content data nor the configuration holds stays a candidate withdoubt.application-unknown. It never decides. A content update can remove an application, and the content data does not hold the internal preview applications. - An unknown flow application. With
--file, an unknown name or a container as--applicationexits 2 with up to five suggestions. In path mode the hop is undecided, and the reason names the device and its content version. - Policy-based forwarding. A PBF rule that names an application stays in doubt. The firewall matches PBF by application only after the App-ID cache knows the application.
- The App-ID shift. The firewall identifies an application over the first
packets of a session and can match the session again when it knows the
application. Proteus evaluates one application per flow, as
test security-policy-matchdoes. Every answer with an application carriesnote.app-shift. - An open protocol. Without
--protocol, the protocol comes from the application's default. An application with several default protocols, or with no default, leaves the protocol open. A rule that depends on it then stays in doubt. In path mode, routing and NAT see the open protocol: a NAT or PBF rule that names a service stays in doubt.--protocoldecides them. - An ICMP type. An application identified by ICMP type matches its protocol. The type is not checked, and a note says so.
- A default rule after an implicit allow. Proteus evaluates the default rules after the rules that allow the application through implicit use. The lab device's test command does not list default rules, so this order is not verified with traffic.
- One content version on two releases. The content file is stored once per content version and shared by all devices. Two PAN-OS releases with the same content version can answer differently. The captures show no such difference.
- A content file without containers. When a device returns its applications
but not its containers, the file records that. A rule that names a container
then stays in doubt, also on later fetches of that content version. Delete the
file in
<store>/.content/to fetch it again. apps.xml.gzis not checked. With--file, nothing checks that the file beside the configuration has the device's content version. The notenote.app-data-filenames the file and its version.
Measured agreement on fw02¶
make app-lab compares simulate policy --file with the device's own
test security-policy-match, flow by flow. On fw02 (PAN-OS 12.2.3), 2026-10-17,
all 108 flows agreed: the rule, the action and the implicit marker. See
docs/lab/app-id-lab.md.
simulate nat¶
- A DIPP port, a dynamic-IP pool address and a dynamic destination's distribution are chosen at runtime. Proteus shows candidates.
- NAT64 and NPTv6 are not simulated.
- A rule's active/active binding is ignored, with a note.
simulate routing¶
- IPv4 only.
- Policy-based forwarding is named, and the path does not follow it.
- ECMP follows the lowest next hop and names the others.
- A path ends where it leaves the inventory, also into a tunnel.
- Firewalls in virtual wire or Layer 2 mode are not seen on a path.
search¶
- A prefix cannot decide a wildcard address object. A wildcard object, such as
10.88.2.1/0.0.255.0, matches an address by mask, and a simulation or a search for one address decides it. One address can also be written as a /32 or as a range of one address. A search for a larger prefix or range, or with--withinor--exact, lists each wildcard object that can hold one of its addresses as unresolved, withgap.address-wildcard, and exits with code 3. - A device-level reference is matched by name alone. A static route, an IKE
gateway or other configuration outside any vsys that names an object is listed
as a reference with scope
config. Proteus does not decide which vsys's object that name refers to: a search in any vsys that finds an object of that name lists the reference.
Host names¶
- Only the first IPv4 address is checked. A source or destination given as a
host name is resolved with this machine's DNS. Proteus checks the first IPv4
address in the answer; IPv6 is not simulated.
simulate policy,simulate routingandsimulate natname the other addresses in a note. - The canonical name is this machine's view. A note gives the name's canonical name as this machine's resolver reports it. Resolvers differ: one reports the first name of a CNAME chain, another the last.
- A rule matched only through an FQDN object is in doubt. The firewall
resolves an FQDN address object itself, and its addresses can differ from the
ones this machine gets. Such a rule stays a candidate with the doubt
doubt.fqdn-resolution, also when the name resolves to nothing. A rule that also matches the address by an address object oranyis not in doubt.
The MCP server¶
proteus mcp answers with the limits above. These limits are its own:
- No authorization. Proteus does not decide who can call a tool. The gateway in front of it, such as Portkey, owns that.
- A token holder can forge the identity. The token proves that a request comes through the gateway. Proteus does not verify the identity header, and the audit records the identity as the gateway claimed it.
- Data is as fresh as the fetch schedule. The server reads the store and never
contacts a firewall. A note says when a snapshot is older than
max_snapshot_age. - Some inputs cannot be given. A rule that names an application the App-ID
data does not hold can leave a flow undecided, and no input can decide it
(
needs: []). So can a predefined service in a snapshot that does not hold it. With App-ID data,needsasks forapplication. - Configuration text reaches the model unchanged. Rule names, descriptions and object names go into the answer as the configuration holds them.
- An inventory change needs a restart. The device enum of the tools comes from the export when the server starts.
- A host name: only its first IPv4 address is checked. See Host names.
- The timeout cannot interrupt a load or an index build. A call past
call_timeoutgetscall.timeoutat once. Its work keeps the call's slot until it returns, and a load it started still fills the cache.
Lab acceptance¶
On 2026-10-10 a scripted MCP client called the server on a copy of the lab store, over stdio and over Streamable HTTP. fw02 (PAN-OS 12.2.3) was fetched fresh. fw01 was unreachable, so its snapshot was 33 hours old, and its answers carried the stale-snapshot note.
- 10 tool calls over six tools (five policy flows, routing, NAT, search, lookup and
a snapshot diff), with
detail: full: the structured envelope equalledproteus … --output json --detail fullin 10 of 10 calls over stdio and 10 of 10 over HTTP, apart fromelapsed_ms. - The answers matched the policy path probe: fw02 to fw01 on tcp/443 allowed; the
reverse on tcp/22 undecided at fw01 (service
application-default); a destination outside the estate undecided; udp/443 denied by a rule. - A device name outside the enum was refused and audited as
usage. - HTTP: no token and a wrong token gave 401, a wrong Host 403,
/healthz200, a 2 MB body 413. The audit file had mode 0600, and the token was in no audit line and no log. SIGTERM exited 143. - Not tested: the path through the Portkey SaaS gateway, which needs a public URL.
Model check¶
The model check asks a model 12 questions through the server and checks its replies against four rules. It has not run yet. Record each run here: the date, the model and its version, the gateway, the Proteus version, and the result per question.
URL matching¶
The URL matching rules come from PAN-OS documentation. A firewall's validator
checks the syntax. It cannot check matching, because test url reports PAN-DB
categories only.
Memory¶
A parsed configuration uses about ten times the size of the file.