Skip to main content

HTTP

HTTP connections enable integration with any HTTP/HTTPS endpoint for API access, webhook integrations, and health checks.

Used By

Schema

FieldDescriptionSchemeRequired
urlBase URL for the HTTP endpointstringtrue
usernameUsername for basic authenticationEnvVar
passwordPassword for basic authenticationEnvVar
oauthOAuth 2.0 client credentials configurationOAuth
bearerBearer token for authenticationEnvVar
tlsTLS/SSL configuration for client certificatesTLS
connectionReference to an existing connectionstring

OAuth

FieldDescriptionSchemeRequired
tokenURLOAuth token endpoint URLstringtrue
clientIDOAuth client IDEnvVartrue
clientSecretOAuth client secretEnvVartrue
scopesOAuth scopes to request[]string
paramsAdditional parameters for token requestmap[string]string

TLS

FieldDescriptionScheme
keyPEM encoded client private keyEnvVar
caPEM encoded certificate of the CA to verify the server certificateEnvVar
certPEM encoded client certificateEnvVar
insecureSkipVerifySkip TLS certificate verification (not recommended for production)bool
handshakeTimeoutTLS handshake timeout (default: 10 seconds)time.Duration

Authentication Methods

Basic Authentication

basic-auth.yaml
apiVersion: mission-control.flanksource.com/v1
kind: Connection
metadata:
name: api-basic
spec:
http:
url: https://api.example.com
username:
value: api-user
password:
valueFrom:
secretKeyRef:
name: api-credentials
key: password

Bearer Token

bearer-token.yaml
apiVersion: mission-control.flanksource.com/v1
kind: Connection
metadata:
name: api-bearer
spec:
http:
url: https://api.example.com
bearer:
valueFrom:
secretKeyRef:
name: api-credentials
key: token

OAuth 2.0 Client Credentials

oauth.yaml
apiVersion: mission-control.flanksource.com/v1
kind: Connection
metadata:
name: api-oauth
spec:
http:
url: https://api.example.com
oauth:
tokenURL: https://auth.example.com/oauth/token
clientID:
valueFrom:
secretKeyRef:
name: oauth-credentials
key: client-id
clientSecret:
valueFrom:
secretKeyRef:
name: oauth-credentials
key: client-secret
scopes:
- read
- write

Mutual TLS (mTLS)

mtls.yaml
apiVersion: mission-control.flanksource.com/v1
kind: Connection
metadata:
name: api-mtls
spec:
http:
url: https://secure-api.example.com
tls:
cert:
valueFrom:
secretKeyRef:
name: mtls-certs
key: client.crt
key:
valueFrom:
secretKeyRef:
name: mtls-certs
key: client.key
ca:
valueFrom:
secretKeyRef:
name: mtls-certs
key: ca.crt