trivy

Documentation

Overview

Package trivy provides primitives for working with Trivy.

Index

• Constants
• func GetMirroredImage(image string, mirrors map[string]string) (string, error)
• func GetScoreFromCVSS(CVSSs map[string]*CVSS) *float64
• func NewPlugin(clock ext.Clock, idGenerator ext.IDGenerator) vulnerabilityreport.Plugin
• type CVSS
• type Config
  • func (c Config) GetImageRef() (string, error)
  • func (c Config) GetInsecureRegistries() map[string]bool
  • func (c Config) GetMirrors() map[string]string
  • func (c Config) GetMode() (Mode, error)
  • func (c Config) GetResourceRequirements() (corev1.ResourceRequirements, error)
  • func (c Config) GetServerURL() (string, error)
  • func (c Config) IgnoreFileExists() bool
• type Layer
• type Mode
• type ScanReport
• type ScanResult
• type Vulnerability

Constants

const (
	// Plugin the name of this plugin.
	Plugin = "Trivy"
)

Functions

func GetMirroredImage

func GetMirroredImage(image string, mirrors map[string]string) (string, error)

func GetScoreFromCVSS

func GetScoreFromCVSS(CVSSs map[string]*CVSS) *float64

func NewPlugin

func NewPlugin(clock ext.Clock, idGenerator ext.IDGenerator) vulnerabilityreport.Plugin

NewPlugin constructs a new vulnerabilityreport.Plugin, which is using an upstream Trivy container image to scan Kubernetes workloads.

This Plugin supports both Standalone and ClientServer modes depending on the settings returned by Config.GetMode.

The ClientServer mode is usually more performant, however it requires a Trivy server accessible at the configurable Config.GetServerURL.

Types

type CVSS

type CVSS struct {
	V3Score *float64 `json:"V3Score,omitempty"`
}

type Config

type Config struct {
	starboard.PluginConfig
}

Config defines configuration params for this plugin.

func (Config) GetImageRef

func (c Config) GetImageRef() (string, error)

GetImageRef returns upstream Trivy container image reference.

func (Config) GetInsecureRegistries

func (c Config) GetInsecureRegistries() map[string]bool

func (Config) GetMirrors

func (c Config) GetMirrors() map[string]string

func (Config) GetMode

func (c Config) GetMode() (Mode, error)

func (Config) GetResourceRequirements

func (c Config) GetResourceRequirements() (corev1.ResourceRequirements, error)

GetResourceRequirements creates ResourceRequirements from the Config.

func (Config) GetServerURL

func (c Config) GetServerURL() (string, error)

func (Config) IgnoreFileExists

func (c Config) IgnoreFileExists() bool

type Layer

type Layer struct {
	Digest string `json:"Digest"`
	DiffID string `json:"DiffID"`
}

type Mode

type Mode string

Mode describes mode in which Trivy client operates.

const (
	Standalone   Mode = "Standalone"
	ClientServer Mode = "ClientServer"
)

type ScanReport

type ScanReport struct {
	Results []ScanResult `json:"Results"`
}

type ScanResult

type ScanResult struct {
	Target          string          `json:"Target"`
	Vulnerabilities []Vulnerability `json:"Vulnerabilities"`
}

type Vulnerability

type Vulnerability struct {
	VulnerabilityID  string            `json:"VulnerabilityID"`
	PkgName          string            `json:"PkgName"`
	InstalledVersion string            `json:"InstalledVersion"`
	FixedVersion     string            `json:"FixedVersion"`
	Title            string            `json:"Title"`
	Description      string            `json:"Description"`
	Severity         v1alpha1.Severity `json:"Severity"`
	Layer            Layer             `json:"Layer"`
	PrimaryURL       string            `json:"PrimaryURL"`
	References       []string          `json:"References"`
	Cvss             map[string]*CVSS  `json:"CVSS"`
}