Cx1ClientGo

package module
v0.0.82 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 9, 2024 License: GPL-3.0 Imports: 19 Imported by: 9

README

This is a basic CheckmarxOne REST API client written in GoLang. It already covers much of the CheckmarxOne API allowing Read operations on Applications, Clients, Groups, Presets, Projects, Queries, Reports, Results, Roles, Scans, and Users. Many of these include full CRUD support but this is still a work in progress.

Feel free to use or modify this code, open issues, or submit pull requests. Please submit pull requests against the Dev branch - I will try to keep the main branch clean with only tagged versions. Since this code is changing regularly, consider using a specific tag of Cx1ClientGo until you can test against a newer release.

Basic usage:

package main

import (
	"github.com/cxpsemea/Cx1ClientGo"
	log "github.com/sirupsen/logrus"
	"os"
    "net/http"
)

func main() {
	logger := log.New()
	logger.Info( "Starting" )

	base_url := os.Args[1]
	iam_url := os.Args[2]
	tenant := os.Args[3]
	api_key := os.Args[4]

	cx1client, err := Cx1ClientGo.NewAPIKeyClient( &http.Client{}, base_url, iam_url, tenant, api_key, logger )
	if err != nil {
		log.Error( "Error creating client: " + err.Error() )
		return 
	}

	// no err means that the client is initialized
	logger.Info( "Client initialized: " + cx1client.ToString() )
}

More complete workflow example:

package main

import (
	"github.com/cxpsemea/Cx1ClientGo"
	log "github.com/sirupsen/logrus"
	"os"
	"time"
	"net/http"
	"net/url"
	"crypto/tls"
)

func main() {
	logger := log.New()
	logger.Info( "Starting" )
	//logger.SetLevel( log.TraceLevel ) 

	base_url := os.Args[1]
	iam_url := os.Args[2]
	tenant := os.Args[3]
	api_key := os.Args[4]
	project_name := os.Args[5]
	group_name := os.Args[6]
	project_repo := os.Args[7]
	branch_name := os.Args[8]
	
	proxyURL, err := url.Parse( "http://127.0.0.1:8080" )
	transport := &http.Transport{}
	transport.Proxy = http.ProxyURL(proxyURL)
	transport.TLSClientConfig = &tls.Config{ InsecureSkipVerify: true, }
	
	httpClient := &http.Client{}
	//httpClient.Transport = transport
	
	
	cx1client, err := Cx1ClientGo.NewAPIKeyClient( httpClient, base_url, iam_url, tenant, api_key, logger )
	if err != nil {
		log.Error( "Error creating client: " + err.Error() )
		return 
	}

	// no err means that the client is initialized
	logger.Info( "Client initialized: " + cx1client.ToString() )
	
	group, err := cx1client.GetGroupByName( group_name )
	if err != nil {
		if err.Error() != "No matching group found" {
			logger.Infof( "Failed to retrieve group named %s: %v", group_name, err )
			return
		}
		
		logger.Infof( "No group named %s exists - it will now be created", group_name )
		group, err = cx1client.CreateGroup( group_name )
		if err != nil {
			logger.Errorf( "Failed to create group %s: %v", group_name, err )
			return
		}
		
		logger.Infof( "Created group named '%v' with ID %v", group.Name, group.GroupID )
	} else {	
		logger.Infof( "Found group named %v with ID %v", group.Name, group.GroupID )
	}
	
	projects, err := cx1client.GetProjectsByNameAndGroup( project_name, group.GroupID )
	if err != nil {
		logger.Errorf( "Failed to retrieve project named %s: %v", project_name, err )
		return
	}	
	
	var project Cx1ClientGo.Project
	if len(projects) == 0 {
		logger.Infof( "No project named %s found under group %s - it will now be created", project_name, group_name )
		project, err = cx1client.CreateProject( project_name, group.GroupID, map[string]string{ "CreatedBy" : "Cx1ClientGo" } )
		if err != nil {
			logger.Errorf( "Failed to create project %s: %v", project_name, err )
			return
		}
		logger.Infof( "Created project named '%v' with ID %v", project.Name, project.ProjectID )
	} else {
		project = projects[0]
		logger.Infof( "First project matching '%v' in group '%v' is named '%v' with ID %v", project_name, group_name, project.Name, project.ProjectID )
	}
	
	scanConfig := Cx1ClientGo.ScanConfiguration{}
	scanConfig.ScanType = "sast"
	scanConfig.Values = map[string]string{ "incremental" : "false" }
	
	scan, err := cx1client.ScanProjectGitByID( project.ProjectID, project_repo, branch_name, []Cx1ClientGo.ScanConfiguration{scanConfig}, map[string]string{ "CreatedBy" : "Cx1ClientGo" } )
	
	if err != nil {
		logger.Errorf( "Failed to trigger scan with repository '%v' branch '%v': %s", project_repo, branch_name, err )
		return
	}
	
	logger.Infof( "Triggered scan %v, polling status", scan.ScanID )
	for scan.Status == "Running" {
		time.Sleep( 10 * time.Second )
		scan, err = cx1client.GetScanByID( scan.ScanID )
		if err != nil {
			logger.Errorf( "Failed to get scan status: %v", err )
			return
		}
		logger.Infof( " - %v", scan.Status )
	}
	
	reportID, err := cx1client.RequestNewReportByID( scan.ScanID, project.ProjectID, branch_name, "pdf" )
	if err != nil {
		logger.Errorf( "Failed to trigger new report generation for scan ID %v, project ID %v: %s", scan.ScanID, project.ProjectID, err )
		return
	}
	
	logger.Infof( "Generating report %v, polling status", reportID )
	var status Cx1ClientGo.ReportStatus
	
	for status.Status != "completed" {
		time.Sleep( 10 * time.Second )
		status, err = cx1client.GetReportStatusByID( reportID )
		if err != nil {
			logger.Errorf( "Failed to get report status: %v", err )
			return
		}
		
		logger.Infof( " - %v", status.Status )
	}
	
	logger.Infof( "Downloading report from %v", status.ReportURL )
	reportData, err := cx1client.DownloadReport( status.ReportURL )
	if err != nil {
		logger.Errorf( "Failed to download report: %s", err )
		return
	}
	
	err = os.WriteFile( "report.pdf", reportData, 0o700 )
	if err != nil {
		logger.Errorf( "Failed to Update report: %s", err )
		return
	}
	logger.Info( "Report Updated to report.pdf" )
	
	scanresults, err := cx1client.GetScanResultsByID( scan.ScanID )
	if err != nil && len(scanresults) == 0 {
		logger.Errorf( "Failed to retrieve scan results: %s", err )
		return
	}
	
	if err != nil {
		logger.Infof( "Results retrieved but error thrown: %s", err ) // can be "remote error: tls: user canceled" but still returns results
	} else {
		logger.Infof( "%d results retrieved", len(scanresults) )
	}
	
	for _, result := range scanresults {
		logger.Infof( "Finding with similarity ID: %v", result.SimilarityID )
	}
}

Invocation for the more complicated example: go run . "https://eu.ast.checkmarx.net" "https://eu.iam.checkmarx.net" "tenant" "API Key" "Project Name" "Group Name" "https://my.github/project/repo" "branch"

Current API coverage:

Cx1: Delete /api/applications/%v
Cx1: Delete /api/presets/%d
Cx1: Delete /api/projects/%v
Cx1: Get /api/applications?%v
Cx1: Get /api/applications?%v
Cx1: Get /api/applications?%v
Cx1: Get /api/applications?%v
Cx1: Get /api/configuration/project?%v
Cx1: Get /api/presets/%d
Cx1: Get /api/presets/queries
Cx1: Get /api/projects/
Cx1: Get /api/projects/%v
Cx1: Get /api/projects/?%v
Cx1: Get /api/projects/?%v
Cx1: Get /api/projects?%v
Cx1: Get /api/projects?%v
Cx1: Get /api/projects?%v
Cx1: Get /api/queries/%d
Cx1: Get /api/queries/presets
Cx1: Get /api/reports/%v
Cx1: Get /api/results/?%v
Cx1: Get /api/results/?%v
Cx1: Get /api/sast-metadata/%v
Cx1: Get /api/sast-results-predicates/%d?project-ids=%v
Cx1: Get /api/scans/%v
Cx1: Get /api/scans?%v
Cx1: Get /api/scans?%v
Cx1: Get /api/scan-summary/?%v
Cx1: Patch /api/configuration/project?%v
Cx1: Post /api/applications
Cx1: Post /api/presets
Cx1: Post /api/projects
Cx1: Post /api/reports
Cx1: Post /api/sast-results-predicates
Cx1: Post /api/scans
Cx1: Post /api/uploads
Cx1: Put /api/applications/%v
Cx1: Put /api/presets/%d
Cx1: Put /api/projects/%v
IAM: Delete /auth/admin/tenant/groups/%v
IAM: Delete /auth/admin/tenant/groups/%v/role-mappings/clients/%v
IAM: Delete /auth/admin/tenant/roles-by-id/%v
IAM: Delete /auth/admin/tenant/roles-by-id/%v/composites
IAM: Delete /auth/admin/tenant/users/%v
IAM: Delete /auth/admin/tenant/users/%v/groups/%v
IAM: Delete /auth/admin/tenant/users/%v/role-mappings/clients/%v
IAM: Delete /auth/admin/tenant/users/%v/role-mappings/realm
IAM: Get /auth/admin/tenant
IAM: Get /auth/admin/tenant/clients/%v/roles/%v
IAM: Get /auth/admin/tenant/clients/%v/roles?briefRepresentation=true
IAM: Get /auth/admin/tenant/clients?briefRepresentation=true
IAM: Get /auth/admin/tenant/groups/%v?%v
IAM: Get /auth/admin/tenant/groups?briefRepresentation=true
IAM: Get /auth/admin/tenant/groups?briefRepresentation=true&search=%v
IAM: Get /auth/admin/tenant/groups?briefRepresentation=true&search=%v
IAM: Get /auth/admin/tenant/roles/%v
IAM: Get /auth/admin/tenant/roles?briefRepresentation=true
IAM: Get /auth/admin/tenant/roles-by-id/%v
IAM: Get /auth/admin/tenant/roles-by-id/%v/composites
IAM: Get /auth/admin/tenant/users
IAM: Get /auth/admin/tenant/users/%v
IAM: Get /auth/admin/tenant/users/%v/groups
IAM: Get /auth/admin/tenant/users/%v/role-mappings/clients/%v
IAM: Get /auth/admin/tenant/users/%v/role-mappings/realm
IAM: Get /auth/admin/tenant/users/?exact=true&email=%v
IAM: Get /auth/admin/tenant/users/?exact=true&username=%v
IAM: Get /auth/tenant/pip/groups
IAM: Post /auth/admin/tenant/children
IAM: Post /auth/admin/tenant/clients/%v/roles
IAM: Post /auth/admin/tenant/groups
IAM: Post /auth/admin/tenant/groups/%v/children
IAM: Post /auth/admin/tenant/groups/%v/role-mappings/clients/%v
IAM: Post /auth/admin/tenant/roles-by-id/%v/composites
IAM: Post /auth/admin/tenant/users/%v/role-mappings/clients/%v
IAM: Post /auth/admin/tenant/users/%v/role-mappings/realm
IAM: Put /auth/admin/tenant/groups/%v
IAM: Put /auth/admin/tenant/users/%v
IAM: Put /auth/admin/tenant/users/%v/groups/%v

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var AUDIT_QUERY_APPLICATION = "Team"
View Source 
var AUDIT_QUERY_PRODUCT = "Cx"
View Source 
var AUDIT_QUERY_PROJECT = "Project"
View Source 
var AUDIT_QUERY_TENANT = "Corp"

Functions

func GetSeverity added in v0.0.66 

func GetSeverity(severity uint) string

func GetSeverityID added in v0.0.66 

func GetSeverityID(severity string) uint

func RemoveIndex added in v0.0.11 

func RemoveIndex(slice []interface{}, index int) []interface{}

func ShortenGUID 

func ShortenGUID(guid string) string

Types

type ASTLicense added in v0.0.40 

type ASTLicense struct {
	ID          int
	TenantID    string
	PackageName string
	LicenseData struct {
		AllowedEngines     []string
		APISecurityEnabled bool
		CodebashingEnabled bool
		DASTEnabled        bool
		MaxConcurrentScans int
		SCSEnabled         bool
		ServiceType        string
		Services           []string
		UsersCount         int
	}
}

type AccessAssignedRole added in v0.0.47 

type AccessAssignedRole struct {
	Id   string `json:"id"`
	Name string `json:"name"`
}

type AccessAssignment added in v0.0.15 

type AccessAssignment struct {
	TenantID     string               `json:"tenantID"`
	EntityID     string               `json:"entityID"`
	EntityType   string               `json:"entityType"`
	EntityName   string               `json:"entityName"`
	EntityRoles  []AccessAssignedRole `json:"entityRoles"`
	ResourceID   string               `json:"resourceID"`
	ResourceType string               `json:"resourceType"`
	ResourceName string               `json:"resourceName"`
	CreatedAt    string               `json:"createdAt"`
}

type AccessibleResource added in v0.0.15 

type AccessibleResource struct {
	ResourceID   string   `json:"resourceId"`
	ResourceType string   `json:"resourceType"`
	Roles        []string `json:"roles"`
}

type Application 

type Application struct {
	ApplicationID string            `json:"id"`
	Name          string            `json:"name"`
	Description   string            `json:"description"`
	Criticality   uint              `json:"criticality"`
	Rules         []ApplicationRule `json:"rules"`
	Tags          map[string]string `json:"tags"`
	ProjectIds    []string          `json:"projectIds"`
	CreatedAt     string            `json:"createdAt"`
	UpdatedAt     string            `json:"updatedAt"`
}

func (*Application) AddRule 

func (a *Application) AddRule(ruletype, value string)

func (*Application) AssignProject 

func (a *Application) AssignProject(project *Project)

AssignProject will create or update a "project.name.in" type rule to assign the project to the app

func (*Application) GetRuleByType 

func (a *Application) GetRuleByType(ruletype string) *ApplicationRule

func (*Application) RemoveRule added in v0.0.68 

func (a *Application) RemoveRule(rule *ApplicationRule)

func (*Application) String 

func (a *Application) String() string

func (*Application) UnassignProject added in v0.0.70 

func (a *Application) UnassignProject(project *Project)

UnassignProject will remove the project from the "project.name.in" rule if it's there, and if the rule ends up empty it will remove the rule

type ApplicationRule 

type ApplicationRule struct {
	Type  string `json:"type"`
	Value string `json:"value"`
}

func (*ApplicationRule) RemoveItem added in v0.0.70 

func (ar *ApplicationRule) RemoveItem(item string)

type AuditPermissions added in v0.0.66 

type AuditPermissions struct {
	View   bool `json:"view"`
	Update bool `json:"update"`
	Create bool `json:"create"`
	Delete bool `json:"delete"`
}

type AuditQuery added in v0.0.11 

type AuditQuery struct {
	Key      string `json:"id"`
	Name     string
	Level    string
	LevelID  string
	Path     string
	Source   string
	Metadata AuditQueryMetadata
}

func (*AuditQuery) CalculateEditorKey added in v0.0.66 

func (q *AuditQuery) CalculateEditorKey() string

func (AuditQuery) CalculateQueryID added in v0.0.66 

func (q AuditQuery) CalculateQueryID() (uint64, error)

func (AuditQuery) String added in v0.0.11 

func (q AuditQuery) String() string

func (AuditQuery) ToQuery added in v0.0.66 

func (q AuditQuery) ToQuery() Query

type AuditQueryMetadata added in v0.0.11 

type AuditQueryMetadata struct {
	Cwe             int64  `json:"cwe,omitempty"`
	IsExecutable    bool   `json:"executable"`
	CxDescriptionID int64  `json:"description,omitempty"`
	Language        string `json:"language"`
	Group           string `json:"group"`
	Severity        string `json:"severity"`
	SastID          uint64 `json:"sastId,omitempty"`
	Name            string `json:"name"`
}

type AuditQueryTree added in v0.0.66 

type AuditQueryTree struct {
	IsLeaf bool
	Title  string
	Key    string
	Data   struct {
		Level    string
		Severity string
	}
	Children []AuditQueryTree
}

type AuditQuery_v310 added in v0.0.66 

type AuditQuery_v310 struct {
	QueryID            uint64 `json:"Id,string"`
	Level              string
	LevelID            string `json:"-"`
	Path               string
	Modified           string
	Source             string
	Name               string
	Group              string
	Language           string `json:"lang"`
	Severity           string
	Cwe                int64
	IsExecutable       bool
	CxDescriptionId    int64
	QueryDescriptionId string
	Key                string
	Title              string
}

func FindQueryByName_v310 added in v0.0.66 

func FindQueryByName_v310(queries []AuditQuery_v310, level, language, group, name string) (AuditQuery_v310, error)

func (AuditQuery_v310) CreateApplicationOverrideByID added in v0.0.67 

func (q AuditQuery_v310) CreateApplicationOverrideByID(applicationId string) AuditQuery_v310

func (AuditQuery_v310) CreateProjectOverrideByID added in v0.0.67 

func (q AuditQuery_v310) CreateProjectOverrideByID(projectId string) AuditQuery_v310

func (AuditQuery_v310) CreateTenantOverride added in v0.0.67 

func (q AuditQuery_v310) CreateTenantOverride() AuditQuery_v310

func (*AuditQuery_v310) ParsePath added in v0.0.66 

func (q *AuditQuery_v310) ParsePath()

func (AuditQuery_v310) String added in v0.0.66 

func (q AuditQuery_v310) String() string

func (AuditQuery_v310) ToQuery added in v0.0.66 

func (q AuditQuery_v310) ToQuery() Query

type AuditQuery_v312 added in v0.0.66 

type AuditQuery_v312 struct {
	QueryID            uint64 `json:"Id,string"`
	Level              string
	LevelID            string `json:"-"`
	Path               string
	Modified           string
	Source             string
	Name               string
	Group              string
	Language           string `json:"lang"`
	Severity           string
	Cwe                int64
	IsExecutable       bool
	CxDescriptionId    int64
	QueryDescriptionId string
	Key                string
	Title              string
}

this struct is used specifically for the to-be-deprecated /cx-audit/queries endpoint

func (AuditQuery_v312) ToQuery added in v0.0.66 

func (q AuditQuery_v312) ToQuery() Query

type AuditScanSourceFile added in v0.0.66 

type AuditScanSourceFile struct {
	IsLeaf   bool                  `json:"isLeaf"`
	Title    string                `json:"title"`
	Key      string                `json:"key"`
	Children []AuditScanSourceFile `json:"children"`
}

type AuditSession added in v0.0.66 

type AuditSession struct {
	ID   string `json:"id"`
	Data struct {
		Status      string `json:"status"`
		RequestID   string `json:"requestId"`
		Permissions struct {
			Tenant      AuditPermissions `json:"tenant"`
			Project     AuditPermissions `json:"project"`
			Application AuditPermissions `json:"application"`
		} `json:"permissions"`
	} `json:"data"`
	ProjectName            string   `json:"projectName"`
	QueryBuilder           bool     `json:"queryBuilder"`
	ApplicationAssociation bool     `json:"applicationAssociation"`
	Status                 string   `json:"status"`
	Value                  []string `json:"value"`
	ProjectID              string   `json:"-"`
	ApplicationID          string   `json:"-"`
	ScanID                 string   `json:"-"`
	Languages              []string `json:"-"`
}

func (AuditSession) HasLanguage added in v0.0.67 

func (s AuditSession) HasLanguage(language string) bool

type AuditSessionFilters added in v0.0.79 

type AuditSessionFilters map[string]AuditSessionLanguageFilters

func (AuditSessionFilters) GetKey added in v0.0.79 

func (f AuditSessionFilters) GetKey(engine, language string) (string, error)

type AuditSessionLanguage added in v0.0.79 

type AuditSessionLanguage struct {
	Key   string
	Title string
	Icon  string
}

type AuditSessionLanguageFilters added in v0.0.79 

type AuditSessionLanguageFilters struct {
	Description string
	Filters     []AuditSessionLanguage
}

type AuthenticationProvider added in v0.0.54 

type AuthenticationProvider struct {
	Alias      string `json:"alias"`
	ID         string `json:"internalId,omitempty"`
	ProviderID string `json:"providerId"`
}

func (AuthenticationProvider) MakeDefaultMapper added in v0.0.54 

func (a AuthenticationProvider) MakeDefaultMapper(attribute string) (AuthenticationProviderMapper, error)

Convenience functions

func (AuthenticationProvider) String added in v0.0.54 

func (p AuthenticationProvider) String() string

type AuthenticationProviderMapper added in v0.0.54 

type AuthenticationProviderMapper struct {
	ID     string                             `json:"id,omitempty"`
	Name   string                             `json:"name"`
	Alias  string                             `json:"identityProviderAlias"`
	Mapper string                             `json:"identityProviderMapper"`
	Config AuthenticationProviderMapperConfig `json:"config"`
}

func (AuthenticationProviderMapper) String added in v0.0.54 

func (m AuthenticationProviderMapper) String() string

type AuthenticationProviderMapperConfig added in v0.0.54 

type AuthenticationProviderMapperConfig struct {
	SyncMode      string `json:"syncMode"`
	UserAttribute string `json:"user.attribute,omitempty"`
	FriendlyName  string `json:"attribute.friendly.name,omitempty"`
	Format        string `json:"attribute.name.format,omitempty"`
	Name          string `json:"attribute.name,omitempty"`
	Role          string `json:"attribute.role,omitempty"`
	Value         string `json:"attribute.value,omitempty"`
	Target        string `json:"target,omitempty"`
	Template      string `json:"template,omitempty"`
}

type ClientVars added in v0.0.19 

type ClientVars struct {
	MigrationPollingMaxSeconds                int
	MigrationPollingDelaySeconds              int
	AuditEnginePollingMaxSeconds              int
	AuditEnginePollingDelaySeconds            int
	AuditScanPollingMaxSeconds                int
	AuditScanPollingDelaySeconds              int
	AuditCompilePollingMaxSeconds             int
	AuditCompilePollingDelaySeconds           int
	AuditLanguagePollingMaxSeconds            int
	AuditLanguagePollingDelaySeconds          int
	ScanPollingMaxSeconds                     int
	ScanPollingDelaySeconds                   int
	ProjectApplicationLinkPollingMaxSeconds   int
	ProjectApplicationLinkPollingDelaySeconds int
}

type ConfigurationSetting added in v0.0.39 

type ConfigurationSetting struct {
	Key             string `json:"key"`
	Name            string `json:"name"`
	Category        string `json:"category"`
	OriginLevel     string `json:"originLevel"`
	Value           string `json:"value"`
	ValueType       string `json:"valuetype"`
	ValueTypeParams string `json:"valuetypeparams"`
	AllowOverride   bool   `json:"allowOverride"`
}

type Cx1Cache 

type Cx1Cache struct {
	ProjectRefresh     bool
	Projects           []Project
	GroupRefresh       bool
	Groups             []Group
	UserRefresh        bool
	Users              []User
	QueryRefresh       bool
	Queries            QueryCollection
	PresetRefresh      bool
	Presets            []Preset
	RoleRefresh        bool
	Roles              []Role
	Applications       []Application
	ApplicationRefresh bool
	Clients            []OIDCClient
	ClientRefresh      bool
}

func (*Cx1Cache) ApplicationSummary added in v0.0.54 

func (c *Cx1Cache) ApplicationSummary() string

func (*Cx1Cache) ClientSummary added in v0.0.56 

func (c *Cx1Cache) ClientSummary() string

func (*Cx1Cache) GetApplication added in v0.0.54 

func (c *Cx1Cache) GetApplication(applicationID string) (*Application, error)

func (*Cx1Cache) GetApplicationByName added in v0.0.54 

func (c *Cx1Cache) GetApplicationByName(name string) (*Application, error)

func (*Cx1Cache) GetClient added in v0.0.56 

func (c *Cx1Cache) GetClient(ID string) (*OIDCClient, error)

func (*Cx1Cache) GetClientByID added in v0.0.56 

func (c *Cx1Cache) GetClientByID(clientId string) (*OIDCClient, error)

func (*Cx1Cache) GetGroup 

func (c *Cx1Cache) GetGroup(groupID string) (*Group, error)

func (*Cx1Cache) GetGroupByName 

func (c *Cx1Cache) GetGroupByName(name string) (*Group, error)

func (*Cx1Cache) GetPreset 

func (c *Cx1Cache) GetPreset(presetID uint64) (*Preset, error)

func (*Cx1Cache) GetPresetByName 

func (c *Cx1Cache) GetPresetByName(name string) (*Preset, error)

func (*Cx1Cache) GetProject 

func (c *Cx1Cache) GetProject(projectID string) (*Project, error)

func (*Cx1Cache) GetProjectByName 

func (c *Cx1Cache) GetProjectByName(name string) (*Project, error)

func (*Cx1Cache) GetQuery 

func (c *Cx1Cache) GetQuery(queryID uint64) (*Query, error)

func (*Cx1Cache) GetQueryByNames 

func (c *Cx1Cache) GetQueryByNames(language, group, query string) (*Query, error)

func (*Cx1Cache) GetRole 

func (c *Cx1Cache) GetRole(roleID string) (*Role, error)

func (*Cx1Cache) GetRoleByName 

func (c *Cx1Cache) GetRoleByName(name string) (*Role, error)

func (*Cx1Cache) GetUser 

func (c *Cx1Cache) GetUser(userID string) (*User, error)

func (*Cx1Cache) GetUserByEmail 

func (c *Cx1Cache) GetUserByEmail(email string) (*User, error)

func (*Cx1Cache) GetUserByString 

func (c *Cx1Cache) GetUserByString(displaystring string) (*User, error)

func (*Cx1Cache) GroupSummary 

func (c *Cx1Cache) GroupSummary() string

func (*Cx1Cache) MatchPresetQueries added in v0.0.62 

func (c *Cx1Cache) MatchPresetQueries()

func (*Cx1Cache) PresetSummary 

func (c *Cx1Cache) PresetSummary() string

func (*Cx1Cache) ProjectSummary 

func (c *Cx1Cache) ProjectSummary() string

func (*Cx1Cache) QuerySummary 

func (c *Cx1Cache) QuerySummary() string

func (*Cx1Cache) Refresh 

func (c *Cx1Cache) Refresh(client *Cx1Client) []error

func (*Cx1Cache) RefreshApplications added in v0.0.54 

func (c *Cx1Cache) RefreshApplications(client *Cx1Client) error

func (*Cx1Cache) RefreshClients added in v0.0.56 

func (c *Cx1Cache) RefreshClients(client *Cx1Client) error

func (*Cx1Cache) RefreshGroups 

func (c *Cx1Cache) RefreshGroups(client *Cx1Client) error

func (*Cx1Cache) RefreshPresets 

func (c *Cx1Cache) RefreshPresets(client *Cx1Client) error

func (*Cx1Cache) RefreshProjects 

func (c *Cx1Cache) RefreshProjects(client *Cx1Client) error

func (*Cx1Cache) RefreshQueries 

func (c *Cx1Cache) RefreshQueries(client *Cx1Client) error

func (*Cx1Cache) RefreshRoles 

func (c *Cx1Cache) RefreshRoles(client *Cx1Client) error

func (*Cx1Cache) RefreshUsers 

func (c *Cx1Cache) RefreshUsers(client *Cx1Client) error

func (*Cx1Cache) UserSummary 

func (c *Cx1Cache) UserSummary() string

type Cx1Claims added in v0.0.40 

type Cx1Claims struct {
	jwt.RegisteredClaims
	Cx1License    ASTLicense `json:"ast-license"`
	IsServiceUser string     `json:"is-service-user"`
	UserID        string     `json:"sub"`
}

type Cx1Client 

type Cx1Client struct {
	// contains filtered or unexported fields
}

func NewAPIKeyClient 

func NewAPIKeyClient(client *http.Client, base_url string, iam_url string, tenant string, api_key string, logger *logrus.Logger) (*Cx1Client, error)

Main entry for users of this client when using API Key

func NewClient added in v0.0.73 

func NewClient(client *http.Client, logger *logrus.Logger) (*Cx1Client, error)

Convenience function that reads command-line flags to create the Cx1Client

func NewOAuthClient 

func NewOAuthClient(client *http.Client, base_url string, iam_url string, tenant string, client_id string, client_secret string, logger *logrus.Logger) (*Cx1Client, error)

Main entry for users of this client when using OAuth Client ID & Client Secret:

func (Cx1Client) AddAccessAssignment added in v0.0.15 

func (c Cx1Client) AddAccessAssignment(access AccessAssignment) error

func (Cx1Client) AddAuthenticationProviderMapper added in v0.0.54 

func (c Cx1Client) AddAuthenticationProviderMapper(mapper AuthenticationProviderMapper) error

func (Cx1Client) AddClientScopeByID added in v0.0.15 

func (c Cx1Client) AddClientScopeByID(oidcId, clientScopeId string) error

func (Cx1Client) AddKICSResultsPredicates added in v0.0.37 

func (c Cx1Client) AddKICSResultsPredicates(predicates []KICSResultsPredicates) error

func (Cx1Client) AddRoleComposites 

func (c Cx1Client) AddRoleComposites(role *Role, roles *[]Role) error

func (Cx1Client) AddRolesToGroup added in v0.0.16 

func (c Cx1Client) AddRolesToGroup(g *Group, clientRoles map[string][]string) error

clientRoles map looks like: "ast-app" : { "ast-scanner", "ast-viewer" }

func (Cx1Client) AddSASTResultsPredicates added in v0.0.37 

func (c Cx1Client) AddSASTResultsPredicates(predicates []SASTResultsPredicates) error

results

func (Cx1Client) AddUserAppRoles 

func (c Cx1Client) AddUserAppRoles(user *User, roles *[]Role) error

func (Cx1Client) AddUserIAMRoles 

func (c Cx1Client) AddUserIAMRoles(user *User, roles *[]Role) error

func (Cx1Client) AddUserRoles 

func (c Cx1Client) AddUserRoles(user *User, roles *[]Role) error

func (Cx1Client) AssignUserToGroupByID 

func (c Cx1Client) AssignUserToGroupByID(user *User, groupId string) error

func (Cx1Client) AuditCreateSession added in v0.0.79 

func (c Cx1Client) AuditCreateSession(engine, filter string) (AuditSession, error)

func (Cx1Client) AuditCreateSessionByID added in v0.0.11 

func (c Cx1Client) AuditCreateSessionByID(engine, projectId, scanId string) (AuditSession, error)

func (Cx1Client) AuditDeleteSession added in v0.0.67 

func (c Cx1Client) AuditDeleteSession(auditSession *AuditSession) error

func (Cx1Client) AuditGetRequestStatusByID added in v0.0.66 

func (c Cx1Client) AuditGetRequestStatusByID(auditSession *AuditSession, requestId string) (bool, interface{}, error)

func (Cx1Client) AuditGetScanSourcesByID added in v0.0.66 

func (c Cx1Client) AuditGetScanSourcesByID(auditSession *AuditSession) ([]AuditScanSourceFile, error)

func (Cx1Client) AuditNewQuery_v310 added in v0.0.66 

func (c Cx1Client) AuditNewQuery_v310(language, group, name string) (AuditQuery_v310, error)

func (Cx1Client) AuditRequestStatusPollingByID added in v0.0.66 

func (c Cx1Client) AuditRequestStatusPollingByID(auditSession *AuditSession, requestId string) (interface{}, error)

func (Cx1Client) AuditRequestStatusPollingByIDWithTimeout added in v0.0.68 

func (c Cx1Client) AuditRequestStatusPollingByIDWithTimeout(auditSession *AuditSession, requestId string, delaySeconds, maxSeconds int) (interface{}, error)

func (Cx1Client) AuditRunScanByID added in v0.0.11 

func (c Cx1Client) AuditRunScanByID(auditSession *AuditSession) error

func (Cx1Client) AuditSessionKeepAlive added in v0.0.11 

func (c Cx1Client) AuditSessionKeepAlive(auditSession *AuditSession) error

func (Cx1Client) CancelScanByID added in v0.0.50 

func (c Cx1Client) CancelScanByID(scanID string) error

func (Cx1Client) CheckAccessToResourceByID added in v0.0.15 

func (c Cx1Client) CheckAccessToResourceByID(resourceId, resourceType, action string) (bool, error)

func (Cx1Client) CheckAccessibleResources added in v0.0.15 

func (c Cx1Client) CheckAccessibleResources(resourceTypes []string, action string) (bool, []AccessibleResource, error)

func (Cx1Client) CheckFlag added in v0.0.18 

func (c Cx1Client) CheckFlag(flag string) (bool, error)

func (Cx1Client) CreateAppRole 

func (c Cx1Client) CreateAppRole(roleName, createdBy string) (Role, error)

func (Cx1Client) CreateApplication 

func (c Cx1Client) CreateApplication(appname string) (Application, error)

func (Cx1Client) CreateAuthenticationProvider added in v0.0.54 

func (c Cx1Client) CreateAuthenticationProvider(alias, providerId string) (AuthenticationProvider, error)

func (Cx1Client) CreateChildGroup 

func (c Cx1Client) CreateChildGroup(parentGroup *Group, childGroupName string) (Group, error)

func (Cx1Client) CreateClient added in v0.0.15 

func (c Cx1Client) CreateClient(name string, notificationEmails []string, secretExpiration int) (OIDCClient, error)

func (Cx1Client) CreateGroup 

func (c Cx1Client) CreateGroup(groupname string) (Group, error)

func (Cx1Client) CreateNewQuery added in v0.0.66 

func (c Cx1Client) CreateNewQuery(auditSession *AuditSession, query Query) (Query, error)

func (Cx1Client) CreatePreset 

func (c Cx1Client) CreatePreset(name, description string, queryIDs []uint64) (Preset, error)

func (Cx1Client) CreateProject 

func (c Cx1Client) CreateProject(projectname string, cx1_group_ids []string, tags map[string]string) (Project, error)

Projects

func (Cx1Client) CreateProjectInApplication added in v0.0.31 

func (c Cx1Client) CreateProjectInApplication(projectname string, cx1_group_ids []string, tags map[string]string, applicationId string) (Project, error)

func (Cx1Client) CreateQueryOverride added in v0.0.66 

func (c Cx1Client) CreateQueryOverride(auditSession *AuditSession, level string, baseQuery *Query) (Query, error)

func (Cx1Client) CreateSAMLUser added in v0.0.64 

func (c Cx1Client) CreateSAMLUser(newuser User, idpAlias, idpUserId, idpUserName string) (User, error)

CreateSAMLUser will directly create a user that can log in via SAML, requiring the internal identifiers that are used within the identity provider.

This function requires some special behavior that's not supported by the standard user type, and requires a two-step process of creating and then updating the user.

func (Cx1Client) CreateUser 

func (c Cx1Client) CreateUser(newuser User) (User, error)

func (Cx1Client) DeleteAccessAssignmentByID added in v0.0.15 

func (c Cx1Client) DeleteAccessAssignmentByID(entityId, resourceId string) error

func (Cx1Client) DeleteApplication 

func (c Cx1Client) DeleteApplication(application *Application) error

func (Cx1Client) DeleteApplicationByID 

func (c Cx1Client) DeleteApplicationByID(applicationId string) error

func (Cx1Client) DeleteAuthenticationProvider added in v0.0.54 

func (c Cx1Client) DeleteAuthenticationProvider(provider AuthenticationProvider) error

func (Cx1Client) DeleteAuthenticationProviderMapper added in v0.0.54 

func (c Cx1Client) DeleteAuthenticationProviderMapper(mapper AuthenticationProviderMapper) error

func (Cx1Client) DeleteClientByID added in v0.0.15 

func (c Cx1Client) DeleteClientByID(id string) error

func (Cx1Client) DeleteGroup 

func (c Cx1Client) DeleteGroup(group *Group) error

func (Cx1Client) DeletePreset 

func (c Cx1Client) DeletePreset(preset *Preset) error

func (Cx1Client) DeleteProject 

func (c Cx1Client) DeleteProject(p *Project) error

func (Cx1Client) DeleteQueryByName_v310 added in v0.0.66 

func (c Cx1Client) DeleteQueryByName_v310(level, levelID, language, group, query string) error

func (Cx1Client) DeleteQueryOverrideByKey added in v0.0.66 

func (c Cx1Client) DeleteQueryOverrideByKey(auditSession *AuditSession, queryKey string) error

func (Cx1Client) DeleteQuery_v310 added in v0.0.66 

func (c Cx1Client) DeleteQuery_v310(query AuditQuery_v310) error

func (Cx1Client) DeleteRoleByID 

func (c Cx1Client) DeleteRoleByID(roleId string) error

func (Cx1Client) DeleteRolesFromGroup added in v0.0.16 

func (c Cx1Client) DeleteRolesFromGroup(g *Group, clientRoles map[string][]string) error

clientRoles map looks like: "ast-app" : { "ast-scanner", "ast-viewer" }

func (Cx1Client) DeleteScanByID added in v0.0.12 

func (c Cx1Client) DeleteScanByID(scanID string) error

func (Cx1Client) DeleteUser 

func (c Cx1Client) DeleteUser(user *User) error

func (Cx1Client) DeleteUserByID 

func (c Cx1Client) DeleteUserByID(userid string) error

func (Cx1Client) DownloadReport 

func (c Cx1Client) DownloadReport(reportUrl string) ([]byte, error)

func (Cx1Client) FindQueryByName_v310 added in v0.0.69 

func (c Cx1Client) FindQueryByName_v310(queries []AuditQuery_v310, level, language, group, name string) (AuditQuery_v310, error)

func (Cx1Client) GetASTAppID 

func (c Cx1Client) GetASTAppID() string

convenience function

func (Cx1Client) GetAccessAssignmentByID added in v0.0.15 

func (c Cx1Client) GetAccessAssignmentByID(entityId, resourceId string) (AccessAssignment, error)

func (Cx1Client) GetAllPresets added in v0.0.10 

func (c Cx1Client) GetAllPresets() ([]Preset, error)

convenience

func (Cx1Client) GetAppRoleByName 

func (c Cx1Client) GetAppRoleByName(name string) (Role, error)

func (Cx1Client) GetAppRoles 

func (c Cx1Client) GetAppRoles() ([]Role, error)

func (Cx1Client) GetApplicationByID added in v0.0.70 

func (c Cx1Client) GetApplicationByID(id string) (Application, error)

func (Cx1Client) GetApplicationByName 

func (c Cx1Client) GetApplicationByName(name string) (Application, error)

func (Cx1Client) GetApplicationCount 

func (c Cx1Client) GetApplicationCount() (uint64, error)

convenience

func (Cx1Client) GetApplicationCountByName 

func (c Cx1Client) GetApplicationCountByName(name string) (uint64, error)

func (Cx1Client) GetApplications 

func (c Cx1Client) GetApplications(limit uint) ([]Application, error)

Applications

func (Cx1Client) GetApplicationsByName 

func (c Cx1Client) GetApplicationsByName(name string, limit uint64) ([]Application, error)

func (Cx1Client) GetAuditQueriesByLevelID added in v0.0.66 

func (c Cx1Client) GetAuditQueriesByLevelID(auditSession *AuditSession, level, levelId string) ([]Query, error)

Retrieves the list of queries available for this audit session. Level and LevelID options are: QueryTypeProduct(), QueryTypeProduct() : same value for both when retrieving product-level queries QueryTypeTenant(), QueryTypeTenant() : same value for both when retrieving tenant-level queries QueryTypeApplication(), application.ApplicationID : when retrieving application-level queries QueryTypeProject(), project.ProjectID : when retrieving project-level queries

The resulting array of queries should be merged into a QueryCollection object returned by the GetQueries function.

func (Cx1Client) GetAuditQueryByKey added in v0.0.66 

func (c Cx1Client) GetAuditQueryByKey(auditSession *AuditSession, key string) (Query, error)

func (Cx1Client) GetAuditSessionByID added in v0.0.11 

func (c Cx1Client) GetAuditSessionByID(engine, projectId, scanId string) (AuditSession, error)

Convenience function

func (Cx1Client) GetAuditSessionFilters added in v0.0.79 

func (c Cx1Client) GetAuditSessionFilters() (AuditSessionFilters, error)

func (Cx1Client) GetAuthenticationProviderByAlias added in v0.0.54 

func (c Cx1Client) GetAuthenticationProviderByAlias(alias string) (AuthenticationProvider, error)

func (Cx1Client) GetAuthenticationProviderMappers added in v0.0.54 

func (c Cx1Client) GetAuthenticationProviderMappers(provider AuthenticationProvider) ([]AuthenticationProviderMapper, error)

func (Cx1Client) GetAuthenticationProviders added in v0.0.54 

func (c Cx1Client) GetAuthenticationProviders() ([]AuthenticationProvider, error)

func (Cx1Client) GetClaims added in v0.0.48 

func (c Cx1Client) GetClaims() Cx1Claims

func (Cx1Client) GetClientByID added in v0.0.22 

func (c Cx1Client) GetClientByID(id string) (OIDCClient, error)

func (Cx1Client) GetClientByName 

func (c Cx1Client) GetClientByName(clientName string) (OIDCClient, error)

func (Cx1Client) GetClientScopeByName added in v0.0.15 

func (c Cx1Client) GetClientScopeByName(name string) (OIDCClientScope, error)

func (Cx1Client) GetClientScopes added in v0.0.15 

func (c Cx1Client) GetClientScopes() ([]OIDCClientScope, error)

func (Cx1Client) GetClientVars added in v0.0.19 

func (c Cx1Client) GetClientVars() ClientVars

func (Cx1Client) GetClients 

func (c Cx1Client) GetClients() ([]OIDCClient, error)

Clients

func (Cx1Client) GetConfigurationByName added in v0.0.39 

func (c Cx1Client) GetConfigurationByName(config *[]ConfigurationSetting, configKey string) *ConfigurationSetting

func (*Cx1Client) GetCurrentUser 

func (c *Cx1Client) GetCurrentUser() (User, error)

func (Cx1Client) GetCx1QueryFromSAST added in v0.0.67 

func (c Cx1Client) GetCx1QueryFromSAST(sastId uint64, language, group, name string, mapping *map[uint64]uint64, qc *QueryCollection) *Query

func (Cx1Client) GetEntitiesAccessToResourceByID added in v0.0.15 

func (c Cx1Client) GetEntitiesAccessToResourceByID(resourceId, resourceType string) ([]AccessAssignment, error)

func (Cx1Client) GetFlags added in v0.0.18 

func (c Cx1Client) GetFlags() map[string]bool

func (Cx1Client) GetGroupByID 

func (c Cx1Client) GetGroupByID(groupID string) (Group, error)

func (Cx1Client) GetGroupByName 

func (c Cx1Client) GetGroupByName(groupname string) (Group, error)

func (Cx1Client) GetGroupByPath added in v0.0.62 

func (c Cx1Client) GetGroupByPath(path string) (Group, error)

this function returns a group matching a path, however as of keycloak 23.0.7 this endpoint is missing the subGroupCount field, which other parts of cx1clientgo rely on, so this function will automatically trigger a GetGroupByID call

func (Cx1Client) GetGroupChildren added in v0.0.82 

func (c Cx1Client) GetGroupChildren(group *Group) ([]Group, error)

func (Cx1Client) GetGroupChildrenByID added in v0.0.82 

func (c Cx1Client) GetGroupChildrenByID(groupID string, first, max int) ([]Group, error)

func (Cx1Client) GetGroupMembers added in v0.0.62 

func (c Cx1Client) GetGroupMembers(group *Group) ([]User, error)

func (Cx1Client) GetGroupMembersByID added in v0.0.62 

func (c Cx1Client) GetGroupMembersByID(groupID string) ([]User, error)

func (Cx1Client) GetGroupPIPByName 

func (c Cx1Client) GetGroupPIPByName(groupname string) (Group, error)

func (Cx1Client) GetGroups 

func (c Cx1Client) GetGroups() ([]Group, error)

this returns all groups including all subgroups

func (Cx1Client) GetGroupsByName 

func (c Cx1Client) GetGroupsByName(groupname string) ([]Group, error)

this function returns all top-level groups matching the search string, or if a sub-group matches the search, it will return the parent group and only the matching subgroups

func (Cx1Client) GetGroupsPIP 

func (c Cx1Client) GetGroupsPIP() ([]Group, error)

func (Cx1Client) GetIAMRoleByName 

func (c Cx1Client) GetIAMRoleByName(name string) (Role, error)

func (Cx1Client) GetIAMRoles 

func (c Cx1Client) GetIAMRoles() ([]Role, error)

func (Cx1Client) GetImportByID added in v0.0.14 

func (c Cx1Client) GetImportByID(importID string) (DataImport, error)

func (Cx1Client) GetImportLogsByID added in v0.0.14 

func (c Cx1Client) GetImportLogsByID(importID, engine string) ([]byte, error)

func (Cx1Client) GetImports added in v0.0.14 

func (c Cx1Client) GetImports() ([]DataImport, error)

func (Cx1Client) GetKICSResultsPredicatesByID added in v0.0.37 

func (c Cx1Client) GetKICSResultsPredicatesByID(SimilarityID string, ProjectID string) ([]KICSResultsPredicates, error)

func (Cx1Client) GetLastScansByID 

func (c Cx1Client) GetLastScansByID(projectID string, limit int) ([]Scan, error)

func (Cx1Client) GetLastScansByIDFiltered added in v0.0.13 

func (c Cx1Client) GetLastScansByIDFiltered(projectID string, filter ScanFilter) ([]Scan, error)

func (Cx1Client) GetLastScansByStatus 

func (c Cx1Client) GetLastScansByStatus(status []string) ([]Scan, error)

func (Cx1Client) GetLastScansByStatusAndID 

func (c Cx1Client) GetLastScansByStatusAndID(projectID string, limit int, status []string) ([]Scan, error)

func (Cx1Client) GetLastScansFiltered added in v0.0.30 

func (c Cx1Client) GetLastScansFiltered(filter ScanFilter) ([]Scan, error)

func (Cx1Client) GetLicense added in v0.0.40 

func (c Cx1Client) GetLicense() ASTLicense

func (Cx1Client) GetOrCreateApplicationByName 

func (c Cx1Client) GetOrCreateApplicationByName(name string) (Application, error)

func (Cx1Client) GetOrCreateGroupByName 

func (c Cx1Client) GetOrCreateGroupByName(name string) (Group, error)

convenience

func (Cx1Client) GetOrCreateProjectByName 

func (c Cx1Client) GetOrCreateProjectByName(name string) (Project, error)

func (Cx1Client) GetOrCreateProjectInApplicationByName added in v0.0.31 

func (c Cx1Client) GetOrCreateProjectInApplicationByName(projectName, applicationName string) (Project, Application, error)

func (Cx1Client) GetPresetByID 

func (c Cx1Client) GetPresetByID(id uint64) (Preset, error)

func (Cx1Client) GetPresetByName 

func (c Cx1Client) GetPresetByName(name string) (Preset, error)

func (Cx1Client) GetPresetContents 

func (c Cx1Client) GetPresetContents(p *Preset, qc *QueryCollection) error

func (Cx1Client) GetPresetCount added in v0.0.10 

func (c Cx1Client) GetPresetCount() (uint64, error)

func (Cx1Client) GetPresetQueries added in v0.0.66 

func (c Cx1Client) GetPresetQueries() ([]Query, error)

func (Cx1Client) GetPresets 

func (c Cx1Client) GetPresets(count uint64) ([]Preset, error)

func (Cx1Client) GetProjectBranchesByID added in v0.0.80 

func (c Cx1Client) GetProjectBranchesByID(projectID string) ([]string, error)

func (Cx1Client) GetProjectBranchesFiltered added in v0.0.80 

func (c Cx1Client) GetProjectBranchesFiltered(filter ProjectBranchFilter) ([]string, error)

func (Cx1Client) GetProjectByID 

func (c Cx1Client) GetProjectByID(projectID string) (Project, error)

func (Cx1Client) GetProjectByName 

func (c Cx1Client) GetProjectByName(projectname string) (Project, error)

func (Cx1Client) GetProjectConfiguration 

func (c Cx1Client) GetProjectConfiguration(project *Project) error

func (Cx1Client) GetProjectConfigurationByID 

func (c Cx1Client) GetProjectConfigurationByID(projectID string) ([]ConfigurationSetting, error)

func (Cx1Client) GetProjectCount 

func (c Cx1Client) GetProjectCount() (uint64, error)

convenience

func (Cx1Client) GetProjectCountByName 

func (c Cx1Client) GetProjectCountByName(name string) (uint64, error)

func (Cx1Client) GetProjects 

func (c Cx1Client) GetProjects(limit uint64) ([]Project, error)

func (Cx1Client) GetProjectsByName 

func (c Cx1Client) GetProjectsByName(projectname string, limit uint64) ([]Project, error)

func (Cx1Client) GetProjectsByNameAndGroupID 

func (c Cx1Client) GetProjectsByNameAndGroupID(projectName string, groupID string) ([]Project, error)

func (Cx1Client) GetQueries 

func (c Cx1Client) GetQueries() (QueryCollection, error)

func (Cx1Client) GetQueriesByLevelID added in v0.0.12 

func (c Cx1Client) GetQueriesByLevelID(level, levelId string) ([]Query, error)

func (Cx1Client) GetQueriesByLevelID_v310 added in v0.0.66 

func (c Cx1Client) GetQueriesByLevelID_v310(level, levelId string) ([]AuditQuery_v310, error)

func (Cx1Client) GetQueries_v310 added in v0.0.66 

func (c Cx1Client) GetQueries_v310() (QueryCollection, error)

func (Cx1Client) GetQueryByName_v310 added in v0.0.66 

func (c Cx1Client) GetQueryByName_v310(level, levelid, language, group, query string) (AuditQuery_v310, error)

func (Cx1Client) GetQueryMappings added in v0.0.45 

func (c Cx1Client) GetQueryMappings() (map[uint64]uint64, error)

func (Cx1Client) GetReportStatusByID 

func (c Cx1Client) GetReportStatusByID(reportID string) (ReportStatus, error)

func (Cx1Client) GetResourcesAccessibleToEntityByID added in v0.0.16 

func (c Cx1Client) GetResourcesAccessibleToEntityByID(entityId, entityType string, resourceTypes []string) ([]AccessAssignment, error)

func (Cx1Client) GetRoleByClientIDAndName 

func (c Cx1Client) GetRoleByClientIDAndName(clientId string, name string) (Role, error)

func (Cx1Client) GetRoleByID 

func (c Cx1Client) GetRoleByID(roleId string) (Role, error)

func (Cx1Client) GetRoleByName 

func (c Cx1Client) GetRoleByName(name string) (Role, error)

func (Cx1Client) GetRoleComposites 

func (c Cx1Client) GetRoleComposites(role *Role) ([]Role, error)

func (Cx1Client) GetRoles 

func (c Cx1Client) GetRoles() ([]Role, error)

convenience function to get both KeyCloak (system) roles plus the AST-APP-specific roles

func (Cx1Client) GetRolesByClientID 

func (c Cx1Client) GetRolesByClientID(clientId string) ([]Role, error)

func (Cx1Client) GetSASTResultsPredicatesByID added in v0.0.37 

func (c Cx1Client) GetSASTResultsPredicatesByID(SimilarityID string, ProjectID string) ([]SASTResultsPredicates, error)

func (Cx1Client) GetScanByID 

func (c Cx1Client) GetScanByID(scanID string) (Scan, error)

func (Cx1Client) GetScanConfigurationByID added in v0.0.39 

func (c Cx1Client) GetScanConfigurationByID(projectID, scanID string) ([]ConfigurationSetting, error)

func (Cx1Client) GetScanLogsByID 

func (c Cx1Client) GetScanLogsByID(scanID, engine string) ([]byte, error)

func (Cx1Client) GetScanMetadataByID 

func (c Cx1Client) GetScanMetadataByID(scanID string) (ScanMetadata, error)

func (Cx1Client) GetScanResultsByID 

func (c Cx1Client) GetScanResultsByID(scanID string, limit uint64) (ScanResultSet, error)

func (Cx1Client) GetScanResultsCountByID 

func (c Cx1Client) GetScanResultsCountByID(scanID string) (uint64, error)

func (Cx1Client) GetScanSASTResultSummary added in v0.0.37 

func (c Cx1Client) GetScanSASTResultSummary(results *ScanResultSet) ScanResultSummary

func (Cx1Client) GetScanSummariesByID added in v0.0.49 

func (c Cx1Client) GetScanSummariesByID(scanIDs []string) ([]ScanSummary, error)

func (Cx1Client) GetScanSummaryByID 

func (c Cx1Client) GetScanSummaryByID(scanID string) (ScanSummary, error)

func (Cx1Client) GetScanWorkflowByID added in v0.0.11 

func (c Cx1Client) GetScanWorkflowByID(scanID string) ([]WorkflowLog, error)

func (Cx1Client) GetScansByProjectIDAndBranch added in v0.0.80 

func (c Cx1Client) GetScansByProjectIDAndBranch(projectID string, branch string) ([]Scan, error)

func (Cx1Client) GetScansByStatus added in v0.0.49 

func (c Cx1Client) GetScansByStatus(status []string) ([]Scan, error)

func (Cx1Client) GetScansFiltered added in v0.0.49 

func (c Cx1Client) GetScansFiltered(filter ScanFilter) ([]Scan, error)

func (Cx1Client) GetScansSummary added in v0.0.48 

func (c Cx1Client) GetScansSummary() (ScanStatusSummary, error)

func (Cx1Client) GetServiceAccountByID added in v0.0.15 

func (c Cx1Client) GetServiceAccountByID(oidcId string) (User, error)

func (Cx1Client) GetSeverity added in v0.0.66 

func (c Cx1Client) GetSeverity(severity uint) string

func (Cx1Client) GetSeverityID added in v0.0.12 

func (c Cx1Client) GetSeverityID(severity string) uint

convenience

func (Cx1Client) GetTenantID 

func (c Cx1Client) GetTenantID() string

func (Cx1Client) GetTenantName added in v0.0.27 

func (c Cx1Client) GetTenantName() string

func (Cx1Client) GetTenantOwner added in v0.0.55 

func (c Cx1Client) GetTenantOwner() (TenantOwner, error)

func (Cx1Client) GetUploadURL 

func (c Cx1Client) GetUploadURL() (string, error)

func (Cx1Client) GetUserAgent added in v0.0.80 

func (c Cx1Client) GetUserAgent() string

func (Cx1Client) GetUserAppRoles 

func (c Cx1Client) GetUserAppRoles(user *User) ([]Role, error)

func (Cx1Client) GetUserByEmail 

func (c Cx1Client) GetUserByEmail(email string) (User, error)

func (Cx1Client) GetUserByID 

func (c Cx1Client) GetUserByID(userID string) (User, error)

func (Cx1Client) GetUserByUserName 

func (c Cx1Client) GetUserByUserName(name string) (User, error)

func (Cx1Client) GetUserGroups 

func (c Cx1Client) GetUserGroups(user *User) ([]Group, error)

func (Cx1Client) GetUserIAMRoles 

func (c Cx1Client) GetUserIAMRoles(user *User) ([]Role, error)

func (Cx1Client) GetUserRoles 

func (c Cx1Client) GetUserRoles(user *User) ([]Role, error)

New generic functions for roles for convenience

func (Cx1Client) GetUsers 

func (c Cx1Client) GetUsers() ([]User, error)

func (Cx1Client) GetUsersByUserName added in v0.0.54 

func (c Cx1Client) GetUsersByUserName(search string) ([]User, error)

func (Cx1Client) GetVersion added in v0.0.55 

func (c Cx1Client) GetVersion() (VersionInfo, error)
func (c Cx1Client) GroupLink(g *Group) string

func (Cx1Client) ImportPollingByID added in v0.0.14 

func (c Cx1Client) ImportPollingByID(importID string) (string, error)

func (Cx1Client) ImportPollingByIDWithTimeout added in v0.0.25 

func (c Cx1Client) ImportPollingByIDWithTimeout(importID string, delaySeconds, maxSeconds int) (string, error)

func (*Cx1Client) InitializeClient added in v0.0.18 

func (c *Cx1Client) InitializeClient() error

func (Cx1Client) IsEngineAllowed added in v0.0.40 

func (c Cx1Client) IsEngineAllowed(engine string) bool
func (c Cx1Client) PresetLink(p *Preset) string

func (Cx1Client) ProjectInApplicationPollingByID added in v0.0.36 

func (c Cx1Client) ProjectInApplicationPollingByID(projectId, applicationId string) (Project, error)

func (Cx1Client) ProjectInApplicationPollingByIDWithTimeout added in v0.0.36 

func (c Cx1Client) ProjectInApplicationPollingByIDWithTimeout(projectId, applicationId string, delaySeconds, maxSeconds int) (Project, error)
func (c Cx1Client) ProjectLink(p *Project) string

func (Cx1Client) PutFile 

func (c Cx1Client) PutFile(URL string, filename string) (string, error)

func (Cx1Client) PutFileRaw added in v0.0.45 

func (c Cx1Client) PutFileRaw(URL string, filename string) (*http.Response, error)
func (c Cx1Client) QueryGroupLink(q *QueryGroup) string
func (c Cx1Client) QueryLanguageLink(q *QueryLanguage) string
func (c Cx1Client) QueryLink(q *Query) string

func (Cx1Client) QueryTypeApplication added in v0.0.66 

func (c Cx1Client) QueryTypeApplication() string

func (Cx1Client) QueryTypeProduct added in v0.0.66 

func (c Cx1Client) QueryTypeProduct() string

func (Cx1Client) QueryTypeProject added in v0.0.66 

func (c Cx1Client) QueryTypeProject() string

func (Cx1Client) QueryTypeTenant added in v0.0.66 

func (c Cx1Client) QueryTypeTenant() string

func (*Cx1Client) RefreshFlags added in v0.0.18 

func (c *Cx1Client) RefreshFlags() error

func (Cx1Client) RegenerateClientSecret added in v0.0.28 

func (c Cx1Client) RegenerateClientSecret(client OIDCClient) (string, error)

func (Cx1Client) RemoveRoleComposites 

func (c Cx1Client) RemoveRoleComposites(role *Role, roles *[]Role) error

func (Cx1Client) RemoveUserAppRoles 

func (c Cx1Client) RemoveUserAppRoles(user *User, roles *[]Role) error

func (Cx1Client) RemoveUserFromGroupByID 

func (c Cx1Client) RemoveUserFromGroupByID(user *User, groupId string) error

func (Cx1Client) RemoveUserIAMRoles 

func (c Cx1Client) RemoveUserIAMRoles(user *User, roles *[]Role) error

func (Cx1Client) RemoveUserRoles 

func (c Cx1Client) RemoveUserRoles(user *User, roles *[]Role) error

func (Cx1Client) ReportPollingByID added in v0.0.13 

func (c Cx1Client) ReportPollingByID(reportID string) (string, error)

convenience

func (Cx1Client) RequestNewReportByID 

func (c Cx1Client) RequestNewReportByID(scanID, projectID, branch, reportType string) (string, error)

func (Cx1Client) RequestNewReportByIDv2 added in v0.0.82 

func (c Cx1Client) RequestNewReportByIDv2(scanID string, engines []string) (string, error)

the v2 report is the "improved scan report" which can be used the same as the existing RequestNewReportByID returns the report ID which can be passed to GetReportStatusByID or ReportPollingByID 

func (c Cx1Client) RoleLink(r *Role) string

func (Cx1Client) SaveClient added in v0.0.66 

func (c Cx1Client) SaveClient(client OIDCClient) error

The SaveClient function should be used sparingly - it will use the contents of the OIDCClient.OIDCClientRaw variable of type map[string]interface{} in the PUT request. As a result, changes to the member variables in the OIDCClient object itself (creator & clientsecretexpiry) will not be saved using this method unless they are also updated in OIDCClientRaw.

func (Cx1Client) ScanPolling 

func (c Cx1Client) ScanPolling(s *Scan) (Scan, error)

convenience

func (Cx1Client) ScanPollingDetailed added in v0.0.12 

func (c Cx1Client) ScanPollingDetailed(s *Scan) (Scan, error)

func (Cx1Client) ScanPollingWithTimeout added in v0.0.25 

func (c Cx1Client) ScanPollingWithTimeout(s *Scan, detailed bool, delaySeconds, maxSeconds int) (Scan, error)

func (Cx1Client) ScanProjectByID 

func (c Cx1Client) ScanProjectByID(projectID, sourceUrl, branch, scanType string, settings []ScanConfiguration, tags map[string]string) (Scan, error)

convenience function

func (Cx1Client) ScanProjectGitByID 

func (c Cx1Client) ScanProjectGitByID(projectID, repoUrl, branch string, settings []ScanConfiguration, tags map[string]string) (Scan, error)

func (Cx1Client) ScanProjectZipByID 

func (c Cx1Client) ScanProjectZipByID(projectID, sourceUrl, branch string, settings []ScanConfiguration, tags map[string]string) (Scan, error)

func (*Cx1Client) SetClientVars added in v0.0.19 

func (c *Cx1Client) SetClientVars(clientvars ClientVars)

func (Cx1Client) SetGroupParent 

func (c Cx1Client) SetGroupParent(g *Group, parent *Group) error

func (Cx1Client) SetProjectBranchByID 

func (c Cx1Client) SetProjectBranchByID(projectID, branch string, allowOverride bool) error

func (Cx1Client) SetProjectFileFilterByID 

func (c Cx1Client) SetProjectFileFilterByID(projectID, filter string, allowOverride bool) error

func (Cx1Client) SetProjectLanguageModeByID 

func (c Cx1Client) SetProjectLanguageModeByID(projectID, languageMode string, allowOverride bool) error

func (Cx1Client) SetProjectPresetByID 

func (c Cx1Client) SetProjectPresetByID(projectID, presetName string, allowOverride bool) error

func (Cx1Client) SetProjectRepositoryByID added in v0.0.56 

func (c Cx1Client) SetProjectRepositoryByID(projectID, repository string, allowOverride bool) error

func (Cx1Client) SetUserAgent added in v0.0.80 

func (c Cx1Client) SetUserAgent(ua string)

func (Cx1Client) SetUserAgentFirefox added in v0.0.80 

func (c Cx1Client) SetUserAgentFirefox()

this function set the U-A to be the old one that was previously default in Cx1ClientGo

func (Cx1Client) StartImport added in v0.0.14 

func (c Cx1Client) StartImport(dataFilename, mappingFilename, encryptionKey string) (string, error)

func (Cx1Client) StartMigration added in v0.0.14 

func (c Cx1Client) StartMigration(dataArchive, projectMapping []byte, encryptionKey string) (string, error)

func (Cx1Client) String 

func (c Cx1Client) String() string

func (Cx1Client) UpdateApplication 

func (c Cx1Client) UpdateApplication(app *Application) error

func (Cx1Client) UpdateGroup 

func (c Cx1Client) UpdateGroup(g *Group) error

func (Cx1Client) UpdatePreset 

func (c Cx1Client) UpdatePreset(preset *Preset) error

func (Cx1Client) UpdateProject 

func (c Cx1Client) UpdateProject(project *Project) error

func (Cx1Client) UpdateProjectConfiguration 

func (c Cx1Client) UpdateProjectConfiguration(project *Project, settings []ConfigurationSetting) error

UpdateProjectConfiguration updates the configuration of the project addressed by projectID

func (Cx1Client) UpdateProjectConfigurationByID 

func (c Cx1Client) UpdateProjectConfigurationByID(projectID string, settings []ConfigurationSetting) error

func (Cx1Client) UpdateQueries_v310 added in v0.0.66 

func (c Cx1Client) UpdateQueries_v310(level, levelid string, queries []QueryUpdate_v310) error

func (Cx1Client) UpdateQuery added in v0.0.11 

func (c Cx1Client) UpdateQuery(auditSession *AuditSession, query *Query) error

convenience/wrapper function

func (Cx1Client) UpdateQueryMetadata added in v0.0.67 

func (c Cx1Client) UpdateQueryMetadata(auditSession *AuditSession, query *Query, metadata AuditQueryMetadata) (Query, error)

func (Cx1Client) UpdateQueryMetadataByKey added in v0.0.66 

func (c Cx1Client) UpdateQueryMetadataByKey(auditSession *AuditSession, queryKey string, metadata AuditQueryMetadata) (Query, error)

This function will update the query metadata, however currently only the Severity of a query can be changed. Changes to CWE, description, and other fields will not take effect. Also, the data returned by the query-editor api does not include the query ID, so it will be 0. Use "UpdateQueryMetadata" wrapper instead to address that.

func (Cx1Client) UpdateQuerySource added in v0.0.67 

func (c Cx1Client) UpdateQuerySource(auditSession *AuditSession, query *Query, source string) (Query, error)

func (Cx1Client) UpdateQuerySourceByKey added in v0.0.66 

func (c Cx1Client) UpdateQuerySourceByKey(auditSession *AuditSession, queryKey, source string) (Query, error)

The data returned by the query-editor api does not include the query ID, so it will be 0. Use "UpdateQueryMetadata" wrapper instead to address that.

func (Cx1Client) UpdateQuery_v310 added in v0.0.66 

func (c Cx1Client) UpdateQuery_v310(query AuditQuery_v310) error

updating queries via PUT is possible, but only allows changing the source code, not metadata around each query. this will be fixed in the future PUT is the only option to create an override on the project-level (and maybe in the future on application-level)

func (Cx1Client) UpdateUser 

func (c Cx1Client) UpdateUser(user *User) error

func (Cx1Client) UploadBytes added in v0.0.9 

func (c Cx1Client) UploadBytes(fileContents *[]byte) (string, error)

creates upload URL, uploads, returns upload URL

func (Cx1Client) UploadBytesForProjectByID added in v0.0.9 

func (c Cx1Client) UploadBytesForProjectByID(projectID string, fileContents *[]byte) (string, error)

func (Cx1Client) UserIsTenantOwner added in v0.0.55 

func (c Cx1Client) UserIsTenantOwner(u *User) (bool, error)
func (c Cx1Client) UserLink(u *User) string

func (Cx1Client) Whoami added in v0.0.15 

func (c Cx1Client) Whoami() (WhoAmI, error)

this no longer works as of 2024-09-13 / version 3.21.5

type Cx1LongTime added in v0.0.74 

type Cx1LongTime struct {
	time.Time
}

func (*Cx1LongTime) UnmarshalJSON added in v0.0.74 

func (ct *Cx1LongTime) UnmarshalJSON(b []byte) (err error)

type DataImport added in v0.0.14 

type DataImport struct {
	MigrationId string             `json:"migrationId"`
	Status      string             `json:"status"`
	CreatedAt   string             `json:"createdAt"`
	Logs        []DataImportStatus `json:"logs"`
}

type DataImportStatus added in v0.0.20 

type DataImportStatus struct {
	Level   string `json:"level"`
	Message string `json:"msg"`
	Error   string `json:"error"`
	Worker  string `json:"worker"`
	RawLog  string `json:"raw_log"`
}

type Group 

type Group struct {
	GroupID       string              `json:"id"`
	Name          string              `json:"name"`
	Path          string              `json:"path"`
	SubGroups     []Group             `json:"subGroups"`
	SubGroupCount int                 `json:"subGroupCount"`
	ClientRoles   map[string][]string `json:"clientRoles"`
	Filled        bool                `json:"-"`
}

func RemoveGroup added in v0.0.11 

func RemoveGroup(slice []Group, index int) []Group

func RemoveGroupByID added in v0.0.11 

func RemoveGroupByID(slice []Group, ID string) []Group

func (*Group) AddRole added in v0.0.16 

func (g *Group) AddRole(clientName, roleName string) error

func (*Group) FindSubgroupByName 

func (g *Group) FindSubgroupByName(name string) (Group, error)

func (*Group) RemoveRole added in v0.0.16 

func (g *Group) RemoveRole(clientName, roleName string) error

func (*Group) String 

func (g *Group) String() string

type KICSResultsPredicates added in v0.0.37 

type KICSResultsPredicates struct {
	ResultsPredicatesBase // actually the same structure but different endpoint
}

type OIDCClient added in v0.0.15 

type OIDCClient struct {
	ID                 string                 `json:"id"`
	ClientID           string                 `json:"clientId"`
	Enabled            bool                   `json:"enabled"`
	ClientSecret       string                 `json:"secret"`
	ClientSecretExpiry uint64                 `json:"-"`
	Creator            string                 `json:"-"`
	OIDCClientRaw      map[string]interface{} `json:"-"`
}

func (OIDCClient) String added in v0.0.54 

func (client OIDCClient) String() string

type OIDCClientScope added in v0.0.15 

type OIDCClientScope struct {
	ID          string `json:"id"`
	Name        string `json:"name"`
	Description string `json:"description"`
	Protocol    string `json:"protocol"`
}

type Preset 

type Preset struct {
	PresetID    uint64 `json:"id"`
	Name        string `json:"name"`
	Description string `json:"description"`
	Custom      bool   `json:"custom"`
	QueryIDs    []uint64
	Filled      bool
	Queries     []Query `json:"-"`
}

func (*Preset) AddQueryID 

func (p *Preset) AddQueryID(queryId uint64)

func (*Preset) LinkQueries added in v0.0.59 

func (p *Preset) LinkQueries(qc *QueryCollection)

func (*Preset) String 

func (p *Preset) String() string

type Project 

type Project struct {
	ProjectID     string                 `json:"id"`
	Name          string                 `json:"name"`
	CreatedAt     string                 `json:"createdAt"`
	UpdatedAt     string                 `json:"updatedAt"`
	Groups        []string               `json:"groups"`
	Applications  []string               `json:"applicationIds"`
	Tags          map[string]string      `json:"tags"`
	RepoUrl       string                 `json:"repoUrl"`
	MainBranch    string                 `json:"mainBranch"`
	Origin        string                 `json:"origin"`
	Criticality   uint                   `json:"criticality"`
	Configuration []ConfigurationSetting `json:"-"`
}

func (*Project) AssignGroup 

func (p *Project) AssignGroup(group *Group)

func (Project) GetConfigurationByName added in v0.0.9 

func (p Project) GetConfigurationByName(configKey string) *ConfigurationSetting

func (*Project) GetTags 

func (p *Project) GetTags() string

func (*Project) IsInGroup 

func (p *Project) IsInGroup(group *Group) bool

func (*Project) IsInGroupID 

func (p *Project) IsInGroupID(groupId string) bool

convenience

func (*Project) String 

func (p *Project) String() string

type ProjectBranchFilter added in v0.0.80 

type ProjectBranchFilter struct {
	ProjectID string `json:"project-id,omitempty"`
	Limit     int    `json:"limit,omitempty"`
	Offset    int    `json:"offset,omitempty"`
	Name      string `json:"branch-name,omitempty"`
}

func (ProjectBranchFilter) AddURLValues added in v0.0.80 

func (f ProjectBranchFilter) AddURLValues(params *url.Values)

type Query 

type Query struct {
	QueryID            uint64 `json:"queryID,string"`
	Level              string `json:"level"`
	LevelID            string `json:"levelId"`
	Path               string `json:"path"`
	Modified           string `json:"-"`
	Source             string `json:"-"`
	Name               string `json:"queryName"`
	Group              string `json:"group"`
	Language           string `json:"language"`
	Severity           string `json:"severity"`
	CweID              int64  `json:"cweID"`
	IsExecutable       bool   `json:"isExecutable"`
	QueryDescriptionId int64  `json:"queryDescriptionId"`
	Custom             bool   `json:"custom"`
	EditorKey          string `json:"key"`
	SastID             uint64 `json:"sastId"`
}

func (*Query) CalculateEditorKey added in v0.0.66 

func (q *Query) CalculateEditorKey() string

func (*Query) CalculateQueryID added in v0.0.66 

func (q *Query) CalculateQueryID() (uint64, error)

func (Query) GetMetadata added in v0.0.66 

func (q Query) GetMetadata() AuditQueryMetadata

func (*Query) MergeQuery added in v0.0.66 

func (q *Query) MergeQuery(nq Query)

func (Query) String 

func (q Query) String() string

func (Query) StringDetailed added in v0.0.66 

func (q Query) StringDetailed() string

func (Query) ToAuditQuery_v310 added in v0.0.69 

func (q Query) ToAuditQuery_v310() AuditQuery_v310

type QueryCollection 

type QueryCollection struct {
	QueryLanguages []QueryLanguage
}

func (*QueryCollection) AddAuditQueries_v310 added in v0.0.66 

func (qc *QueryCollection) AddAuditQueries_v310(queries *[]AuditQuery_v310)

func (*QueryCollection) AddQueries added in v0.0.66 

func (qc *QueryCollection) AddQueries(queries *[]Query)

func (*QueryCollection) AddQuery added in v0.0.66 

func (qc *QueryCollection) AddQuery(q Query)

func (*QueryCollection) GetCustomQueryCollection added in v0.0.66 

func (qc *QueryCollection) GetCustomQueryCollection() QueryCollection

func (QueryCollection) GetQueryByID 

func (qc QueryCollection) GetQueryByID(qid uint64) *Query

func (QueryCollection) GetQueryByLevelAndID added in v0.0.66 

func (qc QueryCollection) GetQueryByLevelAndID(level, levelID string, qid uint64) *Query

func (QueryCollection) GetQueryByLevelAndName added in v0.0.66 

func (qc QueryCollection) GetQueryByLevelAndName(level, levelID, language, group, query string) *Query

func (QueryCollection) GetQueryByName 

func (qc QueryCollection) GetQueryByName(language, group, query string) *Query

func (*QueryCollection) GetQueryCount added in v0.0.66 

func (qc *QueryCollection) GetQueryCount() uint

func (QueryCollection) GetQueryLanguageByName 

func (qc QueryCollection) GetQueryLanguageByName(language string) *QueryLanguage

func (*QueryCollection) UpdateNewQuery added in v0.0.66 

func (qc *QueryCollection) UpdateNewQuery(query *Query) error

This function may not be necessary in the future, it is used to fill in missing fields when creating new queries

type QueryGroup 

type QueryGroup struct {
	Name     string
	Language string
	Queries  []Query
}

func (QueryGroup) GetQueryByID added in v0.0.66 

func (qg QueryGroup) GetQueryByID(qid uint64) *Query

func (QueryGroup) GetQueryByLevelAndID added in v0.0.66 

func (qg QueryGroup) GetQueryByLevelAndID(level, levelID string, qid uint64) *Query

func (QueryGroup) GetQueryByLevelAndName added in v0.0.66 

func (qg QueryGroup) GetQueryByLevelAndName(level, levelID, name string) *Query

func (QueryGroup) GetQueryByName 

func (qg QueryGroup) GetQueryByName(name string) *Query

func (QueryGroup) String 

func (q QueryGroup) String() string

type QueryLanguage 

type QueryLanguage struct {
	Name        string
	QueryGroups []QueryGroup
}

func (QueryLanguage) GetQueryByID added in v0.0.66 

func (ql QueryLanguage) GetQueryByID(qid uint64) *Query

func (QueryLanguage) GetQueryByLevelAndID added in v0.0.66 

func (ql QueryLanguage) GetQueryByLevelAndID(level, levelID string, qid uint64) *Query

func (QueryLanguage) GetQueryGroupByName 

func (ql QueryLanguage) GetQueryGroupByName(name string) *QueryGroup

func (QueryLanguage) String 

func (q QueryLanguage) String() string

type QueryUpdateMetadata_v310 added in v0.0.69 

type QueryUpdateMetadata_v310 struct {
	Severity uint `json:"severity"`
}

type QueryUpdate_v310 added in v0.0.69 

type QueryUpdate_v310 struct {
	Name     string `json:"name"`
	Path     string `json:"path"`
	Source   string `json:"source"`
	Language string `json:"-"`
	Group    string `json:"-"`

	Metadata QueryUpdateMetadata_v310 `json:"metadata"`
}

type ReportStatus 

type ReportStatus struct {
	ReportID  string `json:"reportId"`
	Status    string `json:"status"`
	ReportURL string `json:"url"`
}

type ResultsPredicatesBase added in v0.0.37 

type ResultsPredicatesBase struct {
	PredicateID  string `json:"ID"`
	SimilarityID string `json:"similarityId"`
	ProjectID    string `json:"projectId"`
	State        string `json:"state"`
	Comment      string `json:"comment"`
	Severity     string `json:"severity"`
	CreatedBy    string `json:"createdBy"`
	CreatedAt    string `json:"createdAt"`
}

func (*ResultsPredicatesBase) Update added in v0.0.37 

func (p *ResultsPredicatesBase) Update(state, severity, comment string)

convenience function

type Role 

type Role struct {
	ClientID    string `json:"containerId"` // the 'client' in Keycloak - AST roles with have the "ast-app" client ID
	RoleID      string `json:"id"`
	Name        string `json:"name"`
	Description string `json:"description"`
	Attributes  struct {
		Creator    []string
		Type       []string
		Category   []string
		LastUpdate []string // it is returned as [ "uint",... ]
	} `json:"attributes"`
	Composite  bool   `json:"composite"`
	ClientRole bool   `json:"clientRole"`
	SubRoles   []Role `json:"-"`
}

func RemoveRole added in v0.0.11 

func RemoveRole(slice []Role, index int) []Role

func RemoveRoleByID added in v0.0.11 

func RemoveRoleByID(slice []Role, ID string) []Role

func (*Role) HasCategory 

func (r *Role) HasCategory(name string) bool

func (*Role) HasRole 

func (r *Role) HasRole(name string) bool

func (*Role) String 

func (r *Role) String() string

type RunningScan 

type RunningScan struct {
	ScanID    string
	Status    string
	ProjectID string
	CreatedAt time.Time
	UpdatedAt time.Time
}

type SASTResultsPredicates added in v0.0.37 

type SASTResultsPredicates struct {
	ResultsPredicatesBase // actually the same structure but different endpoint
}

type Scan 

type Scan struct {
	ScanID        string              `json:"id"`
	Status        string              `json:"status"`
	StatusDetails []ScanStatusDetails `json:"statusDetails"`
	Branch        string              `json:"branch"`
	CreatedAt     string              `json:"createdAt"`
	UpdatedAt     string              `json:"updatedAt"`
	ProjectID     string              `json:"projectId"`
	ProjectName   string              `json:"projectName"`
	UserAgent     string              `json:"userAgent"`
	Initiator     string              `json:"initiator"`
	Tags          map[string]string   `json:"tags"`
	Metadata      struct {
		Type    string              `json:"type"`
		Configs []ScanConfiguration `json:"configs"`
	} `json:"metadata"`
	Engines      []string `json:"engines"`
	SourceType   string   `json:"sourceType"`
	SourceOrigin string   `json:"sourceOrigin"`
}

func (*Scan) IsIncremental 

func (s *Scan) IsIncremental() (bool, error)

convenience function

func (*Scan) String 

func (s *Scan) String() string

type ScanConfiguration 

type ScanConfiguration struct {
	ScanType string            `json:"type"`
	Values   map[string]string `json:"value"`
}

type ScanFilter added in v0.0.13 

type ScanFilter struct {
	ProjectID string    `json:"project-id"`
	Limit     int       `json:"limit,omitempty"`
	Offset    int       `json:"offset,omitempty"`
	Sort      string    `json:"sort,omitempty"`
	TagKeys   []string  `json:"tags-keys,omitempty"`
	TagValues []string  `json:"tags-values,omitempty"`
	Statuses  []string  `json:"statuses,omitempty"`
	Branches  []string  `json:"branches,omitempty"`
	FromDate  time.Time `json:"from-date,omitempty"`
	ToDate    time.Time `json:"to-date,omitempty"`
}

func (ScanFilter) AddURLValues added in v0.0.13 

func (f ScanFilter) AddURLValues(params *url.Values)

type ScanKICSResult added in v0.0.34 

type ScanKICSResult struct {
	ScanResultBase
	Data ScanKICSResultData
}

func (ScanKICSResult) CreateResultsPredicate added in v0.0.37 

func (r ScanKICSResult) CreateResultsPredicate(projectId string) KICSResultsPredicates

func (ScanKICSResult) String added in v0.0.34 

func (r ScanKICSResult) String() string

type ScanKICSResultData added in v0.0.34 

type ScanKICSResultData struct {
	QueryID       string
	QueryName     string
	Group         string
	QueryURL      string
	FileName      string
	Line          int
	Platform      string
	IssueType     string
	ExpectedValue string
	Value         string
}

type ScanMetadata 

type ScanMetadata struct {
	ScanID                string
	ProjectID             string
	LOC                   uint64
	FileCount             uint64
	IsIncremental         bool
	IsIncrementalCanceled bool
	PresetName            string `json:"queryPreset"`
}

type ScanResultBase added in v0.0.37 

type ScanResultBase struct {
	Type            string
	ResultID        string `json:"id"`
	SimilarityID    string `json:"similarityId"`
	Status          string
	State           string
	Severity        string
	ConfidenceLevel int    `json:"confidenceLevel"`
	CreatedAt       string `json:"created"`
	FirstFoundAt    string
	FoundAt         string
	FirstScanId     string
	Description     string
}

generic data common to all

type ScanResultSet added in v0.0.34 

type ScanResultSet struct {
	SAST         []ScanSASTResult
	SCA          []ScanSCAResult
	SCAContainer []ScanSCAContainerResult
	KICS         []ScanKICSResult
}

func (ScanResultSet) String added in v0.0.46 

func (s ScanResultSet) String() string

type ScanResultStatusSummary 

type ScanResultStatusSummary struct {
	ToVerify               uint64
	NotExploitable         uint64
	Confirmed              uint64
	ProposedNotExploitable uint64
	Urgent                 uint64
}

func (ScanResultStatusSummary) String 

func (s ScanResultStatusSummary) String() string

func (ScanResultStatusSummary) Total 

func (s ScanResultStatusSummary) Total() uint64

type ScanResultSummary 

type ScanResultSummary struct {
	High        ScanResultStatusSummary
	Medium      ScanResultStatusSummary
	Low         ScanResultStatusSummary
	Information ScanResultStatusSummary
}

func (ScanResultSummary) String 

func (s ScanResultSummary) String() string

type ScanSASTResult added in v0.0.34 

type ScanSASTResult struct {
	ScanResultBase
	Data                 ScanSASTResultData
	VulnerabilityDetails ScanSASTResultDetails
}

func (ScanSASTResult) CreateResultsPredicate added in v0.0.37 

func (r ScanSASTResult) CreateResultsPredicate(projectId string) SASTResultsPredicates

convenience function

func (ScanSASTResult) String added in v0.0.34 

func (r ScanSASTResult) String() string

type ScanSASTResultData added in v0.0.34 

type ScanSASTResultData struct {
	QueryID      uint64
	QueryName    string
	Group        string
	ResultHash   string
	LanguageName string
	Nodes        []ScanSASTResultNodes
}

type ScanSASTResultDetails added in v0.0.34 

type ScanSASTResultDetails struct {
	CweId       int
	Compliances []string
}

type ScanSASTResultNodes added in v0.0.34 

type ScanSASTResultNodes struct {
	ID          string
	Line        uint64
	Name        string
	Column      uint64
	Length      uint64
	Method      string
	NodeID      uint64
	DOMType     string
	FileName    string
	FullName    string
	TypeName    string
	MethodLine  uint64
	Definitions string
}

type ScanSCAContainerResult added in v0.0.46 

type ScanSCAContainerResult struct {
	ScanResultBase
	Data                 ScanSCAContainerResultData `json:"data"`
	VulnerabilityDetails ScanSCAResultDetails
}

type ScanSCAContainerResultData added in v0.0.46 

type ScanSCAContainerResultData struct {
	Metadata struct {
		Enrichers []string `json:"enrichers"`
	} `json:"metadata"`
	PackageName    string `json:"packageName"`
	PackageVersion string `json:"packageVersion"`
	PublishedAt    string `json:"publishedAt"`
}

type ScanSCAResult added in v0.0.34 

type ScanSCAResult struct {
	ScanResultBase
	Data                 ScanSCAResultData `json:"data"`
	VulnerabilityDetails ScanSCAResultDetails
}

func (ScanSCAResult) String added in v0.0.34 

func (r ScanSCAResult) String() string

type ScanSCAResultCVSS added in v0.0.34 

type ScanSCAResultCVSS struct {
	Version          int
	AttackVector     string
	Availability     string
	Confidentiality  string
	AttackComplexity string
}

type ScanSCAResultData added in v0.0.34 

type ScanSCAResultData struct {
	PackageIdentifier  string
	PublishedAt        string
	Recommendation     string
	RecommendedVersion string
	//ExploitableMethods // TODO
	PackageData []ScanSCAResultPackageData
}

func (ScanSCAResultData) GetType added in v0.0.34 

func (r ScanSCAResultData) GetType(packageDataType string) ScanSCAResultPackageData

type ScanSCAResultDetails added in v0.0.34 

type ScanSCAResultDetails struct {
	CweId     string
	CVSSScore float64
	CveName   string
	Cvss      ScanSCAResultCVSS
}

type ScanSCAResultPackageData added in v0.0.34 

type ScanSCAResultPackageData struct {
	URL     string
	Type    string
	Comment string
}

type ScanStatusDetails 

type ScanStatusDetails struct {
	Name    string `json:"name"`
	Status  string `json:"status"`
	Details string `json:"details"`
}

type ScanStatusSummary added in v0.0.48 

type ScanStatusSummary struct {
	Canceled  uint64
	Completed uint64
	Partial   uint64
	Queued    uint64
	Failed    uint64
	Running   uint64
}

func (ScanStatusSummary) String added in v0.0.48 

func (s ScanStatusSummary) String() string

type ScanSummary 

type ScanSummary struct {
	TenantID     string
	ScanID       string
	SASTCounters struct {
		//QueriesCounters           []?
		//SinkFileCounters          []?
		LanguageCounters []struct {
			Language string
			Counter  uint64
		}
		ComplianceCounters []struct {
			Compliance string
			Counter    uint64
		}
		SeverityCounters []struct {
			Severity string
			Counter  uint64
		}
		StatusCounters []struct {
			Status  string
			Counter uint64
		}
		StateCounters []struct {
			State   string
			Counter uint64
		}
		TotalCounter        uint64
		FilesScannedCounter uint64
	}
}

Very simplified for now

func (*ScanSummary) TotalCount 

func (s *ScanSummary) TotalCount() uint64

type Status 

type Status struct {
	ID      int               `json:"id"`
	Name    string            `json:"name"`
	Details ScanStatusDetails `json:"details"`
}

type TenantOwner added in v0.0.55 

type TenantOwner struct {
	Username  string
	Firstname string
	Lastname  string
	Email     string
	UserID    string `json:"id"`
}

type User 

type User struct {
	Enabled      bool        `json:"enabled"`
	UserID       string      `json:"id,omitempty"`
	FirstName    string      `json:"firstName"`
	LastName     string      `json:"lastName"`
	UserName     string      `json:"username"`
	Email        string      `json:"email"`
	LastLogin    Cx1LongTime `json:"-"`
	Groups       []Group     `json:"-"` // only returned from /users/{id}/groups. Use GetUserGroups to fill.
	FilledGroups bool        `json:"-"` // indicates if the user object has had the Groups array filled.
	Roles        []Role      `json:"-"` // only returned from /users/{id}/role-mappings. Use GetUserRoles to fill.
	FilledRoles  bool        `json:"-"` // indicates if the user object has had the Roles array filled.
}

func (*User) AddGroup added in v0.0.11 

func (u *User) AddGroup(client *Cx1Client, group *Group) error

func (User) Delete added in v0.0.11 

func (u User) Delete(client *Cx1Client) error

func (User) HasRole 

func (u User) HasRole(role *Role) (bool, error)

func (User) HasRoleByID 

func (u User) HasRoleByID(roleID string) (bool, error)

func (User) HasRoleByName 

func (u User) HasRoleByName(role string) (bool, error)

func (User) IsInGroup 

func (u User) IsInGroup(group *Group) (bool, error)

func (User) IsInGroupByID 

func (u User) IsInGroupByID(groupId string) (bool, error)

func (User) IsInGroupByName 

func (u User) IsInGroupByName(groupName string) (bool, error)
func (u User) Link(client *Cx1Client) string

func (User) Save added in v0.0.11 

func (u User) Save(client *Cx1Client) error

func (User) String 

func (u User) String() string

type UserWithAttributes added in v0.0.74 

type UserWithAttributes struct {
	User
	Attributes struct {
		LastLogin []Cx1LongTime `json:"lastLogin"`
	} `json:"attributes"`
}

type VersionInfo added in v0.0.55 

type VersionInfo struct {
	CxOne string
	KICS  string
	SAST  string
}

func (VersionInfo) CheckCxOne added in v0.0.66 

func (v VersionInfo) CheckCxOne(version string) int

version check returns -1 (current cx1 version lower), 0 (equal), 1 (current cx1 version greater)

func (VersionInfo) String added in v0.0.55 

func (v VersionInfo) String() string

type WhoAmI added in v0.0.15 

type WhoAmI struct {
	UserID string `json:"userId"`
	Name   string `json:"displayName"`
}

func (WhoAmI) String added in v0.0.15 

func (u WhoAmI) String() string

type WorkflowLog 

type WorkflowLog struct {
	Source    string `json:"Source"`
	Info      string `json:"Info"`
	Timestamp string `json:"Timestamp"`
}

Source Files

View all Source files

Directories

Path Synopsis
_examples
MigrationImport command

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.