delivery_destination.png

Ion Channel allows you to have analyzed files and reports delivered to an S3 bucket of your choice. Grafeas delivery destinations are available for users with an on-premise installation.

When a delivery destination is configured for a Git or Artifact project, all analyses performed by Ion Channel will result in the scanned files,  analysis reports, and any external scan data being delivered if the analysis passes. If an analysis fails, only the reports will be delivered.

Currently, the delivery of scanned files is not supported for S3 and SVN project types. Analysis reports will still be delivered, however.

Your current and formerly configured delivery destinations may be viewed by selecting the Destinations link from the hamburger menuin the top right corner. You will find the name, destination type (S3 or Grafeas), destination location, and the S3 region (if applicable) on this page.

Adding and Archiving Delivery Destinations

The methods available to create a delivery destination depend on the type of destination. S3 delivery destinations can be created via the Delivery Destinations page by clicking the plus icon in the upper-right corner. Creating Grafeas delivery destinations in the UI is not yet supported.

Both Grafeas and S3 delivery destinations can be created via the Ion Connect CLI using the instructions below.

All delivery destination types can be archived in the UI by selecting the trashcan icon located to the delivery destination's right.

Delivery Destination Settings

Below are the definitions for each of the fields required when configuring a delivery destination via the Ion Connect delivery create-destination command (see examples below).

  • team_id - The ID of the team in which this delivery destination will be applied. See How to obtain a Team ID to learn how to get this information.
  • location -
    • S3 - The name of the bucket where the delivery should occur.
    • Grafeas - The URL of the delivery destination.
  • region - The S3 delivery destination region. Leave this blank for a Grafeas delivery destination.
  • name - The name to be used to help you and your organization identify the delivery destination.
  • type - The delivery location type, either S3 or Grafeas.
  • access_key - Your access key for the delivery destination bucket.
  • secret_key - Your secret access key for the delivery destination bucket.

Configuring Delivery Destinations with Ion Connect

Delivery destinations can be configured using the Ion Connect CLI tool with the following commands. For more detailed information regarding the use of Ion Connect for the delivery destination and other commands, please see the Ion Connect Overview.

  • Get JSON skeleton to be used to create a new delivery destination in the next step.
ion-connect delivery create-destination --print
  • Create a new delivery destination.
ion-connect delivery create-destination <path_to_json_file>
  • Remove an existing delivery destination.
ion-connect delivery delete-destination -t <team_id>
  • Get delivery destination details.
ion-connect delivery get-destinations -t <team_id>