package policy import ( "context" "encoding/json" "fmt" "os" "path/filepath" "time" "github.com/aquasecurity/trivy/pkg/oci" "github.com/open-policy-agent/opa/bundle" "golang.org/x/xerrors" "k8s.io/utils/clock" "github.com/aquasecurity/trivy/pkg/log" ) const ( bundleVersion = 1 bundleRepository = "ghcr.io/aquasecurity/appshield" policyMediaType = "application/vnd.cncf.openpolicyagent.layer.v1.tar+gzip" updateInterval = 24 * time.Hour ) type options struct { artifact *oci.Artifact clock clock.Clock } // Option is a functional option type Option func(*options) // WithOCIArtifact takes an OCI artifact func WithOCIArtifact(art *oci.Artifact) Option { return func(opts *options) { opts.artifact = art } } // WithClock takes a clock func WithClock(clock clock.Clock) Option { return func(opts *options) { opts.clock = clock } } // Metadata holds default policy metadata type Metadata struct { Digest string DownloadedAt time.Time } // Client implements policy operations type Client struct { *options policyDir string quiet bool } // NewClient is the factory method for policy client func NewClient(cacheDir string, quiet bool, opts ...Option) (*Client, error) { o := &options{ clock: clock.RealClock{}, } for _, opt := range opts { opt(o) } return &Client{ options: o, policyDir: filepath.Join(cacheDir, "policy"), quiet: quiet, }, nil } // LoadBuiltinPolicies loads default policies func (c *Client) LoadBuiltinPolicies() ([]string, error) { f, err := os.Open(c.manifestPath()) if err != nil { return nil, xerrors.Errorf("manifest file open error (%s): %w", c.manifestPath(), err) } var manifest bundle.Manifest if err = json.NewDecoder(f).Decode(&manifest); err != nil { return nil, xerrors.Errorf("json decode error (%s): %w", c.manifestPath(), err) } // If the "roots" field is not included in the manifest it defaults to [""] // which means that ALL data and policy must come from the bundle. if manifest.Roots == nil || len(*manifest.Roots) == 0 { return []string{c.contentDir()}, nil } var policyPaths []string for _, root := range *manifest.Roots { policyPaths = append(policyPaths, filepath.Join(c.contentDir(), root)) } return policyPaths, nil } // NeedsUpdate returns if the default policy should be updated func (c *Client) NeedsUpdate() (bool, error) { f, err := os.Open(c.metadataPath()) if err != nil { log.Logger.Debugf("Failed to open the policy metadata: %s", err) return true, nil } var meta Metadata if err = json.NewDecoder(f).Decode(&meta); err != nil { log.Logger.Warnf("Policy metadata decode error: %s", err) return true, nil } // No need to update if it's been within a day since the last update. if c.clock.Now().Before(meta.DownloadedAt.Add(updateInterval)) { return false, nil } if err = c.populateOCIArtifact(); err != nil { return false, xerrors.Errorf("OPA bundle error: %w", err) } digest, err := c.artifact.Digest() if err != nil { return false, xerrors.Errorf("digest error: %w", err) } if meta.Digest != digest { return true, nil } // Update DownloadedAt with the current time. // Otherwise, if there are no updates in the remote registry, // the digest will be fetched every time even after this. if err = c.updateMetadata(meta.Digest, time.Now()); err != nil { return false, xerrors.Errorf("unable to update the policy metadata: %w", err) } return false, nil } func (c *Client) populateOCIArtifact() error { if c.artifact == nil { repo := fmt.Sprintf("%s:%d", bundleRepository, bundleVersion) art, err := oci.NewArtifact(repo, policyMediaType, c.quiet) if err != nil { return xerrors.Errorf("OCI artifact error: %w", err) } c.artifact = art } return nil } // DownloadBuiltinPolicies download default policies from GitHub Pages func (c *Client) DownloadBuiltinPolicies(ctx context.Context) error { if err := c.populateOCIArtifact(); err != nil { return xerrors.Errorf("OPA bundle error: %w", err) } dst := c.contentDir() if err := c.artifact.Download(ctx, dst); err != nil { return xerrors.Errorf("download error: %w", err) } digest, err := c.artifact.Digest() if err != nil { return xerrors.Errorf("digest error: %w", err) } log.Logger.Debugf("Digest of the built-in policies: %s", digest) // Update metadata.json with the new digest and the current date if err = c.updateMetadata(digest, c.clock.Now()); err != nil { return xerrors.Errorf("unable to update the policy metadata: %w", err) } return nil } func (c *Client) updateMetadata(digest string, now time.Time) error { f, err := os.Create(c.metadataPath()) if err != nil { return xerrors.Errorf("failed to open a policy manifest: %w", err) } defer f.Close() meta := Metadata{ Digest: digest, DownloadedAt: now, } if err = json.NewEncoder(f).Encode(meta); err != nil { return xerrors.Errorf("json encode error: %w", err) } return nil } func (c *Client) contentDir() string { return filepath.Join(c.policyDir, "content") } func (c *Client) metadataPath() string { return filepath.Join(c.policyDir, "metadata.json") } func (c *Client) manifestPath() string { return filepath.Join(c.contentDir(), bundle.ManifestExt) }