config

package
v1.1.86 Latest Latest
Warning

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

 Go to latest Published: Jun 13, 2024 License: Apache-2.0 Imports: 27 Imported by: 35

Documentation

Index

Constants

View Source 
const (
	ManualApproval  string = "manual"
	AutoApproval    string = "auto"
	WebhookApproval string = "webhook"
)

subscription approval types

View Source 
const (
	AccessToken             = "accessToken"
	Client                  = "client"
	ClientSecretBasic       = "client_secret_basic"
	ClientSecretPost        = "client_secret_post"
	ClientSecretJWT         = "client_secret_jwt"
	PrivateKeyJWT           = "private_key_jwt"
	TLSClientAuth           = "tls_client_auth"
	SelfSignedTLSClientAuth = "self_signed_tls_client_auth"
)
View Source 
const (
	NotifySMTP    = NotificationType("SMTP")
	NotifyWebhook = NotificationType("WEBHOOK")
)

NotificationTypes

View Source 
const (
	AnonymousAuth = SMTPAuthType("ANONYMOUS")
	LoginAuth     = SMTPAuthType("LOGIN")
	PlainAuth     = SMTPAuthType("PLAIN")
	NoAuth        = SMTPAuthType("NONE")
)

SMTPAuthTypes -

Variables

View Source 
var (
	ErrBadConfig                 = configerrors.Newf(1401, "error with config %v, please set and/or check its value")
	ErrEnvConfigOverride         = configerrors.New(1402, "error in overriding configuration using environment variables")
	ErrStatusHealthCheckPeriod   = configerrors.New(1403, "invalid value for statusHealthCheckPeriod. Value must be between 1 and 5 minutes")
	ErrStatusHealthCheckInterval = configerrors.New(1404, "invalid value for statusHealthCheckInterval. Value must be between 30 seconds and 5 minutes")
	ErrReadingKeyFile            = configerrors.Newf(1405, "could not read the %v key file %v")
	ErrServiceAccount            = configerrors.New(1406, "using a DOSA_* service account with Marketplace Provisioning is unsupported")
)

Errors hit when validating or parsing config

View Source 
var AgentDataPlaneType string

AgentDataPlaneType - Holds the data plane type of agent

View Source 
var AgentDisplayName string

AgentDisplayName - Holds the name Agent name for displaying in version command or elsewhere

View Source 
var AgentLatestVersion string

AgentLatestVersion - Holds the latest version of the agent

View Source 
var AgentTypeName string

AgentTypeName - Holds the name Agent type

View Source 
var AgentVersion string

AgentVersion - Holds the version of agent

View Source 
var SDKVersion string

SDKVersion - Holds the version of SDK

View Source 
var TLSDefaultCipherSuites = []TLSCipherSuite{
	TLSCipherSuite(tls.TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384),
	TLSCipherSuite(tls.TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384),
	TLSCipherSuite(tls.TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305),
	TLSCipherSuite(tls.TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305),
	TLSCipherSuite(tls.TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256),
	TLSCipherSuite(tls.TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256),
	TLSCipherSuite(tls.TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256),
	TLSCipherSuite(tls.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256),
}

TLSDefaultCipherSuites - list of suites to use by default

Functions

func AddAgentFeaturesConfigProperties 

func AddAgentFeaturesConfigProperties(props properties.Properties)

AddAgentFeaturesConfigProperties - Adds the command properties needed for Agent Features Config

func AddCategoryConfigProperties 

func AddCategoryConfigProperties(props properties.Properties, basePath string)

AddCategoryConfigProperties -

func AddCentralConfigProperties 

func AddCentralConfigProperties(props properties.Properties, agentType AgentType)

AddCentralConfigProperties - Adds the command properties needed for Central Config

func AddLogConfigProperties 

func AddLogConfigProperties(props properties.Properties, defaultFileName string)

AddLogConfigProperties - Adds the command properties needed for Log Config

func AddMetricLogConfigProperties added in v1.1.80 

func AddMetricLogConfigProperties(props properties.Properties, agentType AgentType)

AddMetricLogConfigProperties - Adds the command properties needed for Log Config

func AddMigrationConfigProperties 

func AddMigrationConfigProperties(props properties.Properties)

AddMigrationConfigProperties - Adds the command properties needed for Migration Config

func AddStatusConfigProperties 

func AddStatusConfigProperties(props properties.Properties)

AddStatusConfigProperties - Adds the command properties needed for Status Config

func AddSubscriptionConfigProperties 

func AddSubscriptionConfigProperties(props properties.Properties)

AddSubscriptionConfigProperties -

func AddUsageConfigProperties added in v1.1.83 

func AddUsageConfigProperties(props properties.Properties, agentType AgentType)

func AddUsageReportingProperties 

func AddUsageReportingProperties(props properties.Properties)

AddUsageReportingProperties - Adds the command properties needed for Usage Reporting Settings

func IsCategoryAutocreationEnabled 

func IsCategoryAutocreationEnabled() bool

IsCategoryAutocreationEnabled - return true when the global auto creation of categories is enabled

func IsMappingConfigured 

func IsMappingConfigured() bool

IsMappingConfigured - return true when category mappings have been configured

func LogConfigOverrides 

func LogConfigOverrides() []cfgfile.ConditionalOverride

LogConfigOverrides - override the filebeat config options

func TLSDefaultCipherSuitesStringSlice 

func TLSDefaultCipherSuitesStringSlice() []string

TLSDefaultCipherSuitesStringSlice - list of suites to use by default

func TLSDefaultMinVersionString 

func TLSDefaultMinVersionString() string

TLSDefaultMinVersionString - get the default min version string

func ValidateConfig 

func ValidateConfig(cfg interface{}) error

ValidateConfig - Validates the agent config Uses reflection to get the IConfigValidator interface on the config struct or struct variable. Makes call to ValidateCfg method except if the struct variable is of CentralConfig type as the validation for CentralConfig is already done during parseCentralConfig

Types

type AgentFeaturesConfig 

type AgentFeaturesConfig interface {
	ConnectionToCentralEnabled() bool
	ProcessSystemSignalsEnabled() bool
	VersionCheckerEnabled() bool
	PersistCacheEnabled() bool
	MarketplaceProvisioningEnabled() bool
	GetExternalIDPConfig() ExternalIDPConfig
	AgentStatusUpdatesEnabled() bool
}

AgentFeaturesConfig - Interface to get agent features Config

func NewAgentFeaturesConfiguration 

func NewAgentFeaturesConfiguration() AgentFeaturesConfig

NewAgentFeaturesConfiguration - Creates the default agent features config

func ParseAgentFeaturesConfig 

func ParseAgentFeaturesConfig(props properties.Properties) (AgentFeaturesConfig, error)

ParseAgentFeaturesConfig - Parses the AgentFeatures Config values from the command line

type AgentFeaturesConfiguration 

type AgentFeaturesConfiguration struct {
	AgentFeaturesConfig
	IConfigValidator
	ConnectToCentral        bool              `config:"connectToCentral"`
	ProcessSystemSignals    bool              `config:"processSystemSignals"`
	VersionChecker          bool              `config:"versionChecker"`
	PersistCache            bool              `config:"persistCache"`
	MarketplaceProvisioning bool              `config:"marketplaceProvisioning"`
	ExternalIDPConfig       ExternalIDPConfig `config:"idp"`
	AgentStatusUpdates      bool              `config:"agentStatusUpdates"`
}

AgentFeaturesConfiguration - Structure to hold the agent features config

func (*AgentFeaturesConfiguration) AgentStatusUpdatesEnabled 

func (c *AgentFeaturesConfiguration) AgentStatusUpdatesEnabled() bool

AgentStatusUpdatesEnabled - True if the agent SDK should manage the status update.

func (*AgentFeaturesConfiguration) ConnectionToCentralEnabled 

func (c *AgentFeaturesConfiguration) ConnectionToCentralEnabled() bool

ConnectionToCentralEnabled - True if the agent is a standard agent that connects to Central

func (*AgentFeaturesConfiguration) GetExternalIDPConfig 

func (c *AgentFeaturesConfiguration) GetExternalIDPConfig() ExternalIDPConfig

GetExternalIDPConfig - returns the config for external IdP providers

func (*AgentFeaturesConfiguration) MarketplaceProvisioningEnabled 

func (c *AgentFeaturesConfiguration) MarketplaceProvisioningEnabled() bool

MarketplaceProvisioningEnabled - True if the agent SDK should handle marketplace subscriptions.

func (*AgentFeaturesConfiguration) PersistCacheEnabled 

func (c *AgentFeaturesConfiguration) PersistCacheEnabled() bool

PersistCacheEnabled - True if the agent SDK should use persistence for agent cache.

func (*AgentFeaturesConfiguration) ProcessSystemSignalsEnabled 

func (c *AgentFeaturesConfiguration) ProcessSystemSignalsEnabled() bool

ProcessSystemSignalsEnabled - True if the agent SDK listens for system signals and manages shutdown

func (*AgentFeaturesConfiguration) ValidateCfg 

func (c *AgentFeaturesConfiguration) ValidateCfg() (err error)

ValidateCfg - Validates the config, implementing IConfigInterface

func (*AgentFeaturesConfiguration) VersionCheckerEnabled 

func (c *AgentFeaturesConfiguration) VersionCheckerEnabled() bool

VersionCheckerEnabled - True if the agent SDK should check for newer versions of the agent.

type AgentType 

type AgentType int

AgentType - Defines the type of agent 

const (
	// DiscoveryAgent - Type definition for discovery agent
	DiscoveryAgent AgentType = iota + 1
	// TraceabilityAgent - Type definition for traceability agent
	TraceabilityAgent
	// GovernanceAgent - Type definition for governance agent
	GovernanceAgent
	// GenericService - Type for a generic service
	GenericService
)

func (AgentType) ToShortString added in v1.1.42 

func (agentType AgentType) ToShortString() string

func (AgentType) ToString added in v1.1.42 

func (agentType AgentType) ToString() string

type ApprovalConfig 

type ApprovalConfig struct {
	SubscriptionApprovalMode    string        `config:"mode"`
	SubscriptionApprovalWebhook WebhookConfig `config:"webhook"`
}

ApprovalConfig -

type AuthConfig 

type AuthConfig interface {
	GetTokenURL() string
	GetRealm() string
	GetAudience() string
	GetClientID() string
	GetPrivateKey() string
	GetPublicKey() string
	GetKeyPassword() string
	GetTimeout() time.Duration
	// contains filtered or unexported methods
}

AuthConfig - Interface for service account config

type AuthConfiguration 

type AuthConfiguration struct {
	AuthConfig
	RegionSettings regionalSettings
	URL            string        `config:"url"`
	Realm          string        `config:"realm"`
	ClientID       string        `config:"clientId"`
	PrivateKey     string        `config:"privateKey"`
	PublicKey      string        `config:"publicKey"`
	PrivateKeyData string        `config:"privateKeyData"`
	PublicKeyData  string        `config:"publicKeyData"`
	KeyPwd         string        `config:"keyPassword"`
	ClientIDReuse  bool          `config:"clientIdReuse"`
	Timeout        time.Duration `config:"timeout"`
}

AuthConfiguration -

func (*AuthConfiguration) GetAudience 

func (a *AuthConfiguration) GetAudience() string

GetAudience - Returns the token audience URL

func (*AuthConfiguration) GetClientID 

func (a *AuthConfiguration) GetClientID() string

GetClientID - Returns the token audience URL

func (*AuthConfiguration) GetKeyPassword 

func (a *AuthConfiguration) GetKeyPassword() string

GetKeyPassword - Returns the token audience URL

func (*AuthConfiguration) GetPrivateKey 

func (a *AuthConfiguration) GetPrivateKey() string

GetPrivateKey - Returns the private key file path

func (*AuthConfiguration) GetPublicKey 

func (a *AuthConfiguration) GetPublicKey() string

GetPublicKey - Returns the public key file path

func (*AuthConfiguration) GetRealm 

func (a *AuthConfiguration) GetRealm() string

GetRealm - Returns the token audience URL

func (*AuthConfiguration) GetTimeout 

func (a *AuthConfiguration) GetTimeout() time.Duration

GetTimeout - Returns the token audience URL

func (*AuthConfiguration) GetTokenURL 

func (a *AuthConfiguration) GetTokenURL() string

GetTokenURL - Returns the token URL

func (*AuthConfiguration) GetURL added in v1.1.86 

func (a *AuthConfiguration) GetURL() string

type CategoryConfig 

type CategoryConfig interface {
	IsAutocreationEnabled() bool
	IsConfigured() bool
	DetermineCategories(tags map[string]string) []string
	GetStaticCategories() []string
}

CategoryConfig - Interface to get category config

func ParseCategoryConfig 

func ParseCategoryConfig(props properties.Properties, basePath string) CategoryConfig

ParseCategoryConfig -

type CategoryConfiguration 

type CategoryConfiguration struct {
	Mappings     []*mapping `config:"mappings"`
	Autocreation bool       `config:"autocreation"`
	// contains filtered or unexported fields
}

CategoryConfiguration -

func (*CategoryConfiguration) DetermineCategories 

func (c *CategoryConfiguration) DetermineCategories(tags map[string]string) []string

DetermineCategories - return a string array of all categories that match the configured conditions

func (*CategoryConfiguration) GetStaticCategories 

func (c *CategoryConfiguration) GetStaticCategories() []string

GetStaticCategories - returns the array of the static categories for all the mappings

func (*CategoryConfiguration) IsAutocreationEnabled 

func (c *CategoryConfiguration) IsAutocreationEnabled() bool

IsAutocreationEnabled - return true when the auto creation of categories is enabled

func (*CategoryConfiguration) IsConfigured 

func (c *CategoryConfiguration) IsConfigured() bool

IsConfigured - return true when the auto creation of categories is enabled

type CentralConfig 

type CentralConfig interface {
	GetAgentType() AgentType
	GetRegion() Region
	GetTenantID() string
	GetAPICDeployment() string
	GetEnvironmentID() string
	SetEnvironmentID(environmentID string)
	IsAxwayManaged() bool
	SetAxwayManaged(isAxwayManaged bool)
	GetEnvironmentName() string
	GetAgentName() string
	GetTeamName() string
	GetTeamID() string
	SetTeamID(teamID string)
	GetURL() string
	GetTraceabilityHost() string
	GetPlatformURL() string
	GetCatalogItemsURL() string
	GetAPIServerURL() string
	GetEnvironmentURL() string
	GetEnvironmentACLsURL() string
	GetServicesURL() string
	GetRevisionsURL() string
	GetInstancesURL() string
	DeleteServicesURL() string
	GetConsumerInstancesURL() string
	GetAPIServerSubscriptionDefinitionURL() string
	GetAPIServerAccessRequestDefinitionURL() string
	GetAPIServerWebhooksURL() string
	GetAPIServerSecretsURL() string
	GetCategoriesURL() string
	GetSubscriptionURL() string
	GetSubscriptionConfig() SubscriptionConfig
	GetAccessRequestsURL() string
	GetAccessRequestURL(string) string
	GetAccessRequestStateURL(string) string
	GetCatalogItemSubscriptionsURL(string) string
	GetCatalogItemSubscriptionStatesURL(string, string) string
	GetCatalogItemSubscriptionPropertiesURL(string, string) string
	GetCatalogItemSubscriptionRelationshipURL(string, string) string
	GetCatalogItemSubscriptionDefinitionPropertiesURL(string) string
	GetAuthConfig() AuthConfig
	GetTLSConfig() TLSConfig
	GetTagsToPublish() string
	GetProxyURL() string
	GetPollInterval() time.Duration
	GetReportActivityFrequency() time.Duration
	GetAPIValidationCronSchedule() string
	GetJobExecutionTimeout() time.Duration
	GetClientTimeout() time.Duration
	GetAPIServiceRevisionPattern() string
	GetCatalogItemByIDURL(catalogItemID string) string
	GetAppendEnvironmentToTitle() bool
	GetUsageReportingConfig() UsageReportingConfig
	IsUsingGRPC() bool
	GetGRPCHost() string
	GetGRPCPort() int
	IsGRPCInsecure() bool
	GetCacheStoragePath() string
	GetCacheStorageInterval() time.Duration
	SetIsMarketplaceSubsEnabled(enabled bool)
	IsMarketplaceSubsEnabled() bool
	GetSingleURL() string
	GetMigrationSettings() MigrationConfig
	GetWatchResourceFilters() []ResourceFilter
	SetWatchResourceFilters([]ResourceFilter) error
	GetCredentialConfig() CredentialConfig
}

CentralConfig - Interface to get central Config

func NewCentralConfig 

func NewCentralConfig(agentType AgentType) CentralConfig

NewCentralConfig - Creates the default central config

func NewTestCentralConfig 

func NewTestCentralConfig(agentType AgentType) CentralConfig

NewTestCentralConfig - Creates the default central config

func ParseCentralConfig 

func ParseCentralConfig(props properties.Properties, agentType AgentType) (CentralConfig, error)

ParseCentralConfig - Parses the Central Config values from the command line

type CentralConfiguration 

type CentralConfiguration struct {
	CentralConfig
	IConfigValidator
	AgentType                 AgentType
	RegionSettings            regionalSettings
	Region                    Region               `config:"region"`
	TenantID                  string               `config:"organizationID"`
	TeamName                  string               `config:"team"`
	APICDeployment            string               `config:"deployment"`
	Environment               string               `config:"environment"`
	EnvironmentID             string               `config:"environmentID"`
	AgentName                 string               `config:"agentName"`
	URL                       string               `config:"url"`
	SingleURL                 string               `config:"platformSingleURL"`
	PlatformURL               string               `config:"platformURL"`
	APIServerVersion          string               `config:"apiServerVersion"`
	TagsToPublish             string               `config:"additionalTags"`
	AppendEnvironmentToTitle  bool                 `config:"appendEnvironmentToTitle"`
	MigrationSettings         MigrationConfig      `config:"migration"`
	Auth                      AuthConfig           `config:"auth"`
	TLS                       TLSConfig            `config:"ssl"`
	PollInterval              time.Duration        `config:"pollInterval"`
	ReportActivityFrequency   time.Duration        `config:"reportActivityFrequency"`
	ClientTimeout             time.Duration        `config:"clientTimeout"`
	APIValidationCronSchedule string               `config:"apiValidationCronSchedule"`
	APIServiceRevisionPattern string               `config:"apiServiceRevisionPattern"`
	ProxyURL                  string               `config:"proxyUrl"`
	SubscriptionConfiguration SubscriptionConfig   `config:"subscriptions"`
	UsageReporting            UsageReportingConfig `config:"usageReporting"`
	GRPCCfg                   GRPCConfig           `config:"grpc"`
	CacheStoragePath          string               `config:"cacheStoragePath"`
	CacheStorageInterval      time.Duration        `config:"cacheStorageInterval"`
	CredentialConfig          CredentialConfig     `config:"credential"`
	JobExecutionTimeout       time.Duration

	WatchResourceFilters []ResourceFilter
	// contains filtered or unexported fields
}

CentralConfiguration - Structure to hold the central config

func (*CentralConfiguration) DeleteServicesURL 

func (c *CentralConfiguration) DeleteServicesURL() string

DeleteServicesURL - Returns the APIServer URL for services API instances

func (*CentralConfiguration) GetAPICDeployment 

func (c *CentralConfiguration) GetAPICDeployment() string

GetAPICDeployment - Returns the Central deployment type 'prod', 'preprod', team ('beano')

func (*CentralConfiguration) GetAPIServerAccessRequestDefinitionURL 

func (c *CentralConfiguration) GetAPIServerAccessRequestDefinitionURL() string

GetAPIServerAccessRequestDefinitionURL - Returns the APIServer URL for access request definitions

func (*CentralConfiguration) GetAPIServerCatalogURL 

func (c *CentralConfiguration) GetAPIServerCatalogURL() string

GetAPIServerCatalogURL - Returns the base path for the API server for catalog resources

func (*CentralConfiguration) GetAPIServerSecretsURL 

func (c *CentralConfiguration) GetAPIServerSecretsURL() string

GetAPIServerSecretsURL - Returns the APIServer URL for secrets

func (*CentralConfiguration) GetAPIServerSubscriptionDefinitionURL 

func (c *CentralConfiguration) GetAPIServerSubscriptionDefinitionURL() string

GetAPIServerSubscriptionDefinitionURL - Returns the APIServer URL for services API instances

func (*CentralConfiguration) GetAPIServerURL 

func (c *CentralConfiguration) GetAPIServerURL() string

GetAPIServerURL - Returns the base path for the API server

func (*CentralConfiguration) GetAPIServerWebhooksURL 

func (c *CentralConfiguration) GetAPIServerWebhooksURL() string

GetAPIServerWebhooksURL - Returns the APIServer URL for webhooks instances

func (*CentralConfiguration) GetAPIServiceRevisionPattern 

func (c *CentralConfiguration) GetAPIServiceRevisionPattern() string

GetAPIServiceRevisionPattern - Returns the naming pattern for APIServiceRevition title

func (*CentralConfiguration) GetAPIValidationCronSchedule added in v1.1.72 

func (c *CentralConfiguration) GetAPIValidationCronSchedule() string

GetAPIValidationCronSchedule - Returns the cron schedule running the api validator

func (*CentralConfiguration) GetAccessRequestStateURL 

func (c *CentralConfiguration) GetAccessRequestStateURL(accessRequestName string) string

GetAccessRequestStateURL - Returns the access request URL to update the state

func (*CentralConfiguration) GetAccessRequestSubscriptionPropertiesURL 

func (c *CentralConfiguration) GetAccessRequestSubscriptionPropertiesURL(accessRequestName string) string

GetAccessRequestSubscriptionPropertiesURL - Returns the access request URL for subscription properties

func (*CentralConfiguration) GetAccessRequestURL 

func (c *CentralConfiguration) GetAccessRequestURL(accessRequestName string) string

GetAccessRequestURL - Returns the access request URL for catalog item subscription states

func (*CentralConfiguration) GetAccessRequestsURL 

func (c *CentralConfiguration) GetAccessRequestsURL() string

GetAccessRequestsURL - Returns the accessrequest URL for access request API

func (*CentralConfiguration) GetAgentName 

func (c *CentralConfiguration) GetAgentName() string

GetAgentName - Returns the agent name

func (*CentralConfiguration) GetAgentType 

func (c *CentralConfiguration) GetAgentType() AgentType

GetAgentType - Returns the agent type

func (*CentralConfiguration) GetAppendEnvironmentToTitle 

func (c *CentralConfiguration) GetAppendEnvironmentToTitle() bool

GetAppendEnvironmentToTitle - Returns the value of append environment name to title attribute

func (*CentralConfiguration) GetAuthConfig 

func (c *CentralConfiguration) GetAuthConfig() AuthConfig

GetAuthConfig - Returns the Auth Config

func (*CentralConfiguration) GetCacheStorageInterval 

func (c *CentralConfiguration) GetCacheStorageInterval() time.Duration

GetCacheStorageInterval -

func (*CentralConfiguration) GetCacheStoragePath 

func (c *CentralConfiguration) GetCacheStoragePath() string

GetCacheStoragePath -

func (*CentralConfiguration) GetCatalogItemByIDURL 

func (c *CentralConfiguration) GetCatalogItemByIDURL(catalogItemID string) string

GetCatalogItemByIDURL - Returns URL to get catalog item by id

func (*CentralConfiguration) GetCatalogItemSubscriptionDefinitionPropertiesURL 

func (c *CentralConfiguration) GetCatalogItemSubscriptionDefinitionPropertiesURL(catalogItemID string) string

GetCatalogItemSubscriptionDefinitionPropertiesURL - Returns the unifiedcatalog URL for catalog item subscription definition properties

func (*CentralConfiguration) GetCatalogItemSubscriptionPropertiesURL 

func (c *CentralConfiguration) GetCatalogItemSubscriptionPropertiesURL(catalogItemID, subscriptionID string) string

GetCatalogItemSubscriptionPropertiesURL - Returns the unifiedcatalog URL for catalog item subscription properties

func (*CentralConfiguration) GetCatalogItemSubscriptionRelationshipURL 

func (c *CentralConfiguration) GetCatalogItemSubscriptionRelationshipURL(catalogItemID, subscriptionID string) string

GetCatalogItemSubscriptionRelationshipURL - Returns the relationships URL for catalog item subscription

func (*CentralConfiguration) GetCatalogItemSubscriptionStatesURL 

func (c *CentralConfiguration) GetCatalogItemSubscriptionStatesURL(catalogItemID, subscriptionID string) string

GetCatalogItemSubscriptionStatesURL - Returns the unifiedcatalog URL for catalog item subscription states

func (*CentralConfiguration) GetCatalogItemSubscriptionsURL 

func (c *CentralConfiguration) GetCatalogItemSubscriptionsURL(catalogItemID string) string

GetCatalogItemSubscriptionsURL - Returns the unifiedcatalog URL for catalog item subscriptions

func (*CentralConfiguration) GetCatalogItemsURL 

func (c *CentralConfiguration) GetCatalogItemsURL() string

GetCatalogItemsURL - Returns the unifiedcatalog URL for catalog items API

func (*CentralConfiguration) GetCategoriesURL 

func (c *CentralConfiguration) GetCategoriesURL() string

GetCategoriesURL - Returns the Categories URL

func (*CentralConfiguration) GetClientTimeout 

func (c *CentralConfiguration) GetClientTimeout() time.Duration

GetClientTimeout - Returns the interval for http client timeouts

func (*CentralConfiguration) GetConsumerInstancesURL 

func (c *CentralConfiguration) GetConsumerInstancesURL() string

GetConsumerInstancesURL - Returns the APIServer URL for services API consumer instances

func (*CentralConfiguration) GetCredentialConfig added in v1.1.35 

func (c *CentralConfiguration) GetCredentialConfig() CredentialConfig

GetCredentialConfig -

func (*CentralConfiguration) GetEnvironmentACLsURL 

func (c *CentralConfiguration) GetEnvironmentACLsURL() string

GetEnvironmentACLsURL - Returns the APIServer URL for ACLs in Environments

func (*CentralConfiguration) GetEnvironmentID 

func (c *CentralConfiguration) GetEnvironmentID() string

GetEnvironmentID - Returns the environment ID

func (*CentralConfiguration) GetEnvironmentName 

func (c *CentralConfiguration) GetEnvironmentName() string

GetEnvironmentName - Returns the environment name

func (*CentralConfiguration) GetEnvironmentURL 

func (c *CentralConfiguration) GetEnvironmentURL() string

GetEnvironmentURL - Returns the APIServer URL for services API

func (*CentralConfiguration) GetGRPCHost 

func (c *CentralConfiguration) GetGRPCHost() string

GetGRPCHost -

func (*CentralConfiguration) GetGRPCPort 

func (c *CentralConfiguration) GetGRPCPort() int

GetGRPCPort -

func (*CentralConfiguration) GetInstancesURL 

func (c *CentralConfiguration) GetInstancesURL() string

GetInstancesURL - Returns the APIServer URL for services API instances

func (*CentralConfiguration) GetJobExecutionTimeout 

func (c *CentralConfiguration) GetJobExecutionTimeout() time.Duration

GetJobExecutionTimeout - Returns the max time a job execution can run before considered failed

func (*CentralConfiguration) GetMigrationSettings 

func (c *CentralConfiguration) GetMigrationSettings() MigrationConfig

GetMigrationSettings - Returns the Migration Config

func (*CentralConfiguration) GetPlatformURL 

func (c *CentralConfiguration) GetPlatformURL() string

GetPlatformURL - Returns the central base URL

func (*CentralConfiguration) GetPollInterval 

func (c *CentralConfiguration) GetPollInterval() time.Duration

GetPollInterval - Returns the interval for polling subscriptions

func (*CentralConfiguration) GetProxyURL 

func (c *CentralConfiguration) GetProxyURL() string

GetProxyURL - Returns the central Proxy URL

func (*CentralConfiguration) GetRegion added in v1.1.86 

func (c *CentralConfiguration) GetRegion() Region

GetAgentType - Returns the agent type

func (*CentralConfiguration) GetReportActivityFrequency 

func (c *CentralConfiguration) GetReportActivityFrequency() time.Duration

GetReportActivityFrequency - Returns the interval between running periodic status updater

func (*CentralConfiguration) GetRevisionsURL 

func (c *CentralConfiguration) GetRevisionsURL() string

GetRevisionsURL - Returns the APIServer URL for services API revisions

func (*CentralConfiguration) GetServicesURL 

func (c *CentralConfiguration) GetServicesURL() string

GetServicesURL - Returns the APIServer URL for services API

func (*CentralConfiguration) GetSingleURL 

func (c *CentralConfiguration) GetSingleURL() string

GetSingleURL - Returns the Alternate base URL

func (*CentralConfiguration) GetSubscriptionConfig 

func (c *CentralConfiguration) GetSubscriptionConfig() SubscriptionConfig

GetSubscriptionConfig - Returns the Config for the subscription webhook

func (*CentralConfiguration) GetSubscriptionURL 

func (c *CentralConfiguration) GetSubscriptionURL() string

GetSubscriptionURL - Returns the unifiedcatalog URL for subscriptions list

func (*CentralConfiguration) GetTLSConfig 

func (c *CentralConfiguration) GetTLSConfig() TLSConfig

GetTLSConfig - Returns the TLS Config

func (*CentralConfiguration) GetTagsToPublish 

func (c *CentralConfiguration) GetTagsToPublish() string

GetTagsToPublish - Returns tags to publish

func (*CentralConfiguration) GetTeamID 

func (c *CentralConfiguration) GetTeamID() string

GetTeamID - Returns the team ID

func (*CentralConfiguration) GetTeamName 

func (c *CentralConfiguration) GetTeamName() string

GetTeamName - Returns the team name

func (*CentralConfiguration) GetTenantID 

func (c *CentralConfiguration) GetTenantID() string

GetTenantID - Returns the tenant ID

func (*CentralConfiguration) GetTraceabilityHost added in v1.1.86 

func (c *CentralConfiguration) GetTraceabilityHost() string

GetTraceabilityHost - Returns the central traceability host

func (*CentralConfiguration) GetURL 

func (c *CentralConfiguration) GetURL() string

GetURL - Returns the central base URL

func (*CentralConfiguration) GetUsageReportingConfig 

func (c *CentralConfiguration) GetUsageReportingConfig() UsageReportingConfig

GetUsageReportingConfig -

func (*CentralConfiguration) GetWatchResourceFilters 

func (c *CentralConfiguration) GetWatchResourceFilters() []ResourceFilter

GetWatchResourceFilters - returns the custom watch filter config

func (*CentralConfiguration) IsAxwayManaged 

func (c *CentralConfiguration) IsAxwayManaged() bool

IsAxwayManaged - Returns the environment ID

func (*CentralConfiguration) IsGRPCInsecure 

func (c *CentralConfiguration) IsGRPCInsecure() bool

IsGRPCInsecure -

func (*CentralConfiguration) IsMarketplaceSubsEnabled 

func (c *CentralConfiguration) IsMarketplaceSubsEnabled() bool

IsMarketplaceSubsEnabled - Returns the isMarketplaceSubs boolean

func (*CentralConfiguration) IsUsingGRPC 

func (c *CentralConfiguration) IsUsingGRPC() bool

IsUsingGRPC -

func (*CentralConfiguration) SetAxwayManaged 

func (c *CentralConfiguration) SetAxwayManaged(isManaged bool)

SetAxwayManaged - Sets the environment ID

func (*CentralConfiguration) SetEnvironmentID 

func (c *CentralConfiguration) SetEnvironmentID(environmentID string)

SetEnvironmentID - Sets the environment ID

func (*CentralConfiguration) SetIsMarketplaceSubsEnabled 

func (c *CentralConfiguration) SetIsMarketplaceSubsEnabled(enabled bool)

SetIsMarketplaceSubsEnabled - Sets the isMarketplaceSubs boolean

func (*CentralConfiguration) SetTeamID 

func (c *CentralConfiguration) SetTeamID(teamID string)

SetTeamID - Sets the team ID

func (*CentralConfiguration) SetWatchResourceFilters 

func (c *CentralConfiguration) SetWatchResourceFilters(filters []ResourceFilter) error

SetWatchResourceFilters - sets the custom watch filter config

func (*CentralConfiguration) ValidateCfg 

func (c *CentralConfiguration) ValidateCfg() (err error)

ValidateCfg - Validates the config, implementing IConfigInterface

type CredentialConfig added in v1.1.35 

type CredentialConfig interface {
	ShouldDeprovisionExpired() bool
	SetShouldDeprovisionExpired(deprovisionExpired bool)
	GetExpirationDays() int
	SetExpirationDays(expirationDays int)
}

SubscriptionConfig - Interface to get subscription config

type CredentialConfiguration added in v1.1.35 

type CredentialConfiguration struct {
	ExpirationDays      int  `config:"expirationDays"`
	DeprovisionOnExpire bool `config:"deprovisionOnExpire"`
}

NotificationConfig -

func (*CredentialConfiguration) GetExpirationDays added in v1.1.35 

func (s *CredentialConfiguration) GetExpirationDays() int

GetTimeToLive -

func (*CredentialConfiguration) SetExpirationDays added in v1.1.52 

func (s *CredentialConfiguration) SetExpirationDays(expirationDays int)

Set GetTimeToLive -

func (*CredentialConfiguration) SetShouldDeprovisionExpired added in v1.1.52 

func (s *CredentialConfiguration) SetShouldDeprovisionExpired(deprovisionExpired bool)

Set ExpireAction -

func (*CredentialConfiguration) ShouldDeprovisionExpired added in v1.1.35 

func (s *CredentialConfiguration) ShouldDeprovisionExpired() bool

ExpireAction -

func (*CredentialConfiguration) ValidateCfg added in v1.1.35 

func (s *CredentialConfiguration) ValidateCfg() error

ValidateCfg - Validates the config, implementing IConfigInterface

type EmailTemplate 

type EmailTemplate struct {
	Subject string `config:"subject"`
	Body    string `config:"body"`
	Oauth   string `config:"oauth"`
	APIKey  string `config:"apikeys"`
}

EmailTemplate -

type ExternalIDPConfig 

type ExternalIDPConfig interface {
	GetIDPList() []IDPConfig
	ValidateCfg() (err error)
}

ExternalIDPConfig -

type ExtraProperties 

type ExtraProperties map[string]string

ExtraProperties - type for representing extra IdP provider properties to be included in client request

func (*ExtraProperties) UnmarshalJSON 

func (e *ExtraProperties) UnmarshalJSON(data []byte) error

UnmarshalJSON - deserializes extra properties from env config

type GRPCConfig 

type GRPCConfig struct {
	Enabled  bool   `config:"enabled"`
	Host     string `config:"host"`
	Port     int    `config:"port"`
	Insecure bool   `config:"insecure"`
}

GRPCConfig - Represents the grpc config

type IConfigValidator 

type IConfigValidator interface {
	ValidateCfg() error
}

IConfigValidator - Interface to be implemented for config validation by agent

type IDPAuthConfig 

type IDPAuthConfig interface {
	// GetType - type of authentication mechanism to use "accessToken" or "client"
	GetType() string
	// GetAccessToken - token(initial access token/Admin API Token etc) to be used by Agent SDK to authenticate with IdP
	GetAccessToken() string
	// GetClientID - Identifier of the client in IdP that can used to create new OAuth clients
	GetClientID() string
	// GetClientSecret - Secret for the client in IdP that can used to create new OAuth clients
	GetClientSecret() string
	// GetClientScope - Scopes used for requesting the token using the ID client
	GetClientScope() string

	// GetPrivateKey() - private key to be used for private_key_jwt authentication
	GetPrivateKey() string
	// GetPublicKey() - public key to be used for private_key_jwt authentication
	GetPublicKey() string
	// GetKeyPassword() - public key to be used for private_key_jwt authentication
	GetKeyPassword() string
	// GetSigningMethod() - the token signing method for private_key_jwt authentication
	GetTokenSigningMethod() string
	// UseTokenCache() - return flag to indicate if the auth client to get new token on each request
	UseTokenCache() bool
	// UseRegistrationAccessToken - return flag to indicate if the auth client to use registration access token
	UseRegistrationAccessToken() bool
	// GetRequestHeaders - set of additional request headers to be applied when registering the client
	GetRequestHeaders() map[string]string
	// GetQueryParams - set of additional query parameters to be applied when registering the client
	GetQueryParams() map[string]string
	// contains filtered or unexported methods
}

IDPAuthConfig - interface for IdP provider auth config

type IDPAuthConfiguration 

type IDPAuthConfiguration struct {
	Type                 string            `json:"type,omitempty"`
	RequestHeaders       IDPRequestHeaders `json:"requestHeaders,omitempty"`
	QueryParams          IDPQueryParams    `json:"queryParams,omitempty"`
	AccessToken          string            `json:"accessToken,omitempty"`
	ClientID             string            `json:"clientId,omitempty"`
	ClientSecret         string            `json:"clientSecret,omitempty"`
	ClientScope          string            `json:"clientScope,omitempty"`
	PrivateKey           string            `json:"privateKey,omitempty"`
	PublicKey            string            `json:"publicKey,omitempty"`
	KeyPwd               string            `json:"keyPassword,omitempty"`
	TokenSigningMethod   string            `json:"tokenSigningMethod,omitempty"`
	UseCachedToken       bool              `json:"-"`
	UseRegistrationToken bool              `json:"-"`
}

IDPAuthConfiguration - Structure to hold the IdP provider auth config

func (*IDPAuthConfiguration) GetAccessToken 

func (i *IDPAuthConfiguration) GetAccessToken() string

GetAccessToken - token(initial access token/Admin API Token etc) to be used by Agent SDK to authenticate with IdP

func (*IDPAuthConfiguration) GetClientID 

func (i *IDPAuthConfiguration) GetClientID() string

GetClientID - Identifier of the client in IdP that can used to create new OAuth client

func (*IDPAuthConfiguration) GetClientScope added in v1.1.57 

func (i *IDPAuthConfiguration) GetClientScope() string

GetClientScope - scopes used for requesting the token using the ID client

func (*IDPAuthConfiguration) GetClientSecret 

func (i *IDPAuthConfiguration) GetClientSecret() string

GetClientSecret - Secret for the client in IdP that can used to create new OAuth clients

func (*IDPAuthConfiguration) GetKeyPassword added in v1.1.61 

func (i *IDPAuthConfiguration) GetKeyPassword() string

GetKeyPassword -

func (*IDPAuthConfiguration) GetPrivateKey added in v1.1.61 

func (i *IDPAuthConfiguration) GetPrivateKey() string

GetPrivateKey -

func (*IDPAuthConfiguration) GetPublicKey added in v1.1.61 

func (i *IDPAuthConfiguration) GetPublicKey() string

GetPublicKey -

func (*IDPAuthConfiguration) GetQueryParams added in v1.1.86 

func (i *IDPAuthConfiguration) GetQueryParams() map[string]string

GetQueryParams - set of additional query params to be applied when registering the client

func (*IDPAuthConfiguration) GetRequestHeaders added in v1.1.86 

func (i *IDPAuthConfiguration) GetRequestHeaders() map[string]string

GetRequestHeaders - set of additional request headers to be applied when registering the client

func (*IDPAuthConfiguration) GetTokenSigningMethod added in v1.1.61 

func (i *IDPAuthConfiguration) GetTokenSigningMethod() string

GetTokenSigningMethod -

func (*IDPAuthConfiguration) GetType 

func (i *IDPAuthConfiguration) GetType() string

GetType - type of authentication mechanism to use "accessToken" or "client"

func (*IDPAuthConfiguration) MarshalJSON added in v1.1.61 

func (i *IDPAuthConfiguration) MarshalJSON() ([]byte, error)

MarshalJSON - custom marshaler for Application struct

func (*IDPAuthConfiguration) UnmarshalJSON added in v1.1.61 

func (i *IDPAuthConfiguration) UnmarshalJSON(data []byte) error

UnmarshalJSON - custom unmarshaler for IDPAuthConfiguration struct

func (*IDPAuthConfiguration) UseRegistrationAccessToken added in v1.1.85 

func (i *IDPAuthConfiguration) UseRegistrationAccessToken() bool

UseRegistrationAccessToken - return flag to indicate if the auth client to use registration access token

func (*IDPAuthConfiguration) UseTokenCache added in v1.1.61 

func (i *IDPAuthConfiguration) UseTokenCache() bool

UseTokenCache - return flag to indicate if the auth client to get new token on each request

type IDPConfig 

type IDPConfig interface {
	// GetMetadataURL - URL exposed by OAuth authorization server to provide metadata information
	GetMetadataURL() string
	// GetIDPType - IDP type ("generic" or "okta")
	GetIDPType() string
	// GetIDPName - for the identity provider
	GetIDPName() string
	// GetIDPTitle - for the identity provider friendly name
	GetIDPTitle() string
	// GetAuthConfig - to be used for authentication with IDP
	GetAuthConfig() IDPAuthConfig
	// GetClientScopes - default list of scopes that are included in the client metadata request to IDP
	GetClientScopes() string
	// GetGrantType - default grant type to be used when creating the client. (default :  "client_credentials")
	GetGrantType() string
	// GetAuthMethod - default token endpoint authentication method(default : "client_secret_basic")
	GetAuthMethod() string
	// GetAuthResponseType - default token response type to be used when registering the client
	GetAuthResponseType() string
	// GetExtraProperties - set of additional properties to be applied when registering the client
	GetExtraProperties() map[string]string
	// GetRequestHeaders - set of additional request headers to be applied when registering the client
	GetRequestHeaders() map[string]string
	// GetQueryParams - set of additional query parameters to be applied when registering the client
	GetQueryParams() map[string]string
	// GetTLSConfig - tls config for IDP connection
	GetTLSConfig() TLSConfig
	// contains filtered or unexported methods
}

IDPConfig - interface for IdP provider config

type IDPConfiguration 

type IDPConfiguration struct {
	Name             string            `json:"name,omitempty"`
	Title            string            `json:"title,omitempty"`
	Type             string            `json:"type,omitempty"`
	MetadataURL      string            `json:"metadataUrl,omitempty"`
	AuthConfig       IDPAuthConfig     `json:"auth,omitempty"`
	ClientScopes     string            `json:"scope,omitempty"`
	GrantType        string            `json:"grantType,omitempty"`
	AuthMethod       string            `json:"authMethod,omitempty"`
	AuthResponseType string            `json:"authResponseType,omitempty"`
	ExtraProperties  ExtraProperties   `json:"extraProperties,omitempty"`
	RequestHeaders   IDPRequestHeaders `json:"requestHeaders,omitempty"`
	QueryParams      IDPQueryParams    `json:"queryParams,omitempty"`
	TLSConfig        TLSConfig         `json:"ssl,omitempty"`
}

IDPConfiguration - Structure to hold the IdP provider config

func (*IDPConfiguration) GetAuthConfig 

func (i *IDPConfiguration) GetAuthConfig() IDPAuthConfig

GetAuthConfig - to be used for authentication with IDP

func (*IDPConfiguration) GetAuthMethod 

func (i *IDPConfiguration) GetAuthMethod() string

GetAuthMethod - default token endpoint authentication method(default : "client_secret_basic")

func (*IDPConfiguration) GetAuthResponseType 

func (i *IDPConfiguration) GetAuthResponseType() string

GetAuthResponseType - default token response type to be used when registering the client

func (*IDPConfiguration) GetClientScopes 

func (i *IDPConfiguration) GetClientScopes() string

GetClientScopes - default list of scopes that are included in the client metadata request to IDP

func (*IDPConfiguration) GetExtraProperties 

func (i *IDPConfiguration) GetExtraProperties() map[string]string

GetExtraProperties - set of additional properties to be applied when registering the client

func (*IDPConfiguration) GetGrantType 

func (i *IDPConfiguration) GetGrantType() string

GetGrantType - default grant type to be used when creating the client. (default : "client_credentials")

func (*IDPConfiguration) GetIDPName 

func (i *IDPConfiguration) GetIDPName() string

GetIDPName - for the identity provider

func (*IDPConfiguration) GetIDPTitle added in v1.1.35 

func (i *IDPConfiguration) GetIDPTitle() string

GetIDPName - for the identity provider frinedly name

func (*IDPConfiguration) GetIDPType 

func (i *IDPConfiguration) GetIDPType() string

GetIDPType - IDP type ("generic" or "okta")

func (*IDPConfiguration) GetMetadataURL 

func (i *IDPConfiguration) GetMetadataURL() string

GetMetadataURL - URL exposed by OAuth authorization server to provide metadata information

func (*IDPConfiguration) GetQueryParams added in v1.1.86 

func (i *IDPConfiguration) GetQueryParams() map[string]string

GetQueryParams - set of additional query params to be applied when registering the client

func (*IDPConfiguration) GetRequestHeaders added in v1.1.86 

func (i *IDPConfiguration) GetRequestHeaders() map[string]string

GetRequestHeaders - set of additional request headers to be applied when registering the client

func (*IDPConfiguration) GetTLSConfig added in v1.1.57 

func (i *IDPConfiguration) GetTLSConfig() TLSConfig

GetTLSConfig - tls config for IDP connection

type IDPQueryParams added in v1.1.86 

type IDPQueryParams map[string]string

IDPQueryParams - additional query params for calls to IdP

func (*IDPQueryParams) UnmarshalJSON added in v1.1.86 

func (e *IDPQueryParams) UnmarshalJSON(data []byte) error

UnmarshalJSON - deserializes query parameters from env config

type IDPRequestHeaders added in v1.1.86 

type IDPRequestHeaders map[string]string

IDPRequestHeaders - additional request headers for calls to IdP

func (*IDPRequestHeaders) UnmarshalJSON added in v1.1.86 

func (e *IDPRequestHeaders) UnmarshalJSON(data []byte) error

UnmarshalJSON - deserializes request header from env config

type IResourceConfigCallback 

type IResourceConfigCallback interface {
	ApplyResources(agentResource *v1.ResourceInstance) error
}

IResourceConfigCallback - Interface to be implemented by configs to apply API Server resource for agent

type LogConfig 

type LogConfig interface {
	SetLevel(level string)
	GetMetricConfig() LogFileConfiguration
	GetUsageConfig() LogFileConfiguration
}

LogConfig - Interface for logging config

func ParseAndSetupLogConfig 

func ParseAndSetupLogConfig(props properties.Properties, agentType AgentType) (LogConfig, error)

ParseAndSetupLogConfig - Parses the Log Config and setups the logger

type LogConfiguration 

type LogConfiguration struct {
	LogConfig
	Level        string               `config:"level"`
	Format       string               `config:"format"`
	Output       string               `config:"output"`
	File         LogFileConfiguration `config:"file"`
	MetricFile   LogFileConfiguration `config:"metricfile"`
	UsageFile    LogFileConfiguration `config:"usagefile"`
	MaskedValues string               `config:"maskedvalues"`
}

LogConfiguration -

func (*LogConfiguration) GetMetricConfig added in v1.1.80 

func (l *LogConfiguration) GetMetricConfig() LogFileConfiguration

func (*LogConfiguration) GetUsagefileConfig added in v1.1.83 

func (l *LogConfiguration) GetUsagefileConfig() LogFileConfiguration

type LogFileConfiguration 

type LogFileConfiguration struct {
	Enabled    bool   `config:"enable"`
	Name       string `config:"name"`
	Path       string `config:"path"`
	MaxSize    int    `config:"rotateeverybytes"`
	MaxAge     int    `config:"cleanbackups"`
	MaxBackups int    `config:"keepfiles"`
}

LogFileConfiguration - setup the logging configuration for file output

type MigrationConfig 

type MigrationConfig interface {
	ShouldCleanInstances() bool
	// contains filtered or unexported methods
}

MigrationConfig - Interface for migration settings config

func ParseMigrationConfig 

func ParseMigrationConfig(props properties.Properties) MigrationConfig

ParseMigrationConfig - Parses the Migration Config values from the command line

type MigrationSettings 

type MigrationSettings struct {
	CleanInstances bool
}

MigrationSettings -

func (*MigrationSettings) ShouldCleanInstances 

func (m *MigrationSettings) ShouldCleanInstances() bool

ShouldCleanInstances - returns the value fo CleanInstances

type NotificationConfig 

type NotificationConfig struct {
	SMTP    *smtp         `config:"smtp"`
	Webhook WebhookConfig `config:"webhook"`
}

NotificationConfig -

type NotificationType 

type NotificationType string

NotificationType - Type definition for subscription state

type Region added in v1.1.86 

type Region int
const (
	US Region = iota + 1
	EU
	AP
)

func (Region) ToString added in v1.1.86 

func (r Region) ToString() string

type ResourceEventType 

type ResourceEventType string

ResourceEventType - watch filter event types 

const (
	ResourceEventCreated ResourceEventType = "created"
	ResourceEventUpdated ResourceEventType = "updated"
	ResourceEventDeleted ResourceEventType = "deleted"
)

Resource event types

type ResourceFilter 

type ResourceFilter struct {
	Group            string              `json:"group"` // remove group ? and default to management or allow filter for other groups as well?
	Kind             string              `json:"kind"`
	Name             string              `json:"name"`
	EventTypes       []ResourceEventType `json:"eventTypes"`
	Scope            *ResourceScope      `json:"scope"`
	IsCachedResource bool                `json:"isCachedResource"`
}

ResourceFilter - custom watch filter

type ResourceScope 

type ResourceScope struct {
	Kind string `json:"kind"`
	Name string `json:"name"`
}

ResourceScope - scope config for watch resource filter

type SMTPAuthType 

type SMTPAuthType string

SMTPAuthType - the type of authentication methods the SMTP client supports

type StatusConfig 

type StatusConfig interface {
	GetPort() int
	GetHealthCheckPeriod() time.Duration
	GetHealthCheckInterval() time.Duration
	ValidateCfg() error
}

StatusConfig - Interface for status config

func NewStatusConfig 

func NewStatusConfig() StatusConfig

NewStatusConfig - create a new status config

func ParseStatusConfig 

func ParseStatusConfig(props properties.Properties) (StatusConfig, error)

ParseStatusConfig - Parses the Status Config values form teh command line

type StatusConfiguration 

type StatusConfiguration struct {
	StatusConfig
	Port                int           `config:"port"`
	HealthCheckPeriod   time.Duration `config:"healthCheckPeriod"`
	HealthCheckInterval time.Duration `config:"healthCheckInterval"` // this for binary agents only
}

StatusConfiguration -

func (*StatusConfiguration) GetHealthCheckInterval 

func (a *StatusConfiguration) GetHealthCheckInterval() time.Duration

GetHealthCheckInterval - Returns the interval between running periodic health checks (binary agents only)

func (*StatusConfiguration) GetHealthCheckPeriod 

func (a *StatusConfiguration) GetHealthCheckPeriod() time.Duration

GetHealthCheckPeriod - Returns the timeout before exiting discovery agent

func (*StatusConfiguration) GetPort 

func (a *StatusConfiguration) GetPort() int

GetPort - Returns the status port

func (*StatusConfiguration) ValidateCfg 

func (a *StatusConfiguration) ValidateCfg() error

ValidateCfg - Validates the config, implementing IConfigInterface

type SubscriptionConfig 

type SubscriptionConfig interface {
	PollingEnabled() bool
	GetNotificationTypes() []NotificationType
	GetWebhookURL() string
	GetWebhookHeaders() map[string]string
	GetSMTPURL() string
	GetSMTPHost() string
	GetSMTPFromAddress() string
	GetSMTPAuthType() SMTPAuthType
	GetSMTPIdentity() string
	GetSMTPUsername() string
	GetSMTPPassword() string
	GetSubscribeTemplate() *EmailTemplate
	GetUnsubscribeTemplate() *EmailTemplate
	GetSubscribeFailedTemplate() *EmailTemplate
	GetUnsubscribeFailedTemplate() *EmailTemplate
	GetSubscriptionApprovalMode() string
	GetSubscriptionApprovalWebhookConfig() WebhookConfig
}

SubscriptionConfig - Interface to get subscription config

func NewSubscriptionConfig 

func NewSubscriptionConfig() SubscriptionConfig

NewSubscriptionConfig - Creates the default subscription config

func ParseSubscriptionConfig 

func ParseSubscriptionConfig(props properties.Properties) SubscriptionConfig

ParseSubscriptionConfig -

type SubscriptionConfiguration 

type SubscriptionConfiguration struct {
	SubscriptionConfig
	IConfigValidator
	DisablePolling bool                `config:"disablePolling"`
	Approval       *ApprovalConfig     `config:"approval"`
	Notifications  *NotificationConfig `config:"notifications"`
	Types          []NotificationType
}

SubscriptionConfiguration - Structure to hold the subscription config

func (*SubscriptionConfiguration) GetNotificationTypes 

func (s *SubscriptionConfiguration) GetNotificationTypes() []NotificationType

GetNotificationTypes -

func (*SubscriptionConfiguration) GetSMTPAuthType 

func (s *SubscriptionConfiguration) GetSMTPAuthType() SMTPAuthType

GetSMTPAuthType -

func (*SubscriptionConfiguration) GetSMTPFromAddress 

func (s *SubscriptionConfiguration) GetSMTPFromAddress() string

GetSMTPFromAddress -

func (*SubscriptionConfiguration) GetSMTPHost 

func (s *SubscriptionConfiguration) GetSMTPHost() string

GetSMTPHost - Returns the Host for the SMTP server

func (*SubscriptionConfiguration) GetSMTPIdentity 

func (s *SubscriptionConfiguration) GetSMTPIdentity() string

GetSMTPIdentity -

func (*SubscriptionConfiguration) GetSMTPPassword 

func (s *SubscriptionConfiguration) GetSMTPPassword() string

GetSMTPPassword -

func (*SubscriptionConfiguration) GetSMTPURL 

func (s *SubscriptionConfiguration) GetSMTPURL() string

GetSMTPURL - Returns the URL for the SMTP server

func (*SubscriptionConfiguration) GetSMTPUsername 

func (s *SubscriptionConfiguration) GetSMTPUsername() string

GetSMTPUsername -

func (*SubscriptionConfiguration) GetSubscribeFailedTemplate 

func (s *SubscriptionConfiguration) GetSubscribeFailedTemplate() *EmailTemplate

GetSubscribeFailedTemplate - returns the email template info for a subscribe

func (*SubscriptionConfiguration) GetSubscribeTemplate 

func (s *SubscriptionConfiguration) GetSubscribeTemplate() *EmailTemplate

GetSubscribeTemplate - returns the email template info for a subscribe

func (*SubscriptionConfiguration) GetSubscriptionApprovalMode 

func (s *SubscriptionConfiguration) GetSubscriptionApprovalMode() string

GetSubscriptionApprovalMode - Returns the subscription approval mode

func (*SubscriptionConfiguration) GetSubscriptionApprovalWebhookConfig 

func (s *SubscriptionConfiguration) GetSubscriptionApprovalWebhookConfig() WebhookConfig

GetSubscriptionApprovalWebhookConfig - Returns the Config for the subscription webhook

func (*SubscriptionConfiguration) GetUnsubscribeFailedTemplate 

func (s *SubscriptionConfiguration) GetUnsubscribeFailedTemplate() *EmailTemplate

GetUnsubscribeFailedTemplate - returns the email template info for an unsubscribe

func (*SubscriptionConfiguration) GetUnsubscribeTemplate 

func (s *SubscriptionConfiguration) GetUnsubscribeTemplate() *EmailTemplate

GetUnsubscribeTemplate - returns the email template info for an unsubscribe

func (*SubscriptionConfiguration) GetWebhookHeaders 

func (s *SubscriptionConfiguration) GetWebhookHeaders() map[string]string

GetWebhookHeaders - Returns the notification headers

func (*SubscriptionConfiguration) GetWebhookURL 

func (s *SubscriptionConfiguration) GetWebhookURL() string

GetWebhookURL - Returns the webhook url for notifications

func (*SubscriptionConfiguration) PollingEnabled 

func (s *SubscriptionConfiguration) PollingEnabled() bool

PollingEnabled - return true when the polling of subscriptsion should be ran on this agent

func (*SubscriptionConfiguration) SetNotificationType 

func (s *SubscriptionConfiguration) SetNotificationType(notificationType NotificationType)

SetNotificationType -

func (*SubscriptionConfiguration) ValidateCfg 

func (s *SubscriptionConfiguration) ValidateCfg() error

ValidateCfg - Validates the config, implementing IConfigInterface

type TLSCipherSuite 

type TLSCipherSuite uint16

TLSCipherSuite - defined type

func NewCipherArray 

func NewCipherArray(ciphers []string) []TLSCipherSuite

NewCipherArray - create an array of TLSCipherSuite

func (*TLSCipherSuite) String 

func (cs *TLSCipherSuite) String() string

func (*TLSCipherSuite) Unpack 

func (cs *TLSCipherSuite) Unpack(s string) error

Unpack - transforms the string into a constant.

type TLSConfig 

type TLSConfig interface {
	GetNextProtos() []string
	IsInsecureSkipVerify() bool
	GetCipherSuites() []TLSCipherSuite
	GetMinVersion() TLSVersion
	GetMaxVersion() TLSVersion
	BuildTLSConfig() *tls.Config
}

TLSConfig - interface

func NewTLSConfig 

func NewTLSConfig() TLSConfig

NewTLSConfig - build default config

type TLSConfiguration 

type TLSConfiguration struct {
	IConfigValidator
	// NextProtos is a list of supported application level protocols, in order of preference.
	NextProtos []string `config:"nextProtos,replace" json:"nextProtos,omitempty"`

	// InsecureSkipVerify controls whether a client verifies the server's certificate chain and host name.
	// If InsecureSkipVerify is true, TLS accepts any certificate presented by the server and any host
	// name in that certificate. In this mode, TLS is susceptible to man-in-the-middle attacks.
	// This should be used only for testing.
	InsecureSkipVerify bool `config:"insecureSkipVerify" json:"insecureSkipVerify,omitempty"`

	// CipherSuites is a list of supported cipher suites for TLS versions up to TLS 1.2. If CipherSuites
	// is nil, a default list of secure cipher suites is used, with a preference order based on hardware
	// performance. The default cipher suites might change over Go versions. Note that TLS 1.3
	// ciphersuites are not configurable.
	CipherSuites []TLSCipherSuite `config:"cipherSuites,replace" json:"cipherSuites,omitempty"`

	// MinVersion contains the minimum SSL/TLS version that is acceptable. If zero, then TLS 1.0 is taken as the minimum.
	MinVersion TLSVersion `config:"minVersion" json:"minVersion,omitempty"`

	// MaxVersion contains the maximum SSL/TLS version that is acceptable. If zero, then the maximum
	// version supported by this package is used, which is currently TLS 1.3.
	MaxVersion TLSVersion `config:"maxVersion" json:"maxVersion,omitempty"`

	// RootCertificate
	RootCertificatePath string `config:"rootCACertPath" json:"rootCACertPath,omitempty"`

	// Client Certificate Path
	ClientCertificatePath string `config:"clientCertPath" json:"clientCertPath,omitempty"`

	// Client Key Path
	ClientKeyPath string `config:"clientKeyPath" json:"clientKeyPath,omitempty"`
}

TLSConfiguration - A Config structure is used to configure a TLS client or server. After one has been passed to a TLS function it must not be modified. A Config may be reused; the tls package will also not modify it.

func (*TLSConfiguration) BuildTLSConfig 

func (c *TLSConfiguration) BuildTLSConfig() *tls.Config

BuildTLSConfig takes the TLSConfiguration and transforms it into a `tls.Config`.

func (*TLSConfiguration) GetCipherSuites 

func (c *TLSConfiguration) GetCipherSuites() []TLSCipherSuite

GetCipherSuites -

func (*TLSConfiguration) GetMaxVersion 

func (c *TLSConfiguration) GetMaxVersion() TLSVersion

GetMaxVersion -

func (*TLSConfiguration) GetMinVersion 

func (c *TLSConfiguration) GetMinVersion() TLSVersion

GetMinVersion -

func (*TLSConfiguration) GetNextProtos 

func (c *TLSConfiguration) GetNextProtos() []string

GetNextProtos -

func (*TLSConfiguration) IsInsecureSkipVerify 

func (c *TLSConfiguration) IsInsecureSkipVerify() bool

IsInsecureSkipVerify -

func (*TLSConfiguration) LoadFrom 

func (c *TLSConfiguration) LoadFrom(tlsCfg *tls.Config)

LoadFrom takes the `tls.Config` and transforms it into a TLSConfiguration.

func (*TLSConfiguration) ValidateCfg 

func (c *TLSConfiguration) ValidateCfg() (err error)

ValidateCfg - Validates the config, implementing IConfigInterface

type TLSVersion 

type TLSVersion uint16

TLSVersion - define type for version 

var TLSDefaultMinVersion TLSVersion = tls.VersionTLS12

TLSDefaultMinVersion - get the default min version

func TLSVersionAsValue 

func TLSVersionAsValue(cs string) TLSVersion

TLSVersionAsValue - get the version value

func (*TLSVersion) Unpack 

func (v *TLSVersion) Unpack(s string) error

Unpack transforms the string into a constant.

type UsageReportingConfig 

type UsageReportingConfig interface {
	GetURL() string
	CanPublishUsage() bool
	CanPublishMetric() bool
	GetInterval() time.Duration
	GetReportInterval() time.Duration
	GetUsageSchedule() string
	IsOfflineMode() bool
	GetSchedule() string
	GetReportSchedule() string
	GetReportGranularity() int
	UsingQAVars() bool
	Validate()
}

UsageReportingConfig - Interface to get usage reporting config

func NewUsageReporting 

func NewUsageReporting(platformURL string) UsageReportingConfig

NewUsageReporting - Creates the default usage reporting config

func ParseUsageReportingConfig 

func ParseUsageReportingConfig(props properties.Properties) UsageReportingConfig

ParseUsageReportingConfig - Parses the Usage Reporting Config values from the command line

type UsageReportingConfiguration 

type UsageReportingConfiguration struct {
	UsageReportingConfig
	Publish       bool          `config:"publish"`
	PublishMetric bool          `config:"publishMetric"`
	Interval      time.Duration `config:"interval"`
	UsageSchedule string        `config:"usageSchedule"`
	Offline       bool          `config:"offline"`
	Schedule      string        `config:"offlineSchedule"`
	URL           string
	// contains filtered or unexported fields
}

UsageReportingConfiguration - structure to hold all usage reporting settings

func (*UsageReportingConfiguration) CanPublishMetric 

func (u *UsageReportingConfiguration) CanPublishMetric() bool

CanPublishMetric - Returns the publish metric boolean

func (*UsageReportingConfiguration) CanPublishUsage 

func (u *UsageReportingConfiguration) CanPublishUsage() bool

CanPublishUsage - Returns the publish boolean

func (*UsageReportingConfiguration) GetInterval 

func (u *UsageReportingConfiguration) GetInterval() time.Duration

GetInterval - Returns the publish interval

func (*UsageReportingConfiguration) GetReportGranularity 

func (u *UsageReportingConfiguration) GetReportGranularity() int

GetReportGranularity - Returns the granularity used in the offline reports

func (*UsageReportingConfiguration) GetReportSchedule 

func (u *UsageReportingConfiguration) GetReportSchedule() string

GetReportSchedule - Returns the offline schedule string for creating reports

func (*UsageReportingConfiguration) GetSchedule 

func (u *UsageReportingConfiguration) GetSchedule() string

GetSchedule - Returns the schedule string

func (*UsageReportingConfiguration) GetURL 

func (u *UsageReportingConfiguration) GetURL() string

GetURL - Returns the usage reporting URL

func (*UsageReportingConfiguration) GetUsageSchedule added in v1.1.47 

func (u *UsageReportingConfiguration) GetUsageSchedule() string

GetUsageSchedule - Returns the schedule string for publishing reports

func (*UsageReportingConfiguration) IsOfflineMode 

func (u *UsageReportingConfiguration) IsOfflineMode() bool

IsOfflineMode - Returns the offline boolean

func (*UsageReportingConfiguration) UsingQAVars 

func (u *UsageReportingConfiguration) UsingQAVars() bool

UsingQAVars - Returns the offline boolean

func (*UsageReportingConfiguration) Validate 

func (u *UsageReportingConfiguration) Validate()

Validate -

type WebhookConfig 

type WebhookConfig interface {
	GetURL() string
	GetWebhookHeaders() map[string]string
	GetSecret() string
	IsConfigured() bool
	ValidateConfig() error
}

WebhookConfig - Interface for webhook config

func NewWebhookConfig 

func NewWebhookConfig() WebhookConfig

NewWebhookConfig -

type WebhookConfiguration 

type WebhookConfiguration struct {
	WebhookConfig
	URL     string `config:"url"`
	Headers string `config:"headers"`
	Secret  string `config:"secret"`
	// contains filtered or unexported fields
}

WebhookConfiguration - do NOT make this an IConfigValidator, as it is validated as part of subscriptionConfig

func (*WebhookConfiguration) GetSecret 

func (c *WebhookConfiguration) GetSecret() string

GetSecret - Returns the secret

func (*WebhookConfiguration) GetURL 

func (c *WebhookConfiguration) GetURL() string

GetURL - Returns the URL

func (*WebhookConfiguration) GetWebhookHeaders 

func (c *WebhookConfiguration) GetWebhookHeaders() map[string]string

GetWebhookHeaders - Returns the webhook headers

func (*WebhookConfiguration) IsConfigured 

func (c *WebhookConfiguration) IsConfigured() bool

IsConfigured - bool

func (*WebhookConfiguration) ValidateConfig 

func (c *WebhookConfiguration) ValidateConfig() error

ValidateConfig - Validate the config. Do NOT make this ValidateCfg IConfigValidator. It is called directly from the subscriptionconfig validator. But, it is ONLY called if the approvalMode is "webhook"

Source Files

View all Source files

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.