ws server

The ws server binding converts inbound http request-response streams into ws full-duplex streams.

ws_server:
  type: ws
  kind: server
  exit: echo_server
  routes:
    - when:
        - protocol: mqtt
      exit: mqtt_server

Configuration (* required)

routes*

array of object

Conditional ws specific routes.

routes:
  - when:
      - protocol: echo
  exit: echo_server

routes[].guarded

object as map of named array of string

List of roles required by each named guard to authorize this route.

routes:
  - guarded:
      my_guard:
        - read:items

routes[].when

array of object

List of conditions (any match) to match this route. Read more: When a route matches

routes:
  - when:
      - protocol: echo

when[].protocol

string

Subprotocol pattern.

when[].scheme

string

Scheme pattern.

when[].authority

string

Authority pattern.

when[].path

string

Path pattern.

routes[].exit

string

Next binding when following this route.

routes:
  - when:
    ...
    exit: echo_server

exit

string

Default exit binding when no conditional routes are viable.

exit: echo_server

telemetry

object

Defines the desired telemetry for the binding.

telemetry.metrics

array

Telemetry metrics to track

telemetry:
  metrics:
    - stream.*