Skip to main content

Firewall policies

Firewall policies for this CID — QueryFirewallPolicies (PEP 8 query_policies), GetFirewallPolicies (PEP 8 get_policies), and CreateFirewallPolicies (PEP 8 create_policies). Paths are GET /policy/queries/firewall/v1, GET /policy/entities/firewall/v1, and POST /policy/entities/firewall/v1.

This collection is not CrowdStrike production. It does not call Falcon cloud. It is not a prevention policy.

RPC field notes: FirewallPoliciesService.

Auth​

Every call needs a console session or a Bearer token:

  • Cookie cs_console from CreateSession (POST /identity/entities/sessions/v1)
  • Authorization: Bearer with firewall-management:read for query and get
  • firewall-management:write for create

A session cookie bypasses OAuth scopes and can query, get, and create. Seed client cs-local-hosts (hosts:read only) cannot query (403 missing scope firewall-management:read). Write scope alone cannot query or get (403). Read scope alone cannot create (403).

HTTP paths​

GET /policy/queries/firewall/v1 — RPC QueryFirewallPolicies, PEP 8 query_policies, scope firewall-management:read. Returns MSA string ids.

Empty query on list returns every firewall-policy id in this CID. Extra limit / offset / sort / filter / parameters ignored. Default sort is id ascending. Empty store → empty resources, still 200.

GET /policy/entities/firewall/v1 — RPC GetFirewallPolicies, PEP 8 get_policies, scope firewall-management:read. Query ids. Missing ids → 400 ids is required. Any unknown id → 404 firewall policy not found and no partial list. Return request order. Fields: id, name, description, platform_name, enabled.

POST /policy/entities/firewall/v1 — RPC CreateFirewallPolicies, PEP 8 create_policies, scope firewall-management:write. Body {name, description, platform_name}. Ignore resources, clone_id, parameters. Trimmed name required → else 400 name is required. platform_name must be windows, mac, or linux → else 400 platform_name is invalid (after the name check). Name unique case-insensitively → 409 firewall policy already exists. Id is fw- + slug(name): Lab policy → fw-lab-policy. enabled is true. Empty description allowed. Success 200 one policy.

JSON is snake_case MSA. Clone success is 200.

Update, delete, actions, precedence, and members are not in this build.

Update, delete, actions, precedence, and members are not in this build (not yet). No further roadmap row. Remaining operations stay under Not yet implemented. This is not a prevention policy.