CSPM AWS
CSPM AWS is the AWS-account-list collection for this CID —
GetCSPMAwsAccount, CreateAwsAccount (PEP 8
create_aws_account), PatchAwsAccount (SOURCE
PatchCSPMAwsAccount, PEP 8 update_aws_account),
DeleteAwsAccount (SOURCE
DeleteCSPMAwsAccount, PEP 8 delete_aws_account), AWS
user-script metadata — GetAwsAccountScriptsAttachment (SOURCE
GetCSPMAwsAccountScriptsAttachment, PEP 8
get_aws_account_scripts_attachment), and clone-local console setup
URLs — GetAwsConsoleSetupURLs (SOURCE
GetCSPMAwsConsoleSetupURLs, PEP 8
get_aws_console_setup_urls). The path is
GET /cloud-connect-cspm-aws/entities/account/v1,
POST /cloud-connect-cspm-aws/entities/account/v1,
PATCH /cloud-connect-cspm-aws/entities/account/v1, and
DELETE /cloud-connect-cspm-aws/entities/account/v1 (same path, method
DELETE). The scripts-attachment path is
GET /cloud-connect-cspm-aws/entities/user-scripts-download/v1.
The console-setup-urls path is
GET /cloud-connect-cspm-aws/entities/console-setup-urls/v1.
Image assessment policies / remaining cloud
and other cloud/container collections are not implemented (not yet).
This is not Kubernetes AWS
(/kubernetes-protection/entities/accounts/aws/v1) and not Cloud
GCP Connect (/cloud-connect-cspm-gcp/entities/account/v2). This is
not Kubernetes (/kubernetes-protection/…) and not Hosts
(/devices/…). This is not a grant-script file download. CSPM Azure
is a separate collection:
CSPM Azure. CSPM GCP is a separate
collection: CSPM GCP. Kubernetes AWS is a
separate collection: K8s AWS.
This collection is not CrowdStrike production. It does not call Falcon cloud. It is not CrowdStrike Falcon Cloud or Horizon.
RPC field notes:
CspmRegistrationService.
REST schemas: API reference. CSPM AWS uses query params, not FQL.
POST create uses JSON body {account_id, cloudtrail_region}. Extra unused
keys are ignored; the clone does not emit AWS grant scripts. Clone
success is JSON MSA 200 CspmAwsAccount, not SOURCE 201/207.
PATCH uses JSON body {account_id, cloudtrail_region}. Extra unused
body keys are ignored. Required account_id, cloudtrail_region.
Clone PATCH success is JSON MSA 200 CspmAwsAccount. PATCH is
not Kubernetes AWS update
(/kubernetes-protection/entities/accounts/aws/v1) and not
CreateAwsAccount. PATCH PEP 8 update_aws_account is not
Kubernetes AWS UpdateAWSAccount.
DELETE uses query ids (required) and an empty body. Extra unused query
keys (organization-ids, parameters) are ignored. There is no
organization-ids delete this slice. Clone DELETE success is 200
empty resources, not SOURCE 201/207. DELETE is not
Kubernetes AWS delete (/kubernetes-protection/entities/accounts/aws/v1).
GetAwsAccountScriptsAttachment uses query params ids, template,
and account_type, not FQL. Extra unused query keys (accounts,
parameters) are ignored. Clone success is JSON MSA 200
CspmAwsScriptAttachment (template, ids, account_type, note),
not a grant-script file download and not application/octet-stream.
The clone does not emit AWS grant scripts. Distinct from GET account
/cloud-connect-cspm-aws/entities/account/v1.
GetAwsConsoleSetupURLs uses query params ids,
use_existing_cloudtrail, region, tags, and template, not FQL.
Extra unused query keys (use_existing_cloudtrail, region, tags,
template, parameters) are ignored. Clone success is JSON MSA 200
CspmAwsConsoleSetupUrl (account_id, url). url is clone-local
/cspm-aws-accounts/{account_id}, not a live AWS IAM grant URL and not
a grant-script file download. Distinct from GET account
/cloud-connect-cspm-aws/entities/account/v1 and user-scripts-download
/cloud-connect-cspm-aws/entities/user-scripts-download/v1. The clone
does not emit AWS grant scripts. This is not Kubernetes AWS.
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: Bearerwithcspm-registration:read(GET) orcspm-registration:write(POST, PATCH, and DELETE)
A session cookie bypasses OAuth scopes. Seed client cs-local-hosts
(hosts:read only) cannot list accounts, download scripts, list setup
URLs, create, patch, or delete (403). cspm-registration:read can list
accounts, download scripts, and list setup URLs and cannot POST,
PATCH, or DELETE (403). GetAwsAccount stays cspm-registration:read.
GetAwsAccountScriptsAttachment stays cspm-registration:read.
GetAwsConsoleSetupURLs stays cspm-registration:read.
CreateAwsAccount, PatchAwsAccount, and DeleteAwsAccount need
cspm-registration:write. There is no product-seeded write client —
use the console cookie, or a client you created with that scope.
Missing or revoked token → 401.
HTTP paths
| Method | Path | Use |
|---|---|---|
GET | /cloud-connect-cspm-aws/entities/account/v1 | List accounts. Query: ids, status (provisioned | operational), limit, offset. |
GET | /cloud-connect-cspm-aws/entities/user-scripts-download/v1 | Download AWS user-script metadata. RPC GetAwsAccountScriptsAttachment. PEP 8 get_aws_account_scripts_attachment. Query: optional ids, template (aws-bash | aws-terraform), account_type (commercial | gov). Success 200 MSA CspmAwsScriptAttachment (template, ids, account_type, note). Extra unused query keys ignored. Distinct from GET account /entities/account/v1, Kubernetes AWS, grant-script file download. Clone does not emit AWS grant scripts. |
GET | /cloud-connect-cspm-aws/entities/console-setup-urls/v1 | List clone-local AWS console setup URLs. RPC GetAwsConsoleSetupURLs. SOURCE GetCSPMAwsConsoleSetupURLs. PEP 8 get_aws_console_setup_urls. Query: optional ids. Success 200 MSA CspmAwsConsoleSetupUrl (account_id, url). Extra unused query keys ignored. Distinct from GET account /entities/account/v1, user-scripts-download, Kubernetes AWS, grant-script file download. Clone-local url /cspm-aws-accounts/{account_id}. Clone does not emit AWS grant scripts. |
POST | /cloud-connect-cspm-aws/entities/account/v1 | Create AWS account. RPC CreateAwsAccount. Body JSON {account_id, cloudtrail_region}. Success 200 MSA CspmAwsAccount. |
PATCH | /cloud-connect-cspm-aws/entities/account/v1 | Patch AWS account CloudTrail region. RPC PatchAwsAccount. SOURCE PatchCSPMAwsAccount. PEP 8 update_aws_account. Body JSON {account_id, cloudtrail_region}. Success 200 MSA CspmAwsAccount. Extra unused body keys ignored. Distinct from Kubernetes AWS update /kubernetes-protection/entities/accounts/aws/v1 and CreateAwsAccount POST. |
DELETE | /cloud-connect-cspm-aws/entities/account/v1 | Delete AWS account. RPC DeleteAwsAccount. Query: ids (required). Empty body. Success 200 empty resources. |
Filters are exact match. Empty query params return every account in this
CID. status other than provisioned or operational → 400.
limit and offset must be ≥ 0 else 400. Omitted limit defaults
to 100 (capped at 500). Repeated ids / status: OR within a
field, AND across fields.
POST body JSON {account_id, cloudtrail_region}. Missing account_id or
cloudtrail_region → 400. Duplicate account_id → 400. Extra
unused keys are ignored; the clone does not emit AWS grant scripts.
Clone success is 200 MSA CspmAwsAccount (not SOURCE 201/207).
POST account_id=333333333333 / cloudtrail_region=us-west-2 returns
that account with status provisioned. cspm-registration:read on
POST → 403. cs-local-hosts on POST → 403.
PATCH body JSON {account_id, cloudtrail_region}. Missing account_id
or cloudtrail_region → 400. Unknown account_id → 404. Extra
unused body keys (iam_role_arn, behavior_assessment_enabled,
resources, remediation_region, parameters) are ignored. Clone
success is 200 MSA CspmAwsAccount. PATCH account_id=111111111111
/ cloudtrail_region=us-west-1 returns that account with
cloudtrail_region us-west-1. Organization, status, IAM role, and
account type stay unchanged. GET ids=111111111111 after PATCH is that
region. cspm-registration:read on PATCH → 403. cs-local-hosts on
PATCH → 403. This is not Kubernetes AWS update
PATCH /kubernetes-protection/entities/accounts/aws/v1 and not
CreateAwsAccount.
DELETE query ids (empty body). ids is required; missing ids →
400. Unknown account id → 400. Extra unused query keys
(organization-ids, parameters) are ignored. There is no
organization-ids delete this slice. Clone success is 200 empty
resources (not SOURCE 201/207). GET ids=333333333333 after
DELETE is empty. A second DELETE of the same id → 400. If several
ids are sent and any is unknown or empty, 400 and no row is
deleted. cspm-registration:read on DELETE → 403.
cs-local-hosts on DELETE → 403. Do not seed 333333333333.
This is not Kubernetes AWS
DELETE /kubernetes-protection/entities/accounts/aws/v1.
Empty ids on GetAwsAccountScriptsAttachment uses every stored AWS
account id (order account_id ASC). ids=111111111111 returns that id
only. Unknown id → 400 unknown aws account id. Empty template
defaults aws-bash. Allowed templates aws-bash | aws-terraform;
unknown → 400 unknown template. Empty account_type defaults
commercial. Allowed commercial | gov; unknown → 400
unknown account_type. Extra unused query keys (accounts,
parameters) are ignored. note is always
This clone does not emit AWS grant scripts. There is no content
script field. Success is JSON MSA 200, not
application/octet-stream. Distinct from GET account
/cloud-connect-cspm-aws/entities/account/v1, Kubernetes AWS, and
grant-script file download.
Empty ids on GetAwsConsoleSetupURLs uses every stored AWS account id
(order account_id ASC). ids=111111111111 returns that id only.
Unknown id → 400 unknown aws account id. Extra unused query keys
(use_existing_cloudtrail, region, tags, template,
parameters) are ignored. Each resource is account_id and clone-local
url /cspm-aws-accounts/{account_id}. Success is JSON MSA 200,
not a live AWS IAM grant URL and not application/octet-stream. Distinct
from GET account /cloud-connect-cspm-aws/entities/account/v1,
user-scripts-download
/cloud-connect-cspm-aws/entities/user-scripts-download/v1, Kubernetes
AWS, and grant-script file download.
JSON is SOURCE snake_case: account_id, organization_id,
iam_role_arn, status, account_type, cloudtrail_region, cid.
Scripts JSON is template, ids, account_type, note. Setup URL
JSON is account_id, url.
This is not Kubernetes AWS, Cloud GCP Connect, Kubernetes, or Hosts.
Kubernetes AWS uses /kubernetes-protection/entities/accounts/aws/v1:
K8s AWS. Cloud GCP Connect uses
/cloud-connect-cspm-gcp/entities/account/v2:
CSPM GCP. Kubernetes uses
/kubernetes-protection/entities/kubernetes/clusters/v1:
Kubernetes. Hosts uses /devices/…:
Hosts. Image assessment policies / remaining cloud and other cloud collections are not
implemented (not yet). CSPM Azure uses
/cloud-connect-cspm-azure/entities/account/v1:
CSPM Azure.
Seed accounts
account_id | organization_id | status | account_type | cloudtrail_region | iam_role_arn |
|---|---|---|---|---|---|
111111111111 | o-laborg1 | operational | commercial | us-east-1 | arn:aws:iam::111111111111:role/CrowdStrikeFalcon |
222222222222 | o-laborg2 | provisioned | commercial | eu-west-1 | arn:aws:iam::222222222222:role/CrowdStrikeFalcon |
cid is cid-local-1. Empty filters return both.
status=operational returns 111111111111. ids=111111111111 returns
that row. POST create with 333333333333 / us-west-2 adds that row
with status provisioned. PATCH 111111111111 / us-west-1 updates
that row's CloudTrail region. GET after PATCH is us-west-1. DELETE
ids=333333333333 removes that row.
GET after DELETE is empty. Empty scripts ids returns template
aws-bash and both seed ids. ids=111111111111 on scripts returns
that id only. Empty setup ids returns both seed ids with clone-local
urls /cspm-aws-accounts/111111111111 and
/cspm-aws-accounts/222222222222. ids=111111111111 on setup URLs
returns that id only.
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
List accounts (cookie)
Empty filters return at least the two seed ids, including 111111111111:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'
status=operational returns 111111111111:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1?status=operational'
ids=111111111111 returns that row:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1?ids=111111111111'
Unknown status is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1?status=bogus'
No cookie and no Bearer is 401:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'
Image assessment policies / remaining cloud and other
cloud collections are not implemented (not yet). Kubernetes AWS is a
separate collection (/kubernetes-protection/entities/accounts/aws/v1):
K8s AWS. Cloud GCP Connect is a
separate collection (/cloud-connect-cspm-gcp/entities/account/v2):
CSPM GCP. Kubernetes is a separate collection:
Kubernetes. Hosts is a separate collection:
Hosts. CSPM Azure is a separate collection:
CSPM Azure. CSPM GCP is a separate
collection: CSPM GCP.
Download scripts (cookie)
Empty ids returns template aws-bash, ids 111111111111 and
222222222222, and note This clone does not emit AWS grant scripts.
Success is 200 MSA CspmAwsScriptAttachment. Extra unused query keys
are ignored. This is not GET account
(/cloud-connect-cspm-aws/entities/account/v1), not Kubernetes AWS,
and not a grant-script file download. The clone does not emit AWS
grant scripts:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/user-scripts-download/v1'
ids=111111111111 returns that id only:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/user-scripts-download/v1?ids=111111111111'
Unknown account id is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/user-scripts-download/v1?ids=999999999999'
Unknown template is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/user-scripts-download/v1?template=bogus'
Extra unused query keys are ignored (accounts does not change the
metadata):
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/user-scripts-download/v1?accounts=ignored'
cs-local-hosts (hosts:read only) is 403 on GET:
TOKEN='<access_token from cs-local-hosts>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/user-scripts-download/v1'
No cookie and no Bearer is 401 on GET:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/user-scripts-download/v1'
Image assessment policies / remaining cloud and other
cloud collections are not implemented (not yet). Kubernetes AWS is a
separate collection (/kubernetes-protection/entities/accounts/aws/v1):
K8s AWS. Cloud GCP Connect is a
separate collection (/cloud-connect-cspm-gcp/entities/account/v2):
CSPM GCP. Kubernetes is a separate collection:
Kubernetes. Hosts is a separate collection:
Hosts. CSPM Azure is a separate collection:
CSPM Azure.
Setup URLs (cookie)
Empty ids returns 111111111111 and 222222222222 with clone-local
url /cspm-aws-accounts/111111111111 and
/cspm-aws-accounts/222222222222. Success is 200 MSA
CspmAwsConsoleSetupUrl. Extra unused query keys are ignored. This is
not GET account (/cloud-connect-cspm-aws/entities/account/v1),
not user-scripts-download
(/cloud-connect-cspm-aws/entities/user-scripts-download/v1), not
Kubernetes AWS, and not a grant-script file download. The clone
does not emit AWS grant scripts. url is not a live AWS IAM grant
URL:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/console-setup-urls/v1'
ids=111111111111 returns that id only:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/console-setup-urls/v1?ids=111111111111'
Unknown account id is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/console-setup-urls/v1?ids=999999999999'
Extra unused query keys are ignored (template does not change the
urls):
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/console-setup-urls/v1?template=ignored'
cs-local-hosts (hosts:read only) is 403 on GET:
TOKEN='<access_token from cs-local-hosts>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/console-setup-urls/v1'
No cookie and no Bearer is 401 on GET:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/console-setup-urls/v1'
Image assessment policies / remaining cloud and other
cloud collections are not implemented (not yet). Kubernetes AWS is a
separate collection (/kubernetes-protection/entities/accounts/aws/v1):
K8s AWS. Cloud GCP Connect is a
separate collection (/cloud-connect-cspm-gcp/entities/account/v2):
CSPM GCP. Kubernetes is a separate collection:
Kubernetes. Hosts is a separate collection:
Hosts. CSPM Azure is a separate collection:
CSPM Azure.
Create account (cookie)
POST account_id=333333333333 / cloudtrail_region=us-west-2 returns
that account with status provisioned. Success is 200 MSA
CspmAwsAccount:
curl -sS -X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"account_id":"333333333333","cloudtrail_region":"us-west-2"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'
Duplicate account_id is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"account_id":"333333333333","cloudtrail_region":"us-west-2"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'
Missing account_id is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"cloudtrail_region":"us-west-2"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'
Missing cloudtrail_region is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"account_id":"333333333333"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'
cs-local-hosts (hosts:read only) is 403 on POST:
TOKEN='<access_token from cs-local-hosts>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"account_id":"333333333333","cloudtrail_region":"us-west-2"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'
No cookie and no Bearer is 401 on POST:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' \
-H 'Content-Type: application/json' \
-d '{"account_id":"333333333333","cloudtrail_region":"us-west-2"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'
Image assessment policies / remaining cloud and other
cloud collections are not implemented (not yet). Kubernetes AWS is a
separate collection (/kubernetes-protection/entities/accounts/aws/v1):
K8s AWS. Cloud GCP Connect is a
separate collection (/cloud-connect-cspm-gcp/entities/account/v2):
CSPM GCP. Kubernetes is a separate collection:
Kubernetes. Hosts is a separate collection:
Hosts. CSPM Azure is a separate collection:
CSPM Azure.
Patch account (cookie)
PATCH account_id=111111111111 / cloudtrail_region=us-west-1 returns
that account with CloudTrail region us-west-1. Success is 200 MSA
CspmAwsAccount. Extra unused body keys are ignored. This is not
Kubernetes AWS update
(PATCH /kubernetes-protection/entities/accounts/aws/v1) and not
CreateAwsAccount. GET ids=111111111111 after PATCH is us-west-1:
curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"account_id":"111111111111","cloudtrail_region":"us-west-1"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'
Missing account_id is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"cloudtrail_region":"us-west-1"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'
Missing cloudtrail_region is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"account_id":"111111111111"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'
Unknown account_id is 404:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"account_id":"999999999999","cloudtrail_region":"us-west-1"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'
Extra unused body keys are ignored (iam_role_arn does not change the
role):
curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"account_id":"111111111111","cloudtrail_region":"us-west-1","iam_role_arn":"ignored"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'
cs-local-hosts (hosts:read only) is 403 on PATCH:
TOKEN='<access_token from cs-local-hosts>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"account_id":"111111111111","cloudtrail_region":"us-west-1"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'
No cookie and no Bearer is 401 on PATCH:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' \
-H 'Content-Type: application/json' \
-d '{"account_id":"111111111111","cloudtrail_region":"us-west-1"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'
Image assessment policies / remaining cloud and other
cloud collections are not implemented (not yet). Kubernetes AWS is a
separate collection (/kubernetes-protection/entities/accounts/aws/v1):
K8s AWS. Cloud GCP Connect is a
separate collection (/cloud-connect-cspm-gcp/entities/account/v2):
CSPM GCP. Kubernetes is a separate collection:
Kubernetes. Hosts is a separate collection:
Hosts. CSPM Azure is a separate collection:
CSPM Azure.
Delete account (cookie)
DELETE ids=333333333333 returns empty resources. Success is 200.
A later GET ids=333333333333 is empty. A second DELETE of the same id
is 400. This is not Kubernetes AWS
DELETE /kubernetes-protection/entities/accounts/aws/v1. Extra unused
query keys (organization-ids, parameters) are ignored. Empty body:
curl -sS -X DELETE -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1?ids=333333333333'
Missing ids is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'
Unknown account id is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1?ids=999999999999'
cs-local-hosts (hosts:read only) is 403 on DELETE:
TOKEN='<access_token from cs-local-hosts>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1?ids=333333333333'
No cookie and no Bearer is 401 on DELETE:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1?ids=333333333333'
Image assessment policies / remaining cloud and other
cloud collections are not implemented (not yet). Kubernetes AWS is a
separate collection (/kubernetes-protection/entities/accounts/aws/v1):
K8s AWS. Cloud GCP Connect is a
separate collection (/cloud-connect-cspm-gcp/entities/account/v2):
CSPM GCP. Kubernetes is a separate collection:
Kubernetes. Hosts is a separate collection:
Hosts. CSPM Azure is a separate collection:
CSPM Azure.
List (Bearer)
TOKEN='<access_token from a client with cspm-registration:read>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'
cspm-registration:read → 200. A token without that scope
(including hosts:read only, e.g. cs-local-hosts) → 403. Missing
or revoked token → 401. GetAwsAccount stays
cspm-registration:read. There is no seeded production client with
cspm-registration:read — use the console cookie, or a client you
created with that scope.
Download scripts (Bearer)
TOKEN='<access_token from a client with cspm-registration:read>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/user-scripts-download/v1'
cspm-registration:read → 200. A token without that scope
(including hosts:read only, e.g. cs-local-hosts) → 403. Missing
or revoked token → 401. GetAwsAccountScriptsAttachment stays
cspm-registration:read. PEP 8 get_aws_account_scripts_attachment.
There is no seeded production client with cspm-registration:read —
use the console cookie, or a client you created with that scope.
Setup URLs (Bearer)
TOKEN='<access_token from a client with cspm-registration:read>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/console-setup-urls/v1'
cspm-registration:read → 200. A token without that scope
(including hosts:read only, e.g. cs-local-hosts) → 403. Missing
or revoked token → 401. GetAwsConsoleSetupURLs stays
cspm-registration:read. PEP 8 get_aws_console_setup_urls.
There is no seeded production client with cspm-registration:read —
use the console cookie, or a client you created with that scope.
Create (Bearer)
TOKEN='<access_token from a client with cspm-registration:write>'
curl -sS -X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"account_id":"333333333333","cloudtrail_region":"us-west-2"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'
cspm-registration:write → 200 on POST. A token without that
scope (including hosts:read only, e.g. cs-local-hosts, or
cspm-registration:read) → 403. Missing or revoked token →
401. There is no product-seeded write client with
cspm-registration:write — use the console cookie, or a client you
created with that scope. CreateAwsAccount stays
cspm-registration:write. PEP 8 create_aws_account.
Patch (Bearer)
TOKEN='<access_token from a client with cspm-registration:write>'
curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"account_id":"111111111111","cloudtrail_region":"us-west-1"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'
cspm-registration:write → 200 on PATCH. A token without that
scope (including hosts:read only, e.g. cs-local-hosts, or
cspm-registration:read) → 403. Missing or revoked token →
401. There is no product-seeded write client with
cspm-registration:write — use the console cookie, or a client you
created with that scope. PatchAwsAccount stays
cspm-registration:write. SOURCE PatchCSPMAwsAccount. PEP 8
update_aws_account. Distinct from Kubernetes AWS update and
CreateAwsAccount.
Delete (Bearer)
TOKEN='<access_token from a client with cspm-registration:write>'
curl -sS -X DELETE -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1?ids=333333333333'
cspm-registration:write → 200 on DELETE. A token without that
scope (including hosts:read only, e.g. cs-local-hosts, or
cspm-registration:read) → 403. Missing or revoked token →
401. There is no product-seeded write client with
cspm-registration:write — use the console cookie, or a client you
created with that scope. DeleteAwsAccount stays
cspm-registration:write. PEP 8 delete_aws_account.
OAuth2 mint/revoke: OAuth2. Accessible scopes: API clients.