utils

Documentation

Index

• Constants
• func AwsConfigFromCredentials(accessKeyId string, secretAccessKey string, sessionToken string, ...) aws.Config
• func CoalesceErr(args ...error) error
• func CustomUserAgentApiOptions(uniqueCorrelationId uuid.UUID) config.LoadOptionsFunc
• func DownloadAllObjects(client *s3.Client, bucketName string) error
• func FileExists(path string) bool
• func GetCurrentAccountId(cfg aws.Config) (string, error)
• func IndexOf[T comparable](slice []T, searchValue T) int
• func IsErrorDueToEBSEncryptionByDefault(err error) bool
• func ListAllObjectVersions(s3Client *s3.Client, bucketName string) ([]s3types.ObjectIdentifier, error)
• func MD5HashBase64(text string) string
• func Min(a int, b int) int
• func RandomHexString(length int) string
• func RandomString(length int) string
• func Remove(slice []string, index int) []string
• func SHA256Hash(input string) string
• func UploadFile(s3Client *s3.Client, bucketName string, filename string, contents io.Reader) error
• func WaitForAndAssumeAWSRole(awsConnection *aws.Config, roleArn string) error
• func WaitForInstanceToRegisterInSSM(ssmClient *ssm.Client, instanceId string) error
• func WaitForInstancesToRegisterInSSM(ssmClient *ssm.Client, instanceIds []string) error

Constants

const AttackerEmailEnvVarKey = "STRATUS_RED_TEAM_ATTACKER_EMAIL"

Functions

func AwsConfigFromCredentials

func AwsConfigFromCredentials(accessKeyId string, secretAccessKey string, sessionToken string, detonationUid *uuid.UUID) aws.Config

func CoalesceErr

func CoalesceErr(args ...error) error

func CustomUserAgentApiOptions

func CustomUserAgentApiOptions(uniqueCorrelationId uuid.UUID) config.LoadOptionsFunc

func DownloadAllObjects

func DownloadAllObjects(client *s3.Client, bucketName string) error

func FileExists

func FileExists(path string) bool

func GetCurrentAccountId

func GetCurrentAccountId(cfg aws.Config) (string, error)

func IndexOf

func IndexOf[T comparable](slice []T, searchValue T) int

IndexOf returns the index of a given value in a slice, or -1 if not found

func IsErrorDueToEBSEncryptionByDefault

func IsErrorDueToEBSEncryptionByDefault(err error) bool

func ListAllObjectVersions

func ListAllObjectVersions(s3Client *s3.Client, bucketName string) ([]s3types.ObjectIdentifier, error)

func MD5HashBase64

func MD5HashBase64(text string) string

func Min

func Min(a int, b int) int

The Min function returns the smallest of two integers Note: math.Min only works for float64

func RandomHexString

func RandomHexString(length int) string

func RandomString

func RandomString(length int) string

func Remove

func Remove(slice []string, index int) []string

Remove removes an element from a slice at a given index

func SHA256Hash

func SHA256Hash(input string) string

func UploadFile

func UploadFile(s3Client *s3.Client, bucketName string, filename string, contents io.Reader) error

func WaitForAndAssumeAWSRole

func WaitForAndAssumeAWSRole(awsConnection *aws.Config, roleArn string) error

WaitForAndAssumeAWSRole waits for an AWS role to be assumable (due to eventual consistency) then sets a credentials provider that can be used to assume the role.

func WaitForInstanceToRegisterInSSM

func WaitForInstanceToRegisterInSSM(ssmClient *ssm.Client, instanceId string) error

utility function for a single instance

func WaitForInstancesToRegisterInSSM

func WaitForInstancesToRegisterInSSM(ssmClient *ssm.Client, instanceIds []string) error

WaitForInstancesToRegisterInSSM waits for a set of instances to be registered in SSM may be slow (60+ seconds)