Docker Scout CLI plugin that signs in to Scout with the host's sbx login.
971
Docker Scout CLI plugin that signs in to Scout with the host's sbx login.
| Name | Required | Default | Description |
|---|---|---|---|
version | Required | — | Docker Scout CLI release carried by the overlay |
[email protected]| Type | Required | Description | |
|---|---|---|---|
com.docker.sandbox/credential@1 | Required | Docker Scout API access through the host's sbx login | |
com.docker.sandbox/network-policy@1 | Required | — | |
com.docker.sandbox/agent-context@1 | Optional | — | |
com.docker.sandbox/agent-context@2 | Optional | — | |
sbx run <agent> --kit sbx/scout-cli:latestRun the following command to install sbx on your machine.
brew install docker/tap/sbxwinget install Docker.sbxThis mixin Kit adds the Docker Scout CLI to a compatible workload and signs it in to
Docker Scout with the login of the host's sbx session. It keeps the workload's launch command.
This Kit is built on Docker Hardened Images.
Add --kit sbx/scout-cli:latest when creating a sandbox with a workload such as
Shell. Inside the sandbox, run docker scout version, docker scout quickview,
or docker scout cves.
The Kit installs Scout as a Docker CLI plugin at /home/agent/.docker/cli-plugins/docker-scout, so docker scout uses
the workload's Docker CLI. A launcher at /home/agent/.local/bin/docker-scout runs the same binary on a workload that
has no Docker CLI.
Log in on the host with sbx login. Inside the sandbox, DOCKER_SCOUT_HUB_TOKEN is a proxy-managed sentinel. The proxy
injects the host's current login token on requests to api.scout.docker.com and api.dso.docker.com. Do not print or
copy the token, and do not run docker login to sign in to Scout. The Kit never puts a real credential in its image
layers.
Runtime access covers those two Scout API hosts only. Scanning an image in a registry also requires network access and
credentials for that registry; configure them separately. Scanning an existing SBOM file with
docker scout cves sbom://<path> needs neither.
See the Sandbox Kit v3 specification, Docker Scout documentation, Docker Sandboxes documentation, and Docker Hardened Images documentation.