KMNS logo KMNS / Validate Docs
v0.4.0 ← Platform Hub GitHub ↗

HTTP Probes

Validates live HTTP and HTTPS endpoints directly using native kernel sockets and embedded TLS 1.3 without relying on curl or external binaries.


Canonical Specification (v1alpha1)

schema_version: kmns.io/validate/v1alpha1
id: ingress-http-gate
metadata:
  name: Web Ingress HTTP Health
  description: Asserts health endpoint status, TLS headers, and body

checks:
  - kind: resource
    id: web-health-check
    metadata:
      name: Web Healthz Endpoint
      tags: ["production", "edge"]
    resource:
      kind: http
      url: "https://127.0.0.1:443/healthz"
      timeout_ms: 3000
    expect:
      status: 200
      body_contains: "ok"

  - kind: resource
    id: api-version-check
    metadata:
      name: API Version Manifest
      tags: ["production"]
    resource:
      kind: http
      url: "https://127.0.0.1:443/api/v1/version.json"
      request_headers:
        - "Accept: application/json"
    expect:
      status: 200
      headers:
        Content-Type: "application/json"

Supported Attributes

AttributeTypeDefaultDescription
urlstringRequiredTarget HTTP or HTTPS URL to probe
methodstringGETHTTP request method (GET, POST, HEAD)
timeout_msinteger5000Request timeout in milliseconds
allow_insecurebooleanfalseSkip TLS certificate validation (dev testing only)
no_follow_redirectsbooleanfalseDo not follow HTTP 3xx redirects
request_headerslist of strings[]Additional request headers (Header-Name: value)
statusinteger200Expected HTTP response status code
body_containsstring-Substring required in response body
headersmap of strings{}Required response headers