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_consolefromCreateSession(POST /identity/entities/sessions/v1) Authorization: Bearerwithfalcon-container-cli:read(GET credentials, HEAD scan inventory) orfalcon-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
| Method | Path | Use |
|---|---|---|
GET | /container-security/entities/image-registry-credentials/v1 | Get credentials. No query params. |
HEAD | /container-security/entities/image-inventory/v1 | Check 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/v1 | Post 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.
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 credentials (cookie)
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).
Check scan inventory (cookie)
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.