HTTP

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

Used By

• HTTP Health Check - Monitor HTTP endpoints
• HTTP Scraper - Scrape configuration from APIs
• HTTP Action - Make HTTP requests in playbooks
• Notifications - Send webhook notifications

Schema

Field	Description	Scheme	Required
url	Base URL for the HTTP endpoint	string	true
username	Username for basic authentication	EnvVar
password	Password for basic authentication	EnvVar
oauth	OAuth 2.0 client credentials configuration	OAuth
bearer	Bearer token for authentication	EnvVar
tls	TLS/SSL configuration for client certificates	TLS
connection	Reference to an existing connection	string

OAuth

Field	Description	Scheme	Required
tokenURL	OAuth token endpoint URL	string	true
clientID	OAuth client ID	EnvVar	true
clientSecret	OAuth client secret	EnvVar	true
scopes	OAuth scopes to request	[]string
params	Additional parameters for token request	map[string]string

TLS

Field	Description	Scheme
key	PEM encoded client private key	EnvVar
ca	PEM encoded certificate of the CA to verify the server certificate	EnvVar
cert	PEM encoded client certificate	EnvVar
insecureSkipVerify	Skip TLS certificate verification (not recommended for production)	bool
handshakeTimeout	TLS 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