Kvindo™ Cloud Docs


Language

HTTPS Listener

An HTTPS Listener terminates TLS at the load balancer and forwards decrypted HTTP traffic to Target Groups via its HTTPS Listener Rules. It presents a Certificate you supply — or one generated automatically via Let's Encrypt — and can optionally enable HTTP/2.

Key concepts

Load balancer — the LB this listener belongs to (spec.loadbalancerId)

TLS — the Certificate and TLS protocol versions used to terminate traffic (spec.tls)

HTTP/2 — optionally negotiate HTTP/2 with clients (spec.enableHttp2Support)

Ports / Hosts — the ports to accept on, and an optional host-header filter

Parameters
UI Name API / kc name Terraform name Optional Format Default Is read only Description
Load balancer spec.loadbalancerId spec.loadbalancer_id No ULID — references a Load Balancer No The load balancer this listener belongs to
Interface spec.interface spec.interface Yes string — all / public / private all No Which network interface to bind on
Order spec.order spec.order Yes integer 0 No Tie-breaking priority when multiple listeners match
Ports spec.ports spec.ports No list of string No Ports the listener accepts connections on
Hosts spec.hosts spec.hosts Yes list of string [] No Optional host-header filter
Enable HTTP/2 spec.enableHttp2Support spec.enable_http2_support Yes boolean false No Negotiate HTTP/2 with clients
TLS spec.tls spec.tls No object No TLS termination config
Certificate spec.tls.certificateId certificate_id Yes ULID (nullable) — references a Certificate No Certificate used to terminate TLS
Protocols spec.tls.protocols protocols Yes list of string — e.g. TLSv1.2, TLSv1.3 No Allowed TLS protocol versions
Auto-generate certificate spec.tls.autogenerateCertificate autogenerate_certificate Yes boolean false No Issue a certificate automatically via Let's Encrypt (HTTP-01 challenge) instead of supplying one. Only works if the load balancer has a public IP and every spec.hosts entry already resolves to it
Security rules spec.securityRules spec.security_rules Yes list of rule objects — {order, description, action, ipV4Blocks, ipV6Blocks} [] No IP allow/deny list applied before routing
Examples

An HTTPS listener on port 443 that terminates TLS with a self-managed certificate. Let's Encrypt auto-issuance is not used: it needs the domain's DNS to point at the load balancer's IP first, which isn't known until the load balancer exists.

Terraform

Python SDK

kc CLI


Related pages

Resource docs

Examples

More in this section

An unhandled error has occurred. Reload 🗙