Skip to main content

Cloud security assets

Cloud security assets is the cloud-assets collection for this CID — QueryAssets (PEP 8 query_assets) and GetAssets (PEP 8 get_assets). The path is GET /cloud-security-assets/queries/resources/v1 and GET /cloud-security-assets/entities/resources/v1. POST entities, application findings, and compliance-by-account are not implemented. Next leftover is p10gx D4C registration. This is not cloud security groups (/cloud-security/…): Cloud security. This is not Cloud Policies (/cloud-policies/…): Cloud Policies. This is not the HelloService template sample (GET /api/hello).

This collection is not CrowdStrike production. It does not call Falcon cloud. It is not CrowdStrike Falcon Cloud or Horizon.

RPC field notes: CloudSecurityAssetsService. REST schemas: API reference. Unused query keys filter, sort, limit, offset, after, and parameters are ignored on query. Extra unused parameters are ignored on get.

These curls use Host: crowdstrike-api.localhost against Compose Traefik on :8088. If the hostname already resolves to Traefik, you can omit the Host header and call http://crowdstrike-api.localhost instead.

Auth​

Every call needs a console session or a Bearer token:

  • Cookie cs_console from CreateSession (POST /identity/entities/sessions/v1)
  • Authorization: Bearer with cloud-security-assets:read (query and get)

A session cookie bypasses OAuth scopes and can query and get. Seed client cs-local-hosts (hosts:read only) cannot query or get (403). Unit tests use a client named cs-local-csas with cloud-security-assets:read; that client can query and get. QueryAssets stays cloud-security-assets:read. GetAssets stays cloud-security-assets:read. There is no write scope and no seeded production client with cloud-security-assets:read — use the console cookie, or a client you created with that scope. Missing or revoked token → 401.

HTTP paths​

MethodPathUse
GET/cloud-security-assets/queries/resources/v1Query asset ids. RPC QueryAssets. PEP 8 query_assets. cloud-security-assets:read. Extra unused query filter, sort, limit, offset, after, parameters ignored. Success 200 MSA string ids. Order by id ascending. Distinct from cloud security groups and Cloud Policies. POST entities / application findings / compliance-by-account are not implemented.
GET/cloud-security-assets/entities/resources/v1Get assets. RPC GetAssets. PEP 8 get_assets. cloud-security-assets:read. Query ids (required). Extra unused parameters ignored. Success 200 MSA assets (id, resource_id, resource_name, cloud_provider, region, resource_type, account_id). Missing ids → 400. Unknown id → 404 and no row is returned. Distinct from GET queries and cloud security groups.

Empty query params on GET queries return every asset id in this CID. Default sort is id ascending. Empty store → empty resources, still 200.

JSON is snake_case MSA. Clone success is 200.

POST /cloud-security-assets/entities/resources/v1, GET /cloud-security-assets/combined/application-findings/v1, and GET /cloud-security-assets/combined/compliance-controls/by-account-region-and-resource-type/v1 are not implemented. Next leftover is p10gx D4C registration.

Seed assets​

idresource_namecloud_providerregionresource_typeaccount_id
ast-lab-1Lab oneawsus-east-1ec2acct-lab
ast-lab-2Lab twoawsus-east-1ec2acct-lab
ast-lab-getLab getawsus-east-1ec2acct-lab

Query returns ast-lab-1 then ast-lab-2 then ast-lab-get in id order. Get ast-lab-get returns resource_name Lab get.

curl -sS -c cookies.txt -H 'Host: crowdstrike-api.localhost' \
-H 'Content-Type: application/json' \
-d '{"email":"[email protected]","password":"FalconLocal!1","cloud":"us-1"}' \
'http://127.0.0.1:8088/identity/entities/sessions/v1'
curl -sS -b cookies.txt -H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/cloud-security-assets/queries/resources/v1'
curl -sS -b cookies.txt -H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/cloud-security-assets/entities/resources/v1?ids=ast-lab-get'

Success returns resource_name Lab get.

POST entities, application findings, and compliance-by-account are not implemented (not yet). Next leftover is p10gx D4C registration. This is not cloud security groups or Cloud Policies.