Skip to main content

valint_download

valint download

Downloads the evidence based on cache

valint download [TARGET] [flags]

Optional flags

Flags for download subcommand

ShortLongDescriptionDefault
--folder-pathFolder to download the evidences of the given target
-o--formatEvidence format, options=[attest-cyclonedx-json attest-slsa statement-slsa statement-cyclonedx-json statement-generic attest-generic ]
-h--helphelp for download
--payloadpath of the decoded payload
--refEvidence store refrence
--storeSelect evidence store

Global options flags

Flags for all valint subcommands

ShortLongDescriptionDefault
--cache-enableEnable local cachetrue
-c--configConfiguration file path
-C--context-typeCI context type, options=[jenkins github circleci azure gitlab travis tekton bitbucket local admission]
--deliverableMark as deliverable, options=[true, false]
-e--envEnvironment keys to include in evidence
-G--gatePolicy Gate name
-L--labelAdd Custom labels
--levelLog depth level, options=[panic fatal error warning info debug trace]
--log-contextAttach context to all logs
--log-fileOutput log to file
-d--output-directoryOutput directory path"${XDG_CACHE_HOME}/valint"
-O--output-fileOutput file name
-p--pipeline-namePipeline name
--predicate-typeCustom Predicate type (generic evidence format)"http://scribesecurity.com/evidence/generic/v0.1"
-n--product-keyProduct Key
-V--product-versionProduct Version
-q--quietSuppress all logging output
-U--scribe.client-idScribe Client ID (deprecated)
-P--scribe.client-secretScribe Client Token
-D--scribe.disableDisable scribe client
-E--scribe.enableEnable scribe client (deprecated)
-u--scribe.urlScribe API Url"https://api.scribesecurity.com"
-s--showPrint evidence to stdout
--structuredEnable structured logger
--timeoutTimeout duration"120s"
-v--verboseLog verbosity level [-v,--verbose=1] = info, [-vv,--verbose=2] = debug

Examples for running valint download

 valint download <target>
<target> Target object name format=[<image:tag>, <dir path>, <git url>, <file path]

valint download alpine:latest download default (cyclonedxjson) sbom downloads to cache
valint download alpine:latest --format statement download sbom with specified format
valint download alpine:latest --format statement --output-file <path> download sbom with specified format in the specified output file
valint download --ref <ref> download sbom by ref (default storer is cache)
valint download --ref <ref> --store <storer> download sbom by ref and storer
valint download --ref <ref> --store <storer> --output-file <path> download sbom by ref and storer in the specified output directory
valint download alpine:latest --payload <path> download evidence payload in the specified output file.

Format-aliases:
* json=attest-cyclonedx-json
* predicate=predicate-cyclonedx-json
* statement=statement-cyclonedx-json
* attest=attest-cyclonedx-json

Storers:
* cache
* scribe

For example, to retrieve the SBOM from signed evidence:
valint bom alpine:latest -o attest
valint download alpine:latest --payload <path>

For example, to retrieve third-party evidence from unsigned evidence:
valint evidence some_file.json
valint download some_file.json -o statement-generic --payload <path>

SEE ALSO

  • valint - Validate Supply Chain Integrity