Glossary
Definitions for concepts and terms used in rstream.
This glossary defines the terms used across the rstream documentation. It focuses on rstream-specific concepts and on the networking terms that matter when operating tunnels.
Agent
The process inside a private environment that connects outward to the rstream engine and relays traffic to local services. The agent can be the
rstreamCLI, or code that embeds an rstream SDK.Engine
The rstream edge network entrypoint. The engine hosts tunnel endpoints, enforces authentication and access policies, and forwards traffic through tunnels to agents.
Tunnel
An endpoint hosted by the engine that relays traffic to an upstream target through an agent connection. A tunnel has properties such as protocol, type (bytestream/datagram), labels, and edge security settings.
Public tunnel
A tunnel that is reachable using standard clients (for example a browser for HTTP). Public tunnels are designed for edge termination and proxying so authentication and policies can be enforced before traffic reaches upstream.
Private tunnel
A tunnel that is not exposed as a public Internet endpoint. Private tunnels are designed to be accessed through rstream SDK clients that dial the tunnel by name or ID.
Upstream / Downstream
Downstream refers to the client-side connection into the engine from the Internet. Upstream refers to the connection the engine makes to the service through the tunnel and agent.
Bytestream tunnel
A stream-oriented tunnel type (TCP-like). It is the natural fit for HTTP/1.1, HTTP/2 cleartext (h2c), TLS tunnels, SSH-style access, and most private tunnel workflows.
Datagram tunnel
A packet-oriented tunnel type (UDP-like). Published DTLS and QUIC tunnels use datagram semantics, and HTTP/3 also uses a datagram tunnel in the rstream model.
Tunnel protocol
The protocol the engine exposes to downstream clients for a public tunnel, such as HTTP, TLS, DTLS, or QUIC. Protocol choice affects edge behavior and which security features are available.
Tunnel transport
The secure connection between the agent and the engine. Transport is independent of the tunnel protocol and can be tuned with options such as proxying, DNS override, and interface binding.
Context
A named CLI configuration entry that typically includes an engine endpoint and optional authentication token. Contexts allow switching between projects and environments without rewriting commands.
Project
A grouping concept used by the hosted platform. Projects typically collect tunnels, credentials, and access controls. In the CLI, projects are represented by contexts.
Labels
Structured key-value metadata attached to clients, tunnels, and related runtime resources. Labels make short-lived resources easier to reconcile with application objects such as devices, environments, customers, regions, or service roles.
Token authentication for HTTP tunnels
An HTTP tunnel mode where the engine requires a valid rstream token on every request. Tokens can be provided as a bearer header or as a query parameter.
rstream auth
An HTTP tunnel mode intended for browser-based access where the engine can maintain an authenticated session (typically via a cookie) rather than requiring a bearer token on every request.
Challenge mode
An HTTP tunnel access mode where the engine requires an interactive browser challenge before forwarding requests upstream.
Personal access token
A long-lived token created in the Dashboard. PATs are intended for operators and automation and can be revoked or rotated.
Application credentials
A long-lived credential pair (client ID + client secret) used to mint short-lived application tokens locally. Application credentials are intended for software products that integrate rstream and need to distribute scoped tokens to clients or devices.
Fine-grained token
A token that includes scoped permissions limiting what it can create, list, or connect to, often using filters and selection sets based on tunnel properties such as protocol, labels, or HTTP path.
Control plane
The managed API surface used for accounts, workspaces, projects, credentials, billing, TURN credential issuance, and other platform operations. It is separate from the engine runtime that carries tunnel traffic.
Data plane
The runtime path used by rstream clients and engines to create tunnels, accept connections, relay traffic, and watch live tunnel state.
MCP
Model Context Protocol, a protocol for exposing tools and resources to AI agents. rstream provides MCP surfaces for project discovery, tunnel operations, logs, events, webhook inspection, and controlled local or remote access workflows.
Outbound-only connectivity
A network shape where agents and SDKs initiate connections from the private environment to the edge. The private network does not need an inbound listener or public IP address for rstream to reach the upstream service.
Zero trust access
An access model where reachability alone is not treated as authorization. In rstream, tunnel access can be constrained by tokens,
resources.tunnelsboundaries, edge authentication, trusted IPs, GeoIP restrictions, TLS policy, and project-wide access policies.Edge authentication
Authentication performed by the engine before a published request or connection is forwarded upstream. HTTP tunnels can use token auth, rstream Auth, and challenge mode; edge-terminated TLS surfaces can use mTLS where configured.
Access policy
A project-wide runtime requirement enforced by the engine. Access policies can restrict public tunnel creation, source IPs, GeoIP, minimum TLS version, post-quantum key exchange behavior, and Encrypted Client Hello behavior.
Tunnel resource
A token or credential restriction that limits tunnel access to specific workspaces, projects, tunnel properties, labels, list fields, or HTTP paths. In the public token contract this is encoded under
resources.tunnels. Resource boundaries are reduced as tokens are derived and are enforced by the engine.HTTP tunnel
A published tunnel where the engine accepts HTTP traffic and forwards HTTP requests to an upstream service. HTTP tunnels support request-level controls, connection reuse, WebSocket, plain CONNECT, HTTP/3 WebTransport, and MASQUE protocols when the runtime enables them.
TLS tunnel
A published bytestream tunnel that accepts TLS traffic at the edge. TLS tunnels can terminate TLS at the edge or pass the encrypted TLS session through to the upstream service.
DTLS tunnel
A published datagram tunnel that accepts DTLS traffic at the edge. It is designed for UDP-style protocols that need DTLS semantics rather than HTTP semantics.
QUIC tunnel
A published datagram tunnel for custom QUIC application protocols. It is distinct from QUIC tunnel transport, which is the client-to-engine transport used by rstream clients.
HTTP/3
The HTTP version that runs over QUIC. In rstream, HTTP/3 is used by HTTP tunnels with
h3upstream mode and by WebTransport, CONNECT-UDP, and CONNECT-IP flows.Plain HTTP CONNECT
The standard HTTP forward proxy method for TCP targets. A client sends
CONNECT host:port, the upstream proxy decides whether to allow that target, and a 2xx response turns the stream or connection into an opaque byte tunnel.Extended CONNECT
An HTTP/2 and HTTP/3 form of
CONNECTthat carries a protocol token such aswebsocket,webtransport,connect-udp, orconnect-ip. The same pattern lets upgraded sessions remain on the HTTP tunnel path.HTTP Datagrams
The HTTP mechanism for associating unreliable datagram payloads with an HTTP request. rstream uses HTTP Datagrams for HTTP/3 WebTransport and MASQUE sessions.
Capsule Protocol
An HTTP stream format used by upgrade tokens to exchange reliable control messages. CONNECT-IP uses capsules for address assignment and route advertisement, and CONNECT-UDP can use capsules alongside HTTP Datagrams.
MASQUE
A family of HTTP proxying protocols that tunnel datagram traffic through HTTP. In rstream documentation, MASQUE usually refers to CONNECT-UDP and CONNECT-IP over published HTTP/3 datagram tunnels.
CONNECT-UDP
A MASQUE protocol for proxying UDP payloads over HTTP. rstream relays CONNECT-UDP through HTTP/3 datagram tunnels to an upstream UDP proxy service.
CONNECT-IP
A MASQUE protocol for proxying IP packets over HTTP. rstream relays CONNECT-IP through HTTP/3 datagram tunnels to an upstream IP proxy service that owns address assignment, routes, and packet policy.
WebSocket
An HTTP-based upgrade mechanism that creates a bidirectional stream. rstream HTTP tunnels relay WebSocket across HTTP/1.1, h2c, and HTTP/3 upstream modes.
WebTransport
An HTTP/3 transport that supports bidirectional streams, unidirectional streams, and datagrams. Browser and native clients can use WebTransport when they match the draft version supported by the runtime.
ALPN
Application-Layer Protocol Negotiation, the TLS extension used to select an application protocol during the handshake. rstream uses ALPN for HTTP versions and for custom TLS, DTLS, and QUIC protocol selection.
Mutual TLS
A TLS mode where the client presents a certificate and the engine maps it to a client certificate credential. In rstream, mTLS can authenticate agent control-channel connections, and it can also protect public traffic entering edge-terminated published tunnel endpoints. It does not authenticate the Engine HTTP API and does not apply to TLS passthrough.
PKCS#11
A standard API for using private keys held by hardware or software security modules. rstream SDKs can use PKCS#11-backed keys for mTLS agent authentication with devices such as YubiKeys, HSMs, smart cards, TPM-backed modules, or SoftHSM validation tokens.
Hardened credential storage
Credential storage modes that avoid placing long-lived secrets directly in the rstream YAML configuration, such as macOS Keychain token storage, Keychain mTLS identities, and PKCS#11-backed mTLS private keys.
Encrypted Client Hello
A TLS feature that encrypts sensitive ClientHello metadata when the client and DNS configuration support it. rstream can prefer or require ECH on supported edge-terminated project surfaces.
Post-quantum key exchange
TLS key exchange using hybrid post-quantum groups where supported by the runtime and clients. rstream project policy can prefer or require hybrid groups for edge-terminated TLS surfaces.
WebRTC
A browser and native real-time media stack for audio, video, and data channels. In rstream architectures, tunnels commonly publish signaling surfaces, while managed STUN/TURN and application labels help connect transient device sessions to durable application state.
STUN
Session Traversal Utilities for NAT, a protocol used by WebRTC clients to discover network-facing addresses. rstream exposes STUN alongside TURN for WebRTC connectivity.
ICE
Interactive Connectivity Establishment, the WebRTC connectivity framework that gathers candidates, checks candidate pairs, and selects the path used for media. rstream supports ICE workflows through tunnel-published signaling and managed STUN/TURN.
SCTP
Stream Control Transmission Protocol, a message-oriented transport that can multiplex streams. rstream examples include SCTP over datagram tunnels and over published DTLS endpoints.
TURN
Traversal Using Relays around NAT, a relay service used when direct WebRTC connectivity cannot be established. rstream can issue or derive scoped TURN credentials for projects.
Stable domain
A reusable tunnel hostname requested by the client and validated by the engine. Stable domains make reconnecting tunnels keep predictable public addresses.
WebTTY
A remote terminal protocol integrated with rstream. A WebTTY server runs next to a machine and can be published through a tunnel, making it accessible from browsers and remote clients while still being controlled by rstream authentication and policies.
Webhook
A configured endpoint that receives signed project lifecycle events outside the live signaling connection. Webhooks are used to update durable application state when clients or tunnels appear and disappear, especially when labels identify the corresponding application object.
Signaling
A real-time event stream that reports changes in clients, tunnels, and (in some builds) stream summaries. Signaling can be consumed over SSE or WebSocket and is used to build inventories and reactive systems.