appsec

Documentation

Index

• func Enabled() bool
• func Start(*Config)
• func Stop()
• type APIError
  • func (e APIError) Error() string
• type AuthTokenError
  • func (e AuthTokenError) Error() string
• type Config
• type InvalidSignalError
  • func (e InvalidSignalError) Error() string
• type ServiceConfig

Functions

func Enabled

func Enabled() bool

Enabled returns true when AppSec is up and running. Meaning that the appsec build tag is enabled, the env var DD_APPSEC_ENABLED is set to true, and the tracer is started.

func Start

func Start(*Config)

Start AppSec when enabled is enabled by both using the appsec build tag and setting the environment variable DD_APPSEC_ENABLED to true.

func Stop

func Stop()

Stop AppSec.

Types

type APIError

type APIError struct {
	Response *http.Response
}

APIError is the generic request error returned when the request status code is unknown.

func (APIError) Error

func (e APIError) Error() string

Error return the error string representation.

type AuthTokenError

type AuthTokenError APIError

AuthTokenError is a request error returned when the request could not be authenticated.

func (AuthTokenError) Error

func (e AuthTokenError) Error() string

Error return the error string representation.

type Config

type Config struct {
	// Client is the HTTP client to use to perform HTTP requests to the agent. This value is mandatory.
	Client *http.Client
	// AgentURL is the datadog agent URL the API client should use.
	AgentURL string
	// ServiceConfig is the information about the running service we currently protect.
	Service ServiceConfig
	// Tags is the list of tags that should be added to security events (eg. pid, os name, etc.).
	Tags map[string]interface{}
	// Hostname of the machine we run in.
	Hostname string
	// Version of the Go client library
	Version string

	// MaxBatchLen is the maximum batch length the event batching loop should use. The event batch is sent when
	// this length is reached. Defaults to 1024.
	MaxBatchLen int
	// MaxBatchStaleTime is the maximum amount of time events are kept in the batch. This allows to send the batch
	// after this amount of time even if the maximum batch length is not reached yet. Defaults to 1 second.
	MaxBatchStaleTime time.Duration
	// contains filtered or unexported fields
}

Config is the AppSec configuration.

type InvalidSignalError

type InvalidSignalError APIError

InvalidSignalError is a request error returned when one or more signal(s) sent are invalid.

func (InvalidSignalError) Error

func (e InvalidSignalError) Error() string

Error return the error string representation.

type ServiceConfig

type ServiceConfig struct {
	// Name of the service.
	Name string
	// Version of the service.
	Version string
	// Environment of the service (eg. dev, staging, prod, etc.)
	Environment string
}

ServiceConfig is the optional context about the running service.