CSPM Azure
CSPM Azure is the Azure-subscription-list collection for this CID —
GetCSPMAzureAccount, CreateAzureAccount (PEP 8
create_azure_account), UpdateAzureAccount (SOURCE
UpdateCSPMAzureAccount, PEP 8 update_azure_account),
UpdateAzureAccountClientID (SOURCE
UpdateCSPMAzureAccountClientID, PEP 8
update_azure_account_client_id),
AzureRefreshCertificate (PEP 8 azure_refresh_certificate),
AzureDownloadCertificate (PEP 8 azure_download_certificate),
CreateAzureManagementGroup (PEP 8
create_azure_management_group), DeleteAzureAccount (SOURCE
DeleteCSPMAzureAccount, PEP 8 delete_azure_account),
DeleteAzureManagementGroup (SOURCE
DeleteCSPMAzureManagementGroup, PEP 8
delete_azure_management_group),
GetAzureManagementGroup (SOURCE
GetCSPMAzureManagementGroup, PEP 8
get_azure_management_group),
UpdateAzureTenantDefaultSubscriptionID (SOURCE
UpdateCSPMAzureTenantDefaultSubscriptionID, PEP 8
update_azure_tenant_default_subscription_id), and Azure user-script metadata —
GetAzureUserScriptsAttachment (SOURCE
GetCSPMAzureUserScriptsAttachment, PEP 8
get_azure_user_scripts_attachment).
The GET path is
GET /cloud-connect-cspm-azure/entities/account/v1. The create path is
POST /cloud-connect-cspm-azure/entities/account/v1 (same path, method
POST). The update path is
PATCH /cloud-connect-cspm-azure/entities/account/v1 (same path, method
PATCH). The client-id path is
PATCH /cloud-connect-cspm-azure/entities/client-id/v1. The delete path is
DELETE /cloud-connect-cspm-azure/entities/account/v1 (same path, method
DELETE). The refresh path is
POST /cloud-connect-cspm-azure/entities/refresh-certificate/v1.
The download path is
GET /cloud-connect-cspm-azure/entities/download-certificate/v1
(distinct from POST refresh).
The management-group GET path is
GET /cloud-connect-cspm-azure/entities/management-group/v1 (same
path as POST/DELETE, method GET).
The management-group path is
POST /cloud-connect-cspm-azure/entities/management-group/v1 (same
path, method POST).
The management-group delete path is
DELETE /cloud-connect-cspm-azure/entities/management-group/v1 (same
path, method DELETE).
The default-subscription path is
PATCH /cloud-connect-cspm-azure/entities/default-subscription-id/v1.
The scripts-attachment path is
GET /cloud-connect-cspm-azure/entities/user-scripts-download/v1.
Image assessment policies / remaining cloud
and other cloud/container collections are
not implemented (not yet). This is not Kubernetes
(/kubernetes-protection/…) and not Cloud AWS
(/cloud-connect-cspm-aws/…). CSPM GCP is a separate collection:
CSPM GCP. This is not Kubernetes Azure
create (/kubernetes-protection/entities/accounts/azure/v1):
K8s Azure. This is not Kubernetes Azure
update (PATCH /kubernetes-protection/entities/accounts/azure/v1).
This is not Kubernetes Azure
delete (DELETE /kubernetes-protection/entities/accounts/azure/v1).
This is not the Kubernetes Azure
install script (/kubernetes-protection/entities/user-script/azure/v1):
K8s Azure script. 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:
CspmRegistrationService.
REST schemas: API reference. CSPM Azure uses query params, not FQL.
POST create uses JSON body {subscription_id, tenant_id}. Extra unused
keys are ignored; the clone does not emit Azure grant scripts. Clone
success is JSON MSA 200 CspmAzureAccount, not SOURCE 201/207.
PATCH uses JSON body {subscription_id, tenant_id}. Extra unused
body keys are ignored. Required subscription_id, tenant_id.
Clone PATCH success is JSON MSA 200 CspmAzureAccount, not SOURCE
201/207. PATCH is
not Kubernetes Azure update
(/kubernetes-protection/entities/accounts/azure/v1) and not
CreateAzureAccount. PATCH PEP 8 update_azure_account is not
Kubernetes Azure update.
PATCH client-id uses query id (new client id) and tenant_id. Extra
unused query/body keys (parameters, tenant-id as unused extra if
tenant_id is present) are ignored. Required query id, tenant_id.
Clone PATCH client-id success is JSON MSA 200 CspmAzureCertificate,
not SOURCE 201. PATCH client-id is not UpdateAzureAccount
account PATCH (/cloud-connect-cspm-azure/entities/account/v1), not
PATCH default-subscription
(/cloud-connect-cspm-azure/entities/default-subscription-id/v1), and
not Kubernetes Azure.
PATCH default-subscription uses query subscription_id (new default)
and tenant_id. Extra unused query/body keys (parameters, tenant-id
as unused extra if tenant_id is present) are ignored. Required query
subscription_id, tenant_id. No proto body: "*". Clone PATCH
default-subscription success is JSON MSA 200 CspmAzureManagementGroup,
not SOURCE 201. PATCH default-subscription is not UpdateAzureAccount
account PATCH (/cloud-connect-cspm-azure/entities/account/v1), not
UpdateAzureAccountClientID (/cloud-connect-cspm-azure/entities/client-id/v1),
not Create/Delete management group
(/cloud-connect-cspm-azure/entities/management-group/v1), and not
Kubernetes Azure.
POST refresh uses query tenant_id and optional years_valid, empty
body. Extra unused query keys (parameters) are ignored. Clone success
is JSON MSA 200, not a file download.
GET download uses query tenant_id (required) and an empty body. Extra
unused query keys (parameters) are ignored. Clone success is JSON MSA
200 CspmAzureCertificate, not a file stream. GET download is
not POST refresh
(/cloud-connect-cspm-azure/entities/refresh-certificate/v1).
GetAzureUserScriptsAttachment uses query params optional snake
tenant_id and subscription_ids, not FQL. Extra unused query keys
(tenant-id, account_type, template, azure_management_group,
parameters) are ignored. Clone success is JSON MSA 200 one
CspmAzureScriptAttachment (tenant_id, subscription_ids, note),
not a grant-script file download and not application/octet-stream.
The clone does not emit Azure grant scripts. Distinct from GET account
/cloud-connect-cspm-azure/entities/account/v1, GET download-certificate
/cloud-connect-cspm-azure/entities/download-certificate/v1, Kubernetes
Azure, and the Kubernetes Azure install script.
POST management-group uses JSON body
{tenant_id, default_subscription_id}. Extra unused keys are ignored;
the clone does not emit Azure grant scripts. Clone success is JSON MSA
200 CspmAzureManagementGroup, not SOURCE 201/207. Distinct
from GET management-group (same path, method GET).
GET management-group extra unused query tenant_ids, limit, offset,
and parameters are ignored. Clone GET success is JSON MSA 200
CspmAzureManagementGroup (tenant_id, default_subscription_id,
cid). SOURCE JSON array is not the clone envelope. Distinct from
POST/DELETE management-group, PATCH default-subscription-id, and GET
account.
DELETE uses query ids (required) and an empty body. Extra unused query
keys (tenant_ids, retain_tenant, parameters) are ignored. There is
no tenant_ids / retain_tenant delete this slice. Clone DELETE success is
200 empty resources, not SOURCE 201/207. DELETE is not
Kubernetes Azure delete
(/kubernetes-protection/entities/accounts/azure/v1).
DELETE management-group uses query tenant_ids (required) and an empty
body. Extra unused query keys (ids, parameters) are ignored. Clone
DELETE management-group success is 200 empty resources, not SOURCE
201/207. DELETE management-group is not Azure account delete
(/cloud-connect-cspm-azure/entities/account/v1 query ids) and not
PATCH default-subscription
(/cloud-connect-cspm-azure/entities/default-subscription-id/v1).
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 list, GET download, GET user-scripts-download, GET management-group) orcspm-registration:write(POST create, PATCH update, PATCH client-id, PATCH default-subscription, POST refresh, POST management-group, DELETE account, and DELETE management-group)
A session cookie bypasses OAuth scopes. Seed client cs-local-hosts
(hosts:read only) cannot list accounts, download a certificate,
download scripts, list management groups, create, update, update a client id, refresh a
certificate, create a management group, update a default subscription,
delete an account, or delete a management group
(403). cspm-registration:read can list accounts, download a
certificate, download scripts, and list management groups and cannot POST, PATCH, or DELETE
(403). GetCSPMAzureAccount, AzureDownloadCertificate,
GetAzureUserScriptsAttachment, and GetAzureManagementGroup stay
cspm-registration:read.
CreateAzureAccount, UpdateAzureAccount, UpdateAzureAccountClientID,
AzureRefreshCertificate, CreateAzureManagementGroup,
UpdateAzureTenantDefaultSubscriptionID, DeleteAzureAccount,
and DeleteAzureManagementGroup
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-azure/entities/account/v1 | List accounts. Query: ids, status (Event_DiscoverAccountStatusProvisioned | Event_DiscoverAccountStatusOperational), limit, offset. |
POST | /cloud-connect-cspm-azure/entities/account/v1 | Create Azure account. RPC CreateAzureAccount. PEP 8 create_azure_account. Body JSON {subscription_id, tenant_id}. Success 200 MSA CspmAzureAccount. |
PATCH | /cloud-connect-cspm-azure/entities/account/v1 | Update Azure account tenant. RPC UpdateAzureAccount. SOURCE UpdateCSPMAzureAccount. PEP 8 update_azure_account. Body JSON {subscription_id, tenant_id}. Success 200 MSA CspmAzureAccount, not SOURCE 201/207. Extra unused body keys ignored. Distinct from Kubernetes Azure update /kubernetes-protection/entities/accounts/azure/v1, CreateAzureAccount POST, and PATCH client-id /cloud-connect-cspm-azure/entities/client-id/v1. |
PATCH | /cloud-connect-cspm-azure/entities/client-id/v1 | Update Azure certificate client id. RPC UpdateAzureAccountClientID. SOURCE UpdateCSPMAzureAccountClientID. PEP 8 update_azure_account_client_id. Query: id (required, new client id), tenant_id (required). Success 200 MSA CspmAzureCertificate, not SOURCE 201. Extra unused query/body keys ignored. Distinct from UpdateAzureAccount account PATCH /cloud-connect-cspm-azure/entities/account/v1, PATCH default-subscription /cloud-connect-cspm-azure/entities/default-subscription-id/v1, and Kubernetes Azure. |
POST | /cloud-connect-cspm-azure/entities/refresh-certificate/v1 | Refresh Azure service-principal certificate. Query: tenant_id (required), years_valid (optional 1 or 2, default 1). Empty body. Success 200. Distinct from GET download-certificate. |
GET | /cloud-connect-cspm-azure/entities/download-certificate/v1 | Download stored Azure service-principal certificate. RPC AzureDownloadCertificate. PEP 8 azure_download_certificate. Query: tenant_id (required). Empty body. Success 200 MSA CspmAzureCertificate. Distinct from POST refresh-certificate. No file stream. Extra unused query keys ignored. |
GET | /cloud-connect-cspm-azure/entities/user-scripts-download/v1 | Download Azure user-script metadata. RPC GetAzureUserScriptsAttachment. SOURCE GetCSPMAzureUserScriptsAttachment. PEP 8 get_azure_user_scripts_attachment. Query: optional snake tenant_id, subscription_ids. Success 200 MSA one CspmAzureScriptAttachment (tenant_id, subscription_ids, note). Extra unused query keys ignored including SOURCE hyphen tenant-id, account_type, template, azure_management_group, parameters. Distinct from GET account /entities/account/v1, GET /download-certificate/v1, Kubernetes Azure, Kubernetes Azure install script, grant-script file download. Clone does not emit Azure grant scripts. No file stream. |
GET | /cloud-connect-cspm-azure/entities/management-group/v1 | List Azure management groups. RPC GetAzureManagementGroup. SOURCE GetCSPMAzureManagementGroup. PEP 8 get_azure_management_group. Extra unused query tenant_ids, limit, offset, and parameters ignored. Success 200 MSA tenant_id + default_subscription_id + cid. SOURCE JSON array is not the clone envelope. Distinct from POST/DELETE management-group (same path), PATCH default-subscription-id /cloud-connect-cspm-azure/entities/default-subscription-id/v1, and GET account /cloud-connect-cspm-azure/entities/account/v1. cspm-registration:read. |
POST | /cloud-connect-cspm-azure/entities/management-group/v1 | Create Azure management group. RPC CreateAzureManagementGroup. PEP 8 create_azure_management_group. Body JSON {tenant_id, default_subscription_id}. Success 200 MSA CspmAzureManagementGroup. Distinct from POST account/v1, refresh-certificate, GET management-group (same path, method GET), and PATCH default-subscription /cloud-connect-cspm-azure/entities/default-subscription-id/v1. |
DELETE | /cloud-connect-cspm-azure/entities/account/v1 | Delete Azure account. RPC DeleteAzureAccount. PEP 8 delete_azure_account. Query: ids (required). Empty body. Success 200 empty resources. Distinct from Kubernetes Azure delete. |
DELETE | /cloud-connect-cspm-azure/entities/management-group/v1 | Delete Azure management group. RPC DeleteAzureManagementGroup. PEP 8 delete_azure_management_group. Query: tenant_ids (required). Empty body. Success 200 empty resources. Distinct from Azure account delete (ids), GET management-group (same path, method GET), and PATCH default-subscription /cloud-connect-cspm-azure/entities/default-subscription-id/v1. |
PATCH | /cloud-connect-cspm-azure/entities/default-subscription-id/v1 | Update Azure tenant default subscription. RPC UpdateAzureTenantDefaultSubscriptionID. SOURCE UpdateCSPMAzureTenantDefaultSubscriptionID. PEP 8 update_azure_tenant_default_subscription_id. Query: subscription_id (required, new default), tenant_id (required). Success 200 MSA CspmAzureManagementGroup, not SOURCE 201. Extra unused query/body keys ignored. Distinct from UpdateAzureAccount account PATCH /cloud-connect-cspm-azure/entities/account/v1, UpdateAzureAccountClientID /cloud-connect-cspm-azure/entities/client-id/v1, Create/Delete management group /cloud-connect-cspm-azure/entities/management-group/v1, and Kubernetes Azure. No proto body: "*". |
Filters are exact match. Empty query params return every account in this
CID. status other than Event_DiscoverAccountStatusProvisioned or
Event_DiscoverAccountStatusOperational → 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 create body JSON {subscription_id, tenant_id}. Missing
subscription_id or tenant_id → 400. Duplicate subscription_id
→ 400. Extra unused keys (years_valid, client_id, resources,
…) are ignored; the clone does not emit Azure grant scripts. Clone
success is 200 MSA CspmAzureAccount (not SOURCE 201/207).
POST subscription_id=sub-lab-3 / tenant_id=t-lab-3 returns that
account with status Event_DiscoverAccountStatusProvisioned.
cspm-registration:read on POST → 403. cs-local-hosts on POST →
403. This is not Kubernetes Azure create
(/kubernetes-protection/entities/accounts/azure/v1):
K8s Azure. This is not Create
management group (/cloud-connect-cspm-azure/entities/management-group/v1).
This is not Update account (PATCH same path).
PATCH body JSON {subscription_id, tenant_id}. Missing subscription_id
or tenant_id → 400. Unknown subscription_id → 404. Extra
unused body keys (account_type, client_id, default_subscription,
years_valid, resources, environment, parameters) are ignored.
Clone success is 200 MSA CspmAzureAccount (not SOURCE 201/207).
PATCH subscription_id=sub-lab-1 / tenant_id=t-lab-1b returns that
account with tenant_id t-lab-1b. Status, account type, and cid stay
unchanged. GET ids=sub-lab-1 after PATCH is that tenant.
cspm-registration:read on PATCH → 403. cs-local-hosts on
PATCH → 403. This is not Kubernetes Azure update
PATCH /kubernetes-protection/entities/accounts/azure/v1, not
CreateAzureAccount, and not PATCH client-id
(/cloud-connect-cspm-azure/entities/client-id/v1).
PATCH client-id query id and tenant_id. Missing id → 400.
Missing tenant_id → 400. Unknown tenant_id → 404. Extra
unused query/body keys (parameters, tenant-id as unused extra if
tenant_id is present) are ignored. Clone success is 200 MSA
CspmAzureCertificate (not SOURCE 201). PATCH id=az-app-lab-1b /
tenant_id=t-lab-1 returns that certificate with client_id
az-app-lab-1b. Other cert fields stay unchanged. GET download-certificate
tenant_id=t-lab-1 after PATCH is that client id.
cspm-registration:read on PATCH client-id → 403. cs-local-hosts
on PATCH client-id → 403. This is not UpdateAzureAccount
(PATCH /cloud-connect-cspm-azure/entities/account/v1), not
PATCH default-subscription
(/cloud-connect-cspm-azure/entities/default-subscription-id/v1), and
not Kubernetes Azure.
POST query tenant_id and optional years_valid (empty body). Missing
tenant_id → 400. Unknown tenant → 400. years_valid other
than 1 or 2 → 400. Omitted years_valid defaults to 1. Extra
unused query keys (parameters) are ignored. Clone success is 200
JSON MSA (not a file stream). POST tenant_id=t-lab-1 returns that
tenant with valid true and a public certificate. cspm-registration:read
on POST → 403. This is not Create management group. This is
not GET download-certificate.
GET download query tenant_id (empty body). Missing tenant_id →
400. Unknown tenant → 400. Extra unused query keys
(parameters) are ignored. If several tenant_id values are sent and
any is unknown or empty, 400 and no resources are returned. Clone
success is 200 MSA CspmAzureCertificate (not a file stream). GET
tenant_id=t-lab-1 returns that stored row with valid true and a
public certificate. cspm-registration:read on GET → 200.
cs-local-hosts on GET → 403. This is not POST refresh
(/cloud-connect-cspm-azure/entities/refresh-certificate/v1). This is
not Create management group.
POST management-group body JSON {tenant_id, default_subscription_id}.
Missing tenant_id or default_subscription_id → 400. Duplicate
tenant_id → 400. Extra unused keys (resources, subscription_id,
…) are ignored; the clone does not emit Azure grant scripts. Clone
success is 200 MSA CspmAzureManagementGroup (not SOURCE 201/207).
POST tenant_id=t-lab-3 / default_subscription_id=sub-lab-3 returns
that management group. cspm-registration:read on POST → 403.
cs-local-hosts on POST → 403. This is not Create account
(/cloud-connect-cspm-azure/entities/account/v1) and not Refresh
certificate. This is not GET /cloud-connect-cspm-azure/entities/management-group/v1
(same path, method GET). This is not Delete management group
(DELETE /cloud-connect-cspm-azure/entities/management-group/v1 query
tenant_ids) and not PATCH default-subscription
(/cloud-connect-cspm-azure/entities/default-subscription-id/v1).
GET management-group extra unused query tenant_ids, limit, offset,
and parameters are ignored. Clone success is JSON MSA 200
CspmAzureManagementGroup (tenant_id, default_subscription_id,
cid). SOURCE JSON array is not the clone envelope. GET returns
t-lab-1 then t-lab-2. cspm-registration:read on GET → 200.
cs-local-hosts on GET → 403. This is not POST/DELETE
management-group (same path), not PATCH default-subscription
(/cloud-connect-cspm-azure/entities/default-subscription-id/v1), and
not GET account (/cloud-connect-cspm-azure/entities/account/v1).
DELETE query ids (empty body). ids is required; missing ids →
400. Unknown subscription id → 400. Extra unused query keys
(tenant_ids, retain_tenant, parameters) are ignored. There is no
tenant_ids / retain_tenant delete this slice. Clone success is 200
empty resources (not SOURCE 201/207). GET ids=sub-lab-3
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 sub-lab-3.
This is not Kubernetes Azure
DELETE /kubernetes-protection/entities/accounts/azure/v1. This is
not Delete management group
(DELETE /cloud-connect-cspm-azure/entities/management-group/v1 query
tenant_ids).
DELETE management-group query tenant_ids (empty body). tenant_ids is
required; missing tenant_ids → 400. Unknown tenant id → 400.
Extra unused query keys (ids, parameters) are ignored. Clone success
is 200 empty resources (not SOURCE 201/207). A second
DELETE of the same tenant → 400. If several tenant_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 t-lab-3 as the happy path; POST
create it first if missing. This is not Azure account
DELETE /cloud-connect-cspm-azure/entities/account/v1 (query ids).
This does not delete Azure account rows. This is not GET
management-group (GET /cloud-connect-cspm-azure/entities/management-group/v1). This is not PATCH default-subscription
(/cloud-connect-cspm-azure/entities/default-subscription-id/v1).
PATCH default-subscription query subscription_id and tenant_id.
Missing subscription_id → 400. Missing tenant_id → 400.
Unknown tenant_id → 404. Extra unused query/body keys
(parameters, tenant-id as unused extra if tenant_id is present)
are ignored. No proto body: "*". Clone success is 200 MSA
CspmAzureManagementGroup (not SOURCE 201). PATCH
subscription_id=sub-lab-1b / tenant_id=t-lab-1 returns that
management group with default_subscription_id sub-lab-1b. Tenant and
cid stay unchanged. cspm-registration:read on PATCH default-subscription
→ 403. cs-local-hosts on PATCH default-subscription → 403.
This is not UpdateAzureAccount
(PATCH /cloud-connect-cspm-azure/entities/account/v1), not
UpdateAzureAccountClientID
(PATCH /cloud-connect-cspm-azure/entities/client-id/v1), not
Create/Delete management group
(/cloud-connect-cspm-azure/entities/management-group/v1), and not
Kubernetes Azure.
Empty tenant_id and subscription_ids on GetAzureUserScriptsAttachment
uses every stored Azure subscription (order subscription_id ASC)
with empty tenant_id. tenant_id=t-lab-1 returns sub-lab-1 and
tenant_id t-lab-1. subscription_ids=sub-lab-1 returns that
subscription and its tenant. Unknown tenant → 400
unknown azure tenant id. Unknown subscription → 400
unknown azure subscription id. Extra unused query keys
(tenant-id, account_type, template, azure_management_group,
parameters) are ignored. note is always
This clone does not emit Azure grant scripts. There is no content
script field. Success is JSON MSA 200, not
application/octet-stream. Distinct from GET account
/cloud-connect-cspm-azure/entities/account/v1, GET download-certificate
/cloud-connect-cspm-azure/entities/download-certificate/v1, Kubernetes
Azure, the Kubernetes Azure install script, and grant-script file
download.
JSON is SOURCE snake_case: subscription_id, tenant_id, status,
account_type, cid. Certificate JSON is SOURCE snake_case:
client_id, end_date, public_certificate, public_certificate_raw,
tenant_id, valid. Management-group JSON is SOURCE snake_case:
tenant_id, default_subscription_id, cid. Scripts JSON is
tenant_id, subscription_ids, note.
This is not Kubernetes, Cloud AWS, Cloud GCP, Kubernetes Azure
create, Kubernetes Azure update, Kubernetes Azure delete, Kubernetes
Azure install script, GET account /entities/account/v1, GET
/download-certificate/v1, or the HelloService template.
Kubernetes uses /kubernetes-protection/entities/kubernetes/clusters/v1:
Kubernetes. CSPM AWS uses
/cloud-connect-cspm-aws/entities/account/v1:
CSPM AWS. CSPM GCP uses
/cloud-connect-cspm-gcp/entities/account/v1:
CSPM GCP. Kubernetes Azure create uses
/kubernetes-protection/entities/accounts/azure/v1:
K8s Azure. Kubernetes Azure install script uses
/kubernetes-protection/entities/user-script/azure/v1:
K8s Azure script. Image assessment policies / remaining cloud and other cloud
collections are not implemented
(not yet).
Seed accounts
subscription_id | tenant_id | status | account_type |
|---|---|---|---|
sub-lab-1 | t-lab-1 | Event_DiscoverAccountStatusOperational | commercial |
sub-lab-2 | t-lab-2 | Event_DiscoverAccountStatusProvisioned | commercial |
cid is cid-local-1. Empty filters return both.
status=Event_DiscoverAccountStatusOperational returns sub-lab-1.
ids=sub-lab-1 returns that row. POST create with sub-lab-3 /
t-lab-3 adds that row with status
Event_DiscoverAccountStatusProvisioned. PATCH sub-lab-1 /
t-lab-1b updates that row's tenant. GET after PATCH is t-lab-1b.
DELETE ids=sub-lab-3 removes
that row. GET after DELETE is empty. sub-lab-3 is not a seed.
DELETE tenant_ids=t-lab-3 removes the management group created for
that tenant. t-lab-3 is not a seed management group.
PATCH subscription_id=sub-lab-1b / tenant_id=t-lab-1 updates the
seed management-group default to sub-lab-1b. Seed default is
sub-lab-1.
GET management-group returns t-lab-1 then t-lab-2 with
default_subscription_id sub-lab-1 then sub-lab-2 and cid
cid-local-1. Extra unused query is ignored.
Empty scripts filters return subscription ids sub-lab-1 and
sub-lab-2 (ASC) with empty tenant_id. tenant_id=t-lab-1 returns
sub-lab-1. subscription_ids=sub-lab-1 returns that subscription
and its tenant.
Seed certificates
| tenant_id | client_id | valid |
|---|---|---|
| t-lab-1 | az-app-lab-1 | true |
| t-lab-2 | az-app-lab-2 | true |
POST tenant_id=t-lab-1 returns that row with a public certificate.
Optional years_valid=1 is the same default.
GET download tenant_id=t-lab-1 returns that stored row without
rotating end_date. PATCH client-id id=az-app-lab-1b /
tenant_id=t-lab-1 updates that row's client_id. GET download after
PATCH is az-app-lab-1b.
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 sub-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/account/v1'
status=Event_DiscoverAccountStatusOperational returns sub-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/account/v1?status=Event_DiscoverAccountStatusOperational'
ids=sub-lab-1 returns that row:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/account/v1?ids=sub-lab-1'
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-azure/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-azure/entities/account/v1'
Image assessment policies / remaining cloud and
other cloud collections are not
implemented (not yet). Kubernetes is a separate collection:
Kubernetes. CSPM AWS is a separate collection:
CSPM AWS. CSPM GCP is a separate collection:
CSPM GCP. Kubernetes Azure create is a
separate collection:
K8s Azure. Kubernetes Azure install script is a
separate collection:
K8s Azure script. This is not the
HelloService template (GET /api/hello).
Create account (cookie)
POST subscription_id=sub-lab-3 / tenant_id=t-lab-3 returns that
account with status Event_DiscoverAccountStatusProvisioned. Success is
200 MSA CspmAzureAccount. This is not Kubernetes Azure create
and does not emit a grant script:
curl -sS -X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"subscription_id":"sub-lab-3","tenant_id":"t-lab-3"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/account/v1'
Duplicate subscription_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 '{"subscription_id":"sub-lab-3","tenant_id":"t-lab-3"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/account/v1'
Missing subscription_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 '{"tenant_id":"t-lab-3"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/account/v1'
Missing tenant_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 '{"subscription_id":"sub-lab-3"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/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 '{"subscription_id":"sub-lab-3","tenant_id":"t-lab-3"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/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 '{"subscription_id":"sub-lab-3","tenant_id":"t-lab-3"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/account/v1'
Image assessment policies / remaining cloud and
other cloud collections are not
implemented (not yet). Kubernetes Azure create is a separate
collection: K8s Azure. Kubernetes Azure
install script is a separate collection:
K8s Azure script. This is
not the HelloService template (GET /api/hello).
Update account (cookie)
PATCH subscription_id=sub-lab-1 / tenant_id=t-lab-1b returns
that account with tenant t-lab-1b. Success is 200 MSA
CspmAzureAccount, not SOURCE 201/207. Extra unused body keys
are ignored. This is not
Kubernetes Azure update
(PATCH /kubernetes-protection/entities/accounts/azure/v1) and not
CreateAzureAccount. GET ids=sub-lab-1 after PATCH is t-lab-1b:
curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"subscription_id":"sub-lab-1","tenant_id":"t-lab-1b"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/account/v1'
Missing subscription_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 '{"tenant_id":"t-lab-1b"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/account/v1'
Missing tenant_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 '{"subscription_id":"sub-lab-1"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/account/v1'
Unknown subscription_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 '{"subscription_id":"sub-unknown","tenant_id":"t-lab-1b"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/account/v1'
Extra unused body keys are ignored (client_id does not change the
client):
curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"subscription_id":"sub-lab-1","tenant_id":"t-lab-1b","client_id":"ignored"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/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 '{"subscription_id":"sub-lab-1","tenant_id":"t-lab-1b"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/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 '{"subscription_id":"sub-lab-1","tenant_id":"t-lab-1b"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/account/v1'
Image assessment policies / remaining cloud and
other cloud collections are not
implemented (not yet). Kubernetes Azure create is a separate
collection: K8s Azure. Kubernetes Azure
install script is a separate collection:
K8s Azure script. This is
not the HelloService template (GET /api/hello).
Update client ID (cookie)
PATCH id=az-app-lab-1b / tenant_id=t-lab-1 returns that
certificate with client_id az-app-lab-1b. Success is 200 MSA
CspmAzureCertificate, not SOURCE 201. Extra unused query/body keys
are ignored. This is not UpdateAzureAccount account PATCH
(PATCH /cloud-connect-cspm-azure/entities/account/v1) and not
Kubernetes Azure. GET download-certificate tenant_id=t-lab-1 after
PATCH is az-app-lab-1b:
curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/client-id/v1?id=az-app-lab-1b&tenant_id=t-lab-1'
Missing id is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/client-id/v1?tenant_id=t-lab-1'
Missing tenant_id is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/client-id/v1?id=az-app-lab-1b'
Unknown tenant_id is 404:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/client-id/v1?id=az-app-lab-1b&tenant_id=not-a-tenant'
Extra unused query keys are ignored (parameters and tenant-id do
not change the client id when tenant_id is present):
curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/client-id/v1?id=az-app-lab-1b&tenant_id=t-lab-1¶meters=ignored&tenant-id=ignored'
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}" \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/client-id/v1?id=az-app-lab-1b&tenant_id=t-lab-1'
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' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/client-id/v1?id=az-app-lab-1b&tenant_id=t-lab-1'
Image assessment policies / remaining cloud and
other cloud collections are not
implemented (not yet). Kubernetes Azure create is a separate
collection: K8s Azure. Kubernetes Azure
install script is a separate collection:
K8s Azure script. This is
not the HelloService template (GET /api/hello).
Refresh certificate (cookie)
POST tenant_id=t-lab-1 returns that tenant with valid true and a
public certificate. Empty body. Success is 200. Optional
years_valid=1 is the same default:
curl -sS -X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/refresh-certificate/v1?tenant_id=t-lab-1'
years_valid=1:
curl -sS -X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/refresh-certificate/v1?tenant_id=t-lab-1&years_valid=1'
Missing tenant_id is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/refresh-certificate/v1'
Unknown tenant is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/refresh-certificate/v1?tenant_id=not-a-tenant'
years_valid=3 is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/refresh-certificate/v1?tenant_id=t-lab-1&years_valid=3'
cspm-registration:read is 403 on POST:
TOKEN='<access_token from a client with cspm-registration:read>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/refresh-certificate/v1?tenant_id=t-lab-1'
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' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/refresh-certificate/v1?tenant_id=t-lab-1'
Image assessment policies / remaining cloud and
other cloud collections are not
implemented (not yet). Kubernetes Azure install script is a separate
collection: K8s Azure script. This is
not the HelloService template (GET /api/hello).
Download certificate (cookie)
GET tenant_id=t-lab-1 returns that tenant with valid true and a
public certificate. Empty body. Success is 200 MSA
CspmAzureCertificate. Extra unused query keys (parameters) are
ignored. This is not Refresh (POST
/cloud-connect-cspm-azure/entities/refresh-certificate/v1). No file
stream:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/download-certificate/v1?tenant_id=t-lab-1'
Missing tenant_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-azure/entities/download-certificate/v1'
Unknown tenant 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-azure/entities/download-certificate/v1?tenant_id=not-a-tenant'
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-azure/entities/download-certificate/v1?tenant_id=t-lab-1'
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-azure/entities/download-certificate/v1?tenant_id=t-lab-1'
Image assessment policies / remaining cloud and
other cloud collections are not
implemented (not yet). Kubernetes Azure install script is a separate
collection: K8s Azure script. This is
not the HelloService template (GET /api/hello).
Download scripts (cookie)
Empty filters return subscription ids sub-lab-1 and sub-lab-2
(ASC), empty tenant_id, and note
This clone does not emit Azure grant scripts. Success is 200 MSA
one CspmAzureScriptAttachment. Extra unused query keys
(tenant-id, account_type, template, azure_management_group,
parameters) are ignored. This is not GET account
(/cloud-connect-cspm-azure/entities/account/v1), not GET
download-certificate
(/cloud-connect-cspm-azure/entities/download-certificate/v1), not
Kubernetes Azure, not the Kubernetes Azure install script, and
not a grant-script file download. The clone does not emit Azure
grant scripts. No file stream:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/user-scripts-download/v1'
tenant_id=t-lab-1 returns sub-lab-1 and tenant t-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/user-scripts-download/v1?tenant_id=t-lab-1'
subscription_ids=sub-lab-1 returns that subscription and its tenant:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/user-scripts-download/v1?subscription_ids=sub-lab-1'
Unknown tenant 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-azure/entities/user-scripts-download/v1?tenant_id=not-a-tenant'
Unknown subscription 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-azure/entities/user-scripts-download/v1?subscription_ids=sub-unknown'
Extra unused query keys are ignored (tenant-id does not change the
metadata):
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/user-scripts-download/v1?tenant-id=ignored&account_type=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-azure/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-azure/entities/user-scripts-download/v1'
Image assessment policies / remaining cloud and
other cloud collections are not
implemented (not yet). Kubernetes Azure is a separate collection:
K8s Azure. Kubernetes Azure install
script is a separate collection:
K8s Azure script. This is
not the HelloService template (GET /api/hello).
Create management group (cookie)
POST tenant_id=t-lab-3 / default_subscription_id=sub-lab-3 returns
that management group. Success is 200 MSA CspmAzureManagementGroup.
This is not Create account, not Refresh certificate, not GET
management-group (same path, method GET), and does not emit a grant
script:
curl -sS -X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"tenant_id":"t-lab-3","default_subscription_id":"sub-lab-3"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/management-group/v1'
Duplicate tenant_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 '{"tenant_id":"t-lab-3","default_subscription_id":"sub-lab-3"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/management-group/v1'
Missing tenant_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 '{"default_subscription_id":"sub-lab-3"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/management-group/v1'
Missing default_subscription_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 '{"tenant_id":"t-lab-3"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/management-group/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 '{"tenant_id":"t-lab-3","default_subscription_id":"sub-lab-3"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/management-group/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 '{"tenant_id":"t-lab-3","default_subscription_id":"sub-lab-3"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/management-group/v1'
Image assessment policies / remaining cloud and
other cloud collections are not
implemented (not yet). Kubernetes Azure install script is a separate
collection: K8s Azure script. This is
not the HelloService template (GET /api/hello).
Delete account (cookie)
DELETE ids=sub-lab-3 returns empty resources. Success is 200.
A later GET ids=sub-lab-3 is empty. A second DELETE of the same id
is 400. This is not Kubernetes Azure
DELETE /kubernetes-protection/entities/accounts/azure/v1. Extra unused
query keys (tenant_ids, retain_tenant, parameters) are ignored.
This is not Delete management group (tenant_ids).
Empty body:
curl -sS -X DELETE -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/account/v1?ids=sub-lab-3'
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-azure/entities/account/v1'
Unknown subscription 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-azure/entities/account/v1?ids=sub-unknown'
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-azure/entities/account/v1?ids=sub-lab-3'
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-azure/entities/account/v1?ids=sub-lab-3'
Image assessment policies / remaining cloud and
other cloud collections are not
implemented (not yet). Kubernetes Azure install script is a separate
collection: K8s Azure script. This is
not the HelloService template (GET /api/hello).
Delete management group (cookie)
DELETE tenant_ids=t-lab-3 returns empty resources. Success is 200.
A second DELETE of the same tenant is 400. This is not Azure
account delete (DELETE /cloud-connect-cspm-azure/entities/account/v1
query ids). Extra unused query keys (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-azure/entities/management-group/v1?tenant_ids=t-lab-3'
Missing tenant_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-azure/entities/management-group/v1'
Unknown tenant 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-azure/entities/management-group/v1?tenant_ids=t-unknown'
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-azure/entities/management-group/v1?tenant_ids=t-lab-3'
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-azure/entities/management-group/v1?tenant_ids=t-lab-3'
Image assessment policies / remaining cloud and
other cloud collections are not
implemented (not yet). Kubernetes Azure install script is a separate
collection: K8s Azure script. This is
not the HelloService template (GET /api/hello).
List management groups (cookie)
Empty filters return seed tenants t-lab-1 then t-lab-2 with
default_subscription_id sub-lab-1 then sub-lab-2 and cid
cid-local-1. Success is 200 MSA CspmAzureManagementGroup. Extra
unused query keys (tenant_ids, limit, offset, parameters) are
ignored. SOURCE JSON array is not the clone envelope. This is
not POST/DELETE management-group (same path), not PATCH
default-subscription-id, and not GET account:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/management-group/v1'
Extra unused query keys are ignored:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/management-group/v1?tenant_ids=ignored&limit=1&offset=0¶meters=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-azure/entities/management-group/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-azure/entities/management-group/v1'
Image assessment policies / remaining cloud and
other cloud collections are not
implemented (not yet). Kubernetes Azure install script is a separate
collection: K8s Azure script. This is
not the HelloService template (GET /api/hello).
Update default subscription (cookie)
PATCH subscription_id=sub-lab-1b / tenant_id=t-lab-1 returns that
management group with default_subscription_id sub-lab-1b. Success is
200 MSA CspmAzureManagementGroup, not SOURCE 201. Extra unused
query/body keys are ignored. Required query subscription_id,
tenant_id. No proto body: "*". This is not UpdateAzureAccount
account PATCH (PATCH /cloud-connect-cspm-azure/entities/account/v1),
not UpdateAzureAccountClientID
(PATCH /cloud-connect-cspm-azure/entities/client-id/v1), not
Create/Delete management group
(/cloud-connect-cspm-azure/entities/management-group/v1), and not
Kubernetes Azure:
curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/default-subscription-id/v1?subscription_id=sub-lab-1b&tenant_id=t-lab-1'
Missing subscription_id is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/default-subscription-id/v1?tenant_id=t-lab-1'
Missing tenant_id is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/default-subscription-id/v1?subscription_id=sub-lab-1b'
Unknown tenant_id is 404:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/default-subscription-id/v1?subscription_id=sub-lab-1b&tenant_id=not-a-tenant'
Extra unused query keys are ignored (parameters and tenant-id do
not change the default when tenant_id is present):
curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/default-subscription-id/v1?subscription_id=sub-lab-1b&tenant_id=t-lab-1¶meters=ignored&tenant-id=ignored'
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}" \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/default-subscription-id/v1?subscription_id=sub-lab-1b&tenant_id=t-lab-1'
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' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/default-subscription-id/v1?subscription_id=sub-lab-1b&tenant_id=t-lab-1'
Image assessment policies / remaining cloud and
other cloud collections are not
implemented (not yet). Kubernetes Azure install script is a separate
collection: K8s Azure script. This is
not the HelloService template (GET /api/hello).
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-azure/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. GetCSPMAzureAccount 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.
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 '{"subscription_id":"sub-lab-3","tenant_id":"t-lab-3"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/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. CreateAzureAccount stays
cspm-registration:write. PEP 8 create_azure_account.
Update (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 '{"subscription_id":"sub-lab-1","tenant_id":"t-lab-1b"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/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. UpdateAzureAccount stays
cspm-registration:write. SOURCE UpdateCSPMAzureAccount. PEP 8
update_azure_account. Distinct from Kubernetes Azure update,
CreateAzureAccount, and PATCH client-id.
Update client ID (Bearer)
TOKEN='<access_token from a client with cspm-registration:write>'
curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/client-id/v1?id=az-app-lab-1b&tenant_id=t-lab-1'
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. UpdateAzureAccountClientID stays
cspm-registration:write. SOURCE UpdateCSPMAzureAccountClientID.
PEP 8 update_azure_account_client_id. Distinct from UpdateAzureAccount
account PATCH, PATCH default-subscription, and Kubernetes Azure.
Refresh (Bearer)
TOKEN='<access_token from a client with cspm-registration:write>'
curl -sS -X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/refresh-certificate/v1?tenant_id=t-lab-1'
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. AzureRefreshCertificate stays
cspm-registration:write. PEP 8 azure_refresh_certificate.
This is not GET download-certificate (cspm-registration:read).
Download (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-azure/entities/download-certificate/v1?tenant_id=t-lab-1'
cspm-registration:read → 200. A token without that scope
(including hosts:read only, e.g. cs-local-hosts) → 403. Missing
or revoked token → 401. AzureDownloadCertificate stays
cspm-registration:read. PEP 8 azure_download_certificate. This is
not Refresh (cspm-registration:write, POST). No file stream.
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-azure/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. GetAzureUserScriptsAttachment stays
cspm-registration:read. PEP 8 get_azure_user_scripts_attachment.
This is not GET account, not GET download-certificate, not
Kubernetes Azure, not the Kubernetes Azure install script, and
not a grant-script file download. No file stream.
There is no seeded production client with cspm-registration:read —
use the console cookie, or a client you created with that scope.
Create management group (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 '{"tenant_id":"t-lab-3","default_subscription_id":"sub-lab-3"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/management-group/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. CreateAzureManagementGroup stays
cspm-registration:write. PEP 8 create_azure_management_group.
This is not Create account, not Refresh certificate, not
Delete management group, and not PATCH default-subscription.
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-azure/entities/account/v1?ids=sub-lab-3'
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. DeleteAzureAccount stays
cspm-registration:write. PEP 8 delete_azure_account.
This is not Delete management group (tenant_ids).
Delete management group (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-azure/entities/management-group/v1?tenant_ids=t-lab-3'
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. DeleteAzureManagementGroup stays
cspm-registration:write. PEP 8 delete_azure_management_group.
This is not Delete account (ids) and not PATCH
default-subscription.
List management groups (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-azure/entities/management-group/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. GetAzureManagementGroup stays
cspm-registration:read. SOURCE GetCSPMAzureManagementGroup. PEP 8
get_azure_management_group. This is not POST/DELETE
management-group, not PATCH default-subscription-id, and not GET
account. SOURCE JSON array is not the clone envelope.
There is no seeded production client with cspm-registration:read —
use the console cookie, or a client you created with that scope.
Update default subscription (Bearer)
TOKEN='<access_token from a client with cspm-registration:write>'
curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/cloud-connect-cspm-azure/entities/default-subscription-id/v1?subscription_id=sub-lab-1b&tenant_id=t-lab-1'
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. UpdateAzureTenantDefaultSubscriptionID stays
cspm-registration:write. SOURCE
UpdateCSPMAzureTenantDefaultSubscriptionID. PEP 8
update_azure_tenant_default_subscription_id. Distinct from
UpdateAzureAccount account PATCH, UpdateAzureAccountClientID, Create/Delete
management group, and Kubernetes Azure. No proto body: "*".
OAuth2 mint/revoke: OAuth2. Accessible scopes: API clients.