Learn how Edge connects your backend and application users.
Introduction
Seuraa Edge is a managed realtime service for delivering application events to connected clients. It makes sense when you need realtime features but do not want to build and operate the delivery infrastructure yourself.
Edge is built for applications that want a European realtime provider with strict EU data governance. Event delivery, account data, operational logs, and product analytics are kept within EU-operated systems, with the active Edge region documented in Regions.
Your backend controls identity and access. It authenticates users, chooses the channels they may access, and issues channel tokens. Client applications use those tokens to subscribe and, when permitted, publish events.
We recommend using short token lifetimes for client-issued channel access, especially for private and presence channels.
Core Concepts
| Concept | Description |
|---|---|
| App | An isolated Edge tenant identified by an app key. |
| Channel | A named stream of events within an app. |
| Event | A named JSON payload published to a channel. |
| Channel token | A credential granting a user specific channel permissions. |
| Presence | Live membership information for a presence:* channel. |
| API token | A scoped credential for account-level integrations. |
Application Flow
- A user signs in to your application.
- A client application subscribes to a channel.
- The Edge client requests a channel token from your backend.
- Your backend authorizes the user and signs the token.
- Edge validates the token and connects the user to the channel.
- Events published to the channel are delivered to its subscribers.
Install
Install the SDK for each runtime you use:
pnpm add @seuraa/edge@0.1.2
pnpm add @seuraa/edge-node@0.1.2