Skip to main content

Connections

AWS

FieldDescriptionTypeRequired
connection Mutually exclusive with accessKey and secretKey Connections
accessKeyAccess keyEnvVar
secretKeySecret keyEnvVar
regionRegionstring
endpointEndpointstring
skipTLSVerifySkip TLS verifybool
objectPathObject pathstring
usePathStyleUse path stylebool

There are 3 options when connecting to AWS:

AWS Instance or Pod Identity

By using the AWS Instance Profile or Pod Identity (the default if no connection or accessKey is specified)

Connection

Using a shared Connection

aws-connection.yaml
apiVersion: canaries.flanksource.com/v1
kind: Canary
metadata:
name: cloudwatch-check
spec:
interval: 30
cloudwatch:
- connection: connection://aws/internal
region: us-east-1 # optional if specified in the connection
Inline
inline.yaml
apiVersion: canaries.flanksource.com/v1
kind: Canary
metadata:
name: cloudwatch-check
spec:
interval: 30
cloudwatch:
- accessKey:
valueFrom:
secretKeyRef:
name: aws-credentials
key: AWS_ACCESS_KEY_ID
secretKey:
valueFrom:
secretKeyRef:
name: aws-credentials
key: AWS_SECRET_ACCESS_KEY
region: us-east-1

GCP

FieldDescriptionTypeRequired
connection Mutually exclusive with credentials4 Connections
endpointEndpointstring
credentialsCredentialsEnvVar to service account JSON

There are 3 options when connecting to GCP:

GKE Workload Identity

GKE workload identity (the default if no connection or credentials is specified)

Connection
gcs-connection.yaml
apiVersion: canaries.flanksource.com/v1
kind: Canary
metadata:
name: database-backup-check
spec:
interval: 60
folder:
- name: gcs auth test
path: gcs://somegcsbucket
gcpConnection:
connection: connection://gcp/internal
Inline
gcp-inline.yaml
apiVersion: canaries.flanksource.com/v1
kind: Canary
metadata:
name: database-backup-check
spec:
interval: 60
folder:
- name: gcs auth test
path: gcs://somegcsbucket
gcpConnection:
credentials:
valueFrom:
secretKeyRef:
name: gcp-credentials
key: AUTH_ACCESS_TOKEN

Azure

FieldDescriptionTypeRequired
connection Connections
clientIDClient IDEnvVar
clientSecretClient SecretEnvVar
tenantIDTenant IDstring

SFTP

FieldDescriptionScheme
connectionPath of existing connection e.g. connection://sftp/instance
Mutually exclusive with username
Connection
usernameutually exclusive with connectionEnvVar
password Mutually exclusive with connection EnvVar
hostCustom AWS Cloudwatch endpointstring
portDefault to 22int

SMB

FieldDescriptionScheme
connectionPath of existing connection e.g. connection://windows/svc-account
Mutually exclusive withusername and password
Connections
username Mutually exclusive with connection EnvVar
password Mutually exclusive with connection EnvVar
domainWindows domain namestring
portDefault to 445int