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_consolefromCreateSession(POST /identity/entities/sessions/v1) Authorization: Bearerwithcloud-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
| Method | Path | Use |
|---|---|---|
GET | /cloud-security-assets/queries/resources/v1 | Query 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/v1 | Get 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
id | resource_name | cloud_provider | region | resource_type | account_id |
|---|---|---|---|---|---|
ast-lab-1 | Lab one | aws | us-east-1 | ec2 | acct-lab |
ast-lab-2 | Lab two | aws | us-east-1 | ec2 | acct-lab |
ast-lab-get | Lab get | aws | us-east-1 | ec2 | acct-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.
Session cookie
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'
QueryAssets (cookie)
curl -sS -b cookies.txt -H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/cloud-security-assets/queries/resources/v1'
GetAssets (cookie)
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.
Related
- Cloud security — cloud security groups
- Cloud Policies — compliance frameworks
- API reference
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.