Attach External Evidence

JFrog Artifactory Documentation

Products
JFrog Artifactory
Content Type
User Guide
ft:sourceType
Paligo

Subscription Information

This feature is supported with the Enterprise+ license.

In addition to the evidence that Artifactory and Xray create automatically (for example, when promoting or distributing a Release Bundle v2), you can take external evidence, which attests to processes performed outside of Artifactory, and attach that evidence to an evidence subject (for example, an artifact, package, or build) deployed in Artifactory.

The recommended best practice is to attach evidence to artifacts, packages, or builds until you create a Release Bundle v2 containing those artifacts or builds. At that point, any further evidence related to the artifacts, packages, or builds should be attached directly to the Release Bundle.

One way to attach external evidence is with the Create Evidence JFrog CLI command. This command creates a properly structured payload that conforms to the in-toto attestation framework, wraps it in a DSSE envelope, and then deploys the evidence file to Artifactory. Server-side verification is performed automatically during deployment provided the relevant public key is present in Artifactory. For more information, see Evidence Service.

Alternatively, you can create evidence using a third-party tool and then deploy it to Artifactory with the Deploy Evidence API. When using this method, you must ensure that your evidence file has a payload that conforms to the in-toto attestation framework and an envelope that conforms to the DSSE framework.Deploy Evidence

View External Evidence

There are multiple options for viewing external evidence in Artifactory:

  • External evidence attached to individual artifacts can be viewed in the Evidence tab of the Artifacts tree. For more information, see View the Artifact Evidence Table.

  • External evidence attached to a Release Bundle v2 can be viewed in the timeline for that Release Bundle version.

  • Evidence attached to a specific Release Bundle version and the artifacts contained in the Release Bundle version can be viewed in the Evidence graph. For more information, see View the Release Bundle Evidence Graph.