Skip to main content

Registry credentials

Registry credentials is the Falcon Container GetCredentials collection for this CID — GetCredentials, HeadImageScanInventory (SOURCE HeadImageScanInventory, PEP 8 get_scan_headers), and PostImageScanInventory (SOURCE PostImageScanInventory, PEP 8 scan_inventory). The path is GET /container-security/entities/image-registry-credentials/v1. The Check scan inventory path is HEAD /container-security/entities/image-inventory/v1 (distinct from GET credentials, GET reports, SOURCE /image-assessment/entities/image-inventory/v1 (not a clone route), and POST inventory). The Post scan inventory path is POST /container-security/entities/image-inventory/v1 (distinct from HEAD inventory, GET credentials, SOURCE /image-assessment/entities/image-inventory/v1 (not a clone route)). Image assessment policies / remaining cloud are not implemented (not yet). This is not Container registries (/container-security/queries/registries/v1 and /container-security/entities/registries/v1): Container registries. This is not API clients (/api-clients/…): API clients. 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 Container cloud.

RPC field notes: ContainerImagesService. REST schemas: API reference. Registry credentials have no query params and do not use FQL (unlike Container images). Extra unused query keys are ignored. HEAD scan inventory is an empty request. Extra unused query keys are ignored. Clone success is 200 HEAD (empty body allowed). Distinct from GET credentials, GET reports, SOURCE /image-assessment/entities/image-inventory/v1 (not a clone route), and POST inventory. SOURCE /image-assessment/entities/image-inventory/v1 is not a clone route. POST scan inventory uses required JSON host_name. Extra unused keys including agent_uuid and cluster_id are ignored. Clone success is JSON MSA 200 ContainerScanInventory. Distinct from HEAD inventory, GET credentials, SOURCE /image-assessment/entities/image-inventory/v1 (not a clone route). SOURCE /image-assessment/entities/image-inventory/v1 is not a clone route.

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

Auth​

Every call needs a console session or a Bearer token:

  • Cookie cs_console from CreateSession (POST /identity/entities/sessions/v1)
  • Authorization: Bearer with falcon-container-cli:read (GET credentials, HEAD scan inventory) or falcon-container-cli:write (POST scan inventory)

A session cookie bypasses OAuth scopes. Seed client cs-local-hosts (hosts:read only) cannot get credentials, check scan inventory, or post scan inventory (403). Unit tests use a client named cs-local-cimg with falcon-container-image:read; that client cannot get credentials, check scan inventory, or post scan inventory (403). Unit tests use a client named cs-local-cimgw with falcon-container-image:write; that client cannot get credentials, check scan inventory, or post scan inventory (403). Unit tests use a client named cs-local-fcli with falcon-container-cli:read; that client can get credentials and check scan inventory and cannot POST scan inventory (403). Unit tests use a client named cs-local-fcliw with falcon-container-cli:write; that client can post scan inventory and cannot get credentials or check scan inventory (403). GetCredentials and HeadImageScanInventory stay falcon-container-cli:read. PostImageScanInventory stays falcon-container-cli:write. It is not in the production seed. Use the console cookie, or a client you created with that scope. Missing or revoked token → 401.

HTTP paths​

MethodPathUse
GET/container-security/entities/image-registry-credentials/v1Get credentials. No query params.
HEAD/container-security/entities/image-inventory/v1Check scan inventory. RPC HeadImageScanInventory. SOURCE HeadImageScanInventory. PEP 8 get_scan_headers. Empty request. Distinct from GET credentials, GET reports, SOURCE /image-assessment/entities/image-inventory/v1 (not a clone route), POST inventory. Success 200 HEAD. Extra unused keys ignored. falcon-container-cli:read.
POST/container-security/entities/image-inventory/v1Post scan inventory. RPC PostImageScanInventory. SOURCE PostImageScanInventory. PEP 8 scan_inventory. Body JSON {host_name}. Distinct from HEAD inventory, GET credentials, SOURCE /image-assessment/entities/image-inventory/v1 (not a clone route). Success 200 MSA ContainerScanInventory. Extra unused keys ignored. Required host_name. falcon-container-cli:write.

JSON is snake_case MSA: token. HEAD scan inventory may return an empty body; HTTP status 200 is the contract. POST scan inventory is snake_case MSA: id, host_name, status, cid. Clone success is JSON MSA 200 ContainerScanInventory.

This is not Container registries or API clients. Container registries uses /container-security/queries/registries/v1 then /container-security/entities/registries/v1: Container registries. API clients uses /api-clients/…: API clients. QueryExportJobs / remaining Falcon Container / remaining vuln and other cloud collections are not implemented (not yet).

Seed token​

token
lab-registry-token-1

The list returns one resource with that token. There is no filter. HEAD scan inventory does not return the token; success is 200 HEAD. POST host_name=lab-host-1 returns a job with host lab-host-1, status accepted, cid cid-local-1.

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

The list returns the seed token lab-registry-token-1:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/image-registry-credentials/v1'

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/container-security/entities/image-registry-credentials/v1'

cs-local-hosts (hosts:read only) is 403:

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/container-security/entities/image-registry-credentials/v1'

cs-local-cimg (falcon-container-image:read) is 403:

TOKEN='<access_token from cs-local-cimg>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/entities/image-registry-credentials/v1'

Image assessment policies / remaining cloud and other cloud collections are not implemented (not yet). Container registries is a separate collection: Container registries. API clients is a separate collection: API clients. This is not the HelloService template (GET /api/hello).

HEAD /container-security/entities/image-inventory/v1 is an empty request. Success is 200 HEAD. Extra unused query keys are ignored. This is not GET credentials, not GET reports, not SOURCE /image-assessment/entities/image-inventory/v1 (not a clone route), and not POST inventory:

curl -sS -I -X HEAD -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/image-inventory/v1?foo=bar'

No cookie and no Bearer is 401 on HEAD:

curl -sS -o /dev/null -w '%{http_code}\n' \
-I -X HEAD -H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/entities/image-inventory/v1'

cs-local-hosts (hosts:read only) is 403 on HEAD:

TOKEN='<access_token from cs-local-hosts>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-I -X HEAD -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/entities/image-inventory/v1'

cs-local-cimg (falcon-container-image:read) is 403 on HEAD:

TOKEN='<access_token from cs-local-cimg>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-I -X HEAD -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/entities/image-inventory/v1'

cs-local-cimgw (falcon-container-image:write) is 403 on HEAD:

TOKEN='<access_token from cs-local-cimgw>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-I -X HEAD -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/entities/image-inventory/v1'

cs-local-fcliw (falcon-container-cli:write) is 403 on HEAD:

TOKEN='<access_token from cs-local-fcliw>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-I -X HEAD -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/entities/image-inventory/v1'

Image assessment policies / remaining cloud and other cloud collections are not implemented (not yet). Container registries is a separate collection: Container registries. API clients is a separate collection: API clients. This is not the HelloService template (GET /api/hello).

Post scan inventory (cookie)​

POST host_name=lab-host-1 on /entities/image-inventory/v1 returns a job with host lab-host-1, status accepted, cid cid-local-1. Success is 200 MSA ContainerScanInventory. This is not HEAD inventory, not GET credentials, and not SOURCE /image-assessment/entities/image-inventory/v1 (not a clone route). Extra unused body keys including agent_uuid and cluster_id are ignored:

curl -sS -X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"host_name":"lab-host-1","agent_uuid":"x","cluster_id":"y"}' \
'http://127.0.0.1:8088/container-security/entities/image-inventory/v1'

Missing host_name 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 '{}' \
'http://127.0.0.1:8088/container-security/entities/image-inventory/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 '{"host_name":"lab-host-1"}' \
'http://127.0.0.1:8088/container-security/entities/image-inventory/v1'

cs-local-fcli (falcon-container-cli:read) is 403 on POST:

TOKEN='<access_token from cs-local-fcli>'
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 '{"host_name":"lab-host-1"}' \
'http://127.0.0.1:8088/container-security/entities/image-inventory/v1'

cs-local-cimg (falcon-container-image:read) is 403 on POST:

TOKEN='<access_token from cs-local-cimg>'
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 '{"host_name":"lab-host-1"}' \
'http://127.0.0.1:8088/container-security/entities/image-inventory/v1'

cs-local-cimgw (falcon-container-image:write) is 403 on POST:

TOKEN='<access_token from cs-local-cimgw>'
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 '{"host_name":"lab-host-1"}' \
'http://127.0.0.1:8088/container-security/entities/image-inventory/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 '{"host_name":"lab-host-1"}' \
'http://127.0.0.1:8088/container-security/entities/image-inventory/v1'

Image assessment policies / remaining cloud and other cloud collections are not implemented (not yet). Container registries is a separate collection: Container registries. API clients is a separate collection: API clients. This is not the HelloService template (GET /api/hello).

List (Bearer)​

TOKEN='<access_token from a client with falcon-container-cli:read>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/entities/image-registry-credentials/v1'

falcon-container-cli:read → 200 (including unit-test client cs-local-fcli). A token without that scope (including hosts:read only, e.g. cs-local-hosts, falcon-container-image:read, e.g. cs-local-cimg, or write-only falcon-container-cli:write, e.g. cs-local-fcliw) → 403. Missing or revoked token → 401. There is no seeded production client with falcon-container-cli:read — use the console cookie, or a client you created with that scope.

Check scan inventory (Bearer)​

TOKEN='<access_token from a client with falcon-container-cli:read>'
curl -sS -I -X HEAD -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/entities/image-inventory/v1'

falcon-container-cli:read → 200 HEAD (including unit-test client cs-local-fcli). A token without that scope (including hosts:read only, e.g. cs-local-hosts, falcon-container-image:read, e.g. cs-local-cimg, write-only falcon-container-image:write, e.g. cs-local-cimgw, or write-only falcon-container-cli:write, e.g. cs-local-fcliw) → 403. Missing or revoked token → 401. There is no seeded production client with falcon-container-cli:read — use the console cookie, or a client you created with that scope. HeadImageScanInventory stays falcon-container-cli:read. SOURCE HeadImageScanInventory. PEP 8 get_scan_headers. Distinct from GET credentials, GET reports, SOURCE /image-assessment/entities/image-inventory/v1 (not a clone route), and POST inventory. Extra unused keys ignored. Empty request. Success 200 HEAD.

Post scan inventory (Bearer)​

TOKEN='<access_token from a client with falcon-container-cli:write>'
curl -sS -X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"host_name":"lab-host-1"}' \
'http://127.0.0.1:8088/container-security/entities/image-inventory/v1'

falcon-container-cli:write → 200 on POST (including unit-test client cs-local-fcliw). A token without that scope (including hosts:read only, e.g. cs-local-hosts, falcon-container-cli:read, e.g. cs-local-fcli, falcon-container-image:read, e.g. cs-local-cimg, or write-only falcon-container-image:write, e.g. cs-local-cimgw) → 403. Missing or revoked token → 401. There is no seeded production client with falcon-container-cli:write — use the console cookie, or a client you created with that scope. PostImageScanInventory stays falcon-container-cli:write. SOURCE PostImageScanInventory. PEP 8 scan_inventory. Distinct from HEAD inventory, GET credentials, SOURCE /image-assessment/entities/image-inventory/v1 (not a clone route). Extra unused keys ignored. Required host_name. Success 200 MSA ContainerScanInventory.

OAuth2 mint/revoke: OAuth2. Accessible scopes: API clients.