View Evidence

There are several ways to view evidence in Artifactory:

  • Select an artifact or build and view a table of evidence files (internal and external) associated with the artifact or build. From the table, you can download evidence files to your local system. For more information, see View the Artifact Evidence Table and View the Build Evidence Table.
  • Select a Release Bundle v2 and view its content graph, which provides a graphical depiction of the evidence files associated with the Release Bundle and the builds and packages it contains. For more information, see View Release Bundle v2 Evidence.
  • The evidence graph and the evidence table in the artifact tree can be used to view the predicate, which contains the actual contents of the evidence file. For more information, see View the Evidence Predicate.
  • You can view a list of evidence-related events associated with a Release Bundle v2 version (such as promotion to an environment) in the version timeline.

View the Artifact Evidence Table

When you select a local repository, virtual repository, or Release Bundle v2 from the repository tree, use the Evidence tab to view a list of external evidence files associated with the Release Bundle and its contents. You can download these files to your local server.

To view the artifact evidence table:

  1. In the Application module, select Artifactory > Artifacts.

  2. Select an artifact from the tree. Details about the artifact are displayed in a series of tabs in the pane to the right of the tree. For more information, see Artifact Information.

  3. Click the Evidence tab to display the evidence table.

    artifact-evidence_provider-logo.png

    The table lists all external evidence files related to the selected artifact.

ColumnDescription
VerifiedA blue checkmark icon indicates the evidence has been verified using the public key created for this purpose. For more information, see Create a Key Pair for Evidence.
Evidence TypeThe type of evidence contained in the file, for example, vulnerability scan, code scan, test result, or commit. An icon representing the evidence provider is displayed next to the name.
TimeThe timestamp that indicates when the evidence file was created.
Created ByThe name of the user who created the evidence file.
Actions menuClick the ellipsis icon at the end of each table row to select options for viewing and downloading evidence.

View the Evidence Contents

To view the contents of the evidence file, select View Evidence from the actions menu.

Figma_evidence-contents-example.png
📘

Note

The platform UI can display a maximum of 3000 lines from the evidence file. If the file is larger than that, you are given the option to download the evidence instead. The maximum size of an evidence file supported by Artifactory is 16MB.

Download Evidence

To download an evidence file from the table, select Download Evidence from the actions menu.

View the Package Evidence Table

When you select a package version from the Packages page, use the Evidence tab to view a list of external evidence files associated with the package. You can download these files to your local server.

To view the package evidence table:

  1. In the Application module, select Artifactory > Packages.

  2. Click the name of a package to display a table of package versions.

  3. Click the relevant version to display the details of that version.

  4. Click the Evidence tab.

  5. Select a repository from the dropdown list above the table.

    packages-evidence_provider-logo.png

    The table lists all external evidence files related to the package version in the selected repository.

ColumnDescription
VerifiedA blue checkmark icon indicates the evidence has been verified using the public key created for this purpose. For more information, see Create a Key Pair for Evidence.
Evidence TypeThe type of evidence contained in the file, for example, vulnerability scan, code scan, test result, or commit. An icon representing the evidence provider is displayed next to the name.
TimeThe timestamp that indicates when the evidence file was created.
Created ByThe name of the user who created the evidence file.
Actions menuClick the ellipsis icon at the end of each row to select options for viewing and downloading evidence.

View the Build Evidence Table

When you select a build version from the Builds page, use the Evidence tab to view a list of external evidence files associated with the build. You can download these files to your local server.

To view the build evidence table:

  1. In the Application module, select Artifactory > Builds.

  2. Click the name of a build to display a table of build versions.

  3. Click the relevant build ID to display the details of that build version.

  4. Click the Evidence tab to display the evidence table.

    build_evidence_table.png

    The table lists all external evidence files related to the selected artifact.

ColumnDescription
VerifiedA blue checkmark icon indicates the evidence has been verified using the public key created for this purpose. For more information, see Create a Key Pair for Evidence.
Evidence TypeThe type of evidence contained in the file, for example, vulnerability scan, code scan, test result, or commit.
TimeThe timestamp that indicates when the evidence file was created.
Created ByThe name of the user who created the evidence file.
Actions menuClick the ellipsis icon at the end of each row to select options for viewing and downloading evidence

View Release Bundle v2 Evidence

When you select a specific Release Bundle v2 version in the platform UI, you can view the evidence associated with that version in two formats:

View the Evidence Predicate

When viewing the evidence graph for a Release Bundle v2 version, click the card for an evidence file to view its predicate, which contains the actual contents of the evidence.

All evidence is available in JSON format. Internal evidence generated by Artifactory (such as Release Bundle v2 promotion reports) and Xray (such as SBOMs and vulnerability reports) is also available in Markdown for easy readability. When both formats are available, the Markdown version (including the evidence provider logo) is shown in the Content tab and the JSON version is shown in the Spec tab.

Tip

The predicate can also be viewed from the Evidence tab in the Artifact tree. For more information, see View the Artifact Evidence Table.

Sample predicates of different types are shown below.

Release Bundle v2 Promotion Predicate

Promoting a Release Bundle v2 version creates internal evidence about the event.

evidence_promotion-contents_spec.png evidence_promotion-contents_markdown_JFroglogo.png

Release Bundle v2 Distribution Predicate

Distributing a Release Bundle v2 version to a target (such as an Edge node) creates internal evidence about the event.

evidence_distribution-predicate-example.png

Xray Scan Results

The following is an example of vulnerability report evidence generated by Xray in Markdown format.

evidence_cyclonedx_content-jfroglogo.png

Test Results

Using the Create Evidence CLI, you can attach external evidence, such as test results performed outside of Artifactory.

test-results_spec-example.png

Tip

Click the down arrow icon to download the evidence file to your local computer.

Evidence from an External Provider

Evidence uploaded from external providers are displayed with the provider logo, as shown in the example below.

Service-Now_evidence_code-review.png