feat(api): add vulnerabilities service

Signed-off-by: Salim Afiune Maya <[email protected]>

Author: afiune

api/api.go

@@ -26,6 +26,11 @@ const (
 	apiIntegrationByGUID  = "external/integrations/%s"
 	apiIntegrationSchema  = "external/integrations/schema/%s"
 	apiTokens             = "access/tokens"
+
+	apiVulnerabilitiesScan             = "external/vulnerabilities/container/repository/images/scan"
+	apiVulnerabilitiesScanStatus       = "external/vulnerabilities/container/reqId/%s"
+	apiVulnerabilitiesReportFromID     = "external/vulnerabilities/container/imageId/%s"
+	apiVulnerabilitiesReportFromDigest = "external/vulnerabilities/container/imageDigest/%s"
 )
 
 // WithApiV2 configures the client to use the API version 2 (/api/v2)

api/client.go

@@ -42,7 +42,8 @@ type Client struct {
 	c          *http.Client
 	log        *zap.Logger
 
-	Integrations *IntegrationsService
+	Integrations    *IntegrationsService
+	Vulnerabilities *VulnerabilitiesService
 }
 
 type Option interface {
@@ -84,6 +85,7 @@ func NewClient(account string, opts ...Option) (*Client, error) {
 		c: &http.Client{Timeout: defaultTimeout},
 	}
 	c.Integrations = &IntegrationsService{c}
+	c.Vulnerabilities = &VulnerabilitiesService{c}
 
 	// init logger, this could change if a user calls api.WithLogLevel()
 	c.initLogger()

api/http.go

@@ -134,6 +134,16 @@ func (c *Client) RequestDecoder(method, path string, body io.Reader, v interface
 	return err
 }
 
+// RequestEncoderDecoder leverages RequestDecoder and performs an http request that first
+// encodes the provider 'data' as a JSON Reader and passes it as the body to the request
+func (c *Client) RequestEncoderDecoder(method, path string, data, v interface{}) error {
+	body, err := jsonReader(data)
+	if err != nil {
+		return err
+	}
+	return c.RequestDecoder(method, path, body, v)
+}
+
 // Do calls request.Do() directly
 func (c *Client) Do(req *http.Request) (*http.Response, error) {
 	response, err := c.c.Do(req)

api/integrations.go

@@ -20,7 +20,6 @@ package api
 
 import (
 	"fmt"
-	"strings"
 )
 
 // IntegrationsService is a service that interacts with the integrations
@@ -173,24 +172,45 @@ type commonIntegrationData struct {
 	TypeName             string `json:"TYPE_NAME,omitempty"`
 }
 
+func (iData commonIntegrationData) Status() string {
+	if iData.Enabled == 1 {
+		return "Enabled"
+	}
+	return "Disabled"
+}
+
 type state struct {
 	Ok                 bool   `json:"ok"`
 	LastUpdatedTime    string `json:"lastUpdatedTime"`
 	LastSuccessfulTime string `json:"lastSuccessfulTime"`
 }
 
+func (s state) String() string {
+	if s.Ok {
+		return "Ok"
+	}
+	return "Check"
+
+}
+
 type IntegrationsResponse struct {
 	Data    []commonIntegrationData `json:"data"`
 	Ok      bool                    `json:"ok"`
 	Message string                  `json:"message"`
 }
 
-func (integrations *IntegrationsResponse) String() string {
-	out := []string{}
-	for _, integration := range integrations.Data {
-		out = append(out, fmt.Sprintf("%s %s", integration.IntgGuid, integration.Type))
+func (integrations *IntegrationsResponse) Table() [][]string {
+	out := [][]string{}
+	for _, idata := range integrations.Data {
+		out = append(out, []string{
+			idata.IntgGuid,
+			idata.Name,
+			idata.Type,
+			idata.Status(),
+			idata.State.String(),
+		})
 	}
-	return strings.Join(out, "\n")
+	return out
 }
 
 type RawIntegration struct {

api/logging.go

@@ -133,5 +133,5 @@ func (c *Client) initLoggerWithWriter(w io.Writer) {
 
 // debugMode returns true if the client is configured to display debug level logs
 func (c *Client) debugMode() bool {
-	return c.logLevel == "debug"
+	return c.logLevel == "DEBUG"
 }

api/vulnerabilities.go

@@ -0,0 +1,250 @@
+//
+// Author:: Salim Afiune Maya (<[email protected]>)
+// Copyright:: Copyright 2020, Lacework Inc.
+// License:: Apache License, Version 2.0
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+package api
+
+import (
+	"fmt"
+	"strings"
+)
+
+// VulnerabilitiesService is a service that interacts with the vulnerabilities
+// endpoints from the Lacework Server
+type VulnerabilitiesService struct {
+	client *Client
+}
+
+// Scan triggers a vulnerability scan to the provider registry, repository, and
+// tag provided. This function calls the underlaying API endpoint that assumes
+// that the container repository has been already integrated with the platform.
+func (svc *VulnerabilitiesService) Scan(registry, repository, tagOrHash string) (
+	response vulScanResponse,
+	err error,
+) {
+	err = svc.client.RequestEncoderDecoder("POST",
+		apiVulnerabilitiesScan,
+		vulScanRequest{registry, repository, tagOrHash},
+		&response,
+	)
+	return
+}
+
+type vulScanRequest struct {
+	Registry   string `json:"registry"`
+	Repository string `json:"repository"`
+	Tag        string `json:"tag"`
+}
+
+type vulScanResponse struct {
+	Data struct {
+		Status    string `json:"status"`
+		RequestID string `json:"requestId"`
+	} `json:"data"`
+	Ok      bool   `json:"ok"`
+	Message string `json:"message"`
+}
+
+func (svc *VulnerabilitiesService) ScanStatus(requestID string) (
+	response vulScanStatusResponse,
+	err error,
+) {
+	apiPath := fmt.Sprintf(apiVulnerabilitiesScanStatus, requestID)
+	err = svc.client.RequestDecoder("GET", apiPath, nil, &response)
+	return
+}
+
+type vulScanStatusResponse struct {
+	Data    VulContainerReport `json:"data"`
+	Ok      bool               `json:"ok"`
+	Message string             `json:"message"`
+}
+
+func (scan *vulScanStatusResponse) CheckStatus() string {
+	if !scan.Ok {
+		return fmt.Sprintf("there is a problem with the vulnerability scan: %s", scan.Message)
+	}
+
+	if scan.Data.Status != "" {
+		// @afiune as far as I can see, the three status we could have are:
+		// * Scanning
+		// * Failed
+		// * NotFound
+		//
+		// Where is "Success"? Not here. Why?
+		return scan.Data.Status
+	}
+
+	// If the scan is not running, that means, it completed running, now the
+	// status of the scan changes to be stored in "ScanStatus" :sadpanda:
+	if scan.Data.ScanStatus != "" {
+		return scan.Data.ScanStatus
+	}
+
+	return "Unknown"
+}
+
+func (svc *VulnerabilitiesService) ReportFromID(imageID string) (
+	response VulContainerReportResponse,
+	err error,
+) {
+	apiPath := fmt.Sprintf(apiVulnerabilitiesReportFromID, imageID)
+	err = svc.client.RequestDecoder("GET", apiPath, nil, &response)
+	return
+}
+
+func (svc *VulnerabilitiesService) ReportFromDigest(imageDigest string) (
+	response VulContainerReportResponse,
+	err error,
+) {
+	apiPath := fmt.Sprintf(apiVulnerabilitiesReportFromDigest, imageDigest)
+	err = svc.client.RequestDecoder("GET", apiPath, nil, &response)
+	return
+}
+
+type VulContainerReportResponse struct {
+	Data    VulContainerReport `json:"data"`
+	Ok      bool               `json:"ok"`
+	Message string             `json:"message"`
+}
+
+func (res *VulContainerReportResponse) CheckStatus() string {
+	if !res.Ok {
+		return fmt.Sprintf("there is a problem with the vulnerability report: %s", res.Message)
+	}
+
+	if res.Data.ScanStatus != "" {
+		return res.Data.ScanStatus
+	}
+
+	if res.Data.Status != "" {
+		return res.Data.Status
+	}
+
+	return "Unknown"
+}
+
+type VulContainerReport struct {
+	TotalVulnerabilities    int32             `json:"total_vulnerabilities"`
+	CriticalVulnerabilities int32             `json:"critical_vulnerabilities"`
+	HighVulnerabilities     int32             `json:"high_vulnerabilities"`
+	MediumVulnerabilities   int32             `json:"medium_vulnerabilities"`
+	LowVulnerabilities      int32             `json:"low_vulnerabilities"`
+	InfoVulnerabilities     int32             `json:"info_vulnerabilities"`
+	FixableVulnerabilities  int32             `json:"fixable_vulnerabilities"`
+	LastEvaluationTime      string            `json:"last_evaluation_time"`
+	Image                   vulContainerImage `json:"image"`
+
+	// @afiune these two parameters, Status and Message will appear when
+	// the vulnerability scan is still running. ugh. why?
+	Status  string `json:"status,omitempty"`
+	Message string `json:"message,omitempty"`
+
+	// ScanStatus is a property that will appear when the vulnerability scan finished
+	// running, this status indicates whether the scan finished successfully or not
+	ScanStatus string `json:"scan_status"`
+
+	// @afiune why we can't parse the time?
+	//LastEvaluationTime      time.Time         `json:"last_evaluation_time"`
+}
+
+func (report *VulContainerReport) VulCountsTable() [][]string {
+	return [][]string{
+		[]string{"Critical", fmt.Sprint(report.CriticalVulnerabilities)},
+		[]string{"Fixable", fmt.Sprint(report.FixableVulnerabilities)},
+		[]string{"High", fmt.Sprint(report.HighVulnerabilities)},
+		[]string{"Medium", fmt.Sprint(report.MediumVulnerabilities)},
+		[]string{"Low", fmt.Sprint(report.LowVulnerabilities)},
+		[]string{"Info", fmt.Sprint(report.InfoVulnerabilities)},
+		[]string{"Total", fmt.Sprint(report.TotalVulnerabilities)},
+	}
+}
+
+type vulContainerImage struct {
+	ImageInfo   vulContainerImageInfo    `json:"image_info"`
+	ImageLayers []vulContainerImageLayer `json:"image_layers"`
+}
+
+func (image *vulContainerImage) Table() [][]string {
+	info := image.ImageInfo
+	return [][]string{
+		[]string{"ID", info.ImageID},
+		[]string{"Digest", info.ImageDigest},
+		[]string{"Registry", info.Registry},
+		[]string{"Repository", info.Repository},
+		[]string{"Size", ByteCountBinary(info.Size)},
+		[]string{"Created At", info.CreatedTime},
+		[]string{"Tags", strings.Join(info.Tags, ",")},
+	}
+}
+
+func ByteCountBinary(b int64) string {
+	const unit = 1024
+	if b < unit {
+		return fmt.Sprintf("%d B", b)
+	}
+	div, exp := int64(unit), 0
+	for n := b / unit; n >= unit; n /= unit {
+		div *= unit
+		exp++
+	}
+	return fmt.Sprintf("%.1f %cB", float64(b)/float64(div), "KMGTPE"[exp])
+}
+
+type vulContainerImageInfo struct {
+	ImageDigest string   `json:"image_digest"`
+	ImageID     string   `json:"image_id"`
+	Registry    string   `json:"registry"`
+	Repository  string   `json:"repository"`
+	CreatedTime string   `json:"created_time"`
+	Size        int64    `json:"size"`
+	Tags        []string `json:"tags"`
+}
+
+type vulContainerImageLayer struct {
+	Hash      string                `json:"hash"`
+	CreatedBy string                `json:"created_by"`
+	Packages  []vulContainerPackage `json:"packages"`
+}
+
+type vulContainerPackage struct {
+	Name            string                   `json:"name"`
+	Namespace       string                   `json:"namescape"`
+	Version         string                   `json:"version"`
+	Vulnerabilities []containerVulnerability `json:"vulnerabilities"`
+
+	// @afiune maybe these fields are host related information and not container
+	FixAvailable  string `json:"fix_available"`
+	FixedVersion  string `json:"fixed_version"`
+	HostCount     string `json:"host_count"`
+	Severity      string `json:"severity"`
+	Status        string `json:"status"`
+	CveLink       string `json:"cve_link"`
+	CveScore      string `json:"cve_score"`
+	CvssV3Score   string `json:"cvss_v3_score"`
+	CvssV2Score   string `json:"cvss_v2_score"`
+	FirstSeenTime string `json:"first_seen_time"`
+}
+
+type containerVulnerability struct {
+	Name        string                 `json:"name"`
+	Description string                 `json:"description"`
+	Severity    string                 `json:"severity"`
+	Link        string                 `json:"link"`
+	FixVersion  string                 `json:"fix_version"`
+	Metadata    map[string]interface{} `json:"metadata"`
+}