Realtime: Sicherheit.
Steuern Sie den Zugriff auf private Updates mit Ihren bestehenden Sitzungsregeln.
POST/bird/auth
POST/bird/auth
Geben Sie Clients einen öffentlichen Schlüssel
und behalten Sie die Signierschlüssel auf Ihrem Server.
Eine App auf der Bird Realtime API trennt die Zugangsdaten für Client-Verbindungen von den Backend-Befugnissen. Browser und mobile Apps öffnen WebSockets mit einem öffentlichen App-Schlüssel, den Sie gefahrlos in Client-Bundles einbetten können. Ihr Backend verwahrt das Secret, mit dem es Ereignisse veröffentlicht und Abonnement-Tokens signiert. Wenn Ihre Sicherheitsrichtlinie eine Rotation der Zugangsdaten verlangt, erstellen Sie ein zweites Schlüsselpaar, rollen es in Ihren Diensten aus und widerrufen das vorherige Paar, ohne aktive Nutzer zu trennen.
Schützen Sie Verbindungen, Kanäle und Payloads auf jeder Ebene
Prüfen Sie, wer einen Socket öffnen darf, autorisieren Sie, welchen Kanälen jemand beitritt, verschlüsseln Sie sensible Ereignisdaten und sperren Sie den Zugriff, sobald eine Sitzung endet.
01Signierte Kanalabonnements.
Wenn ein Browser- oder Mobile-Client einen privaten oder Presence-Kanal abonniert, prüft Ihr Backend die Sitzung des Nutzers und signiert ein HMAC-SHA256-Token, das an genau diese Verbindungs-ID und diesen Kanalnamen gebunden ist. Da die Signatur an die Socket-ID gebunden ist, lässt sich ein Token nicht auf einer anderen Verbindung wiederverwenden. Presence-Signaturen legen zudem die Mitgliedsidentität fest, die im Raum angezeigt wird.02Authentifizierte WebSocket-Verbindungen.
Da Ihr öffentlicher App-Schlüssel im Client-Code liegt, könnte jeder Besucher versuchen, einen inaktiven WebSocket zu öffnen. Wenn Sie autorisierte Verbindungen aktivieren, muss sich ein neuer Socket innerhalb von 30 Sekunden über Ihr Backend authentifizieren, entweder per Anmeldung oder durch das Abonnieren eines privaten Kanals. Nicht verifizierte Sockets werden automatisch geschlossen und zählen nicht zu Ihrem Verbindungskontingent.03Ende-zu-Ende-verschlüsselte Payloads.
Für regulierte oder vertrauliche Updates verschlüsselt das Server-SDK Ereignis-Payloads lokal mit einem 32-Byte-Hauptschlüssel, der in Ihrer Infrastruktur bleibt. Jeder verschlüsselte Kanal leitet seinen eigenen Entschlüsselungsschlüssel ab. Wer für einen vertraulichen Stream freigegeben ist, erhält daher keinen Zugriff auf einen anderen. Zwischengeschaltete Server sehen während der Übertragung nur Chiffretext.04Sofortiger Widerruf von Sitzungen.
Wenn sich ein Nutzer abmeldet, sein Passwort ändert oder den Zugriff auf den Workspace verliert, trennt ein einziger Serveraufruf seine Mitgliedsidentität in allen offenen Browser-Tabs und auf allen Mobilgeräten. Clients behandeln die Trennung als endgültig, statt sich in einer Schleife neu zu verbinden. Ihr Auth-Endpunkt kann weitere Anmeldeversuche ablehnen, sobald die Sitzung widerrufen ist.
Verschlüsselte Channels
Versiegeln Sie sensible Payloads, bevor sie Ihren Server verlassen.
Konfigurieren Sie im Server-SDK einen 32-Byte-Hauptschlüssel, um vertrauliche Ereignisse vor dem Veröffentlichen in Ihrem eigenen Prozess zu verschlüsseln. Bird leitet den versiegelten Umschlag an die Abonnenten weiter, und Ihr Autorisierungsendpunkt liefert den abgeleiteten Entschlüsselungsschlüssel des Kanals an freigegebene Browser-Clients. Sie können die Verschlüsselung auch mit dem Caching des letzten Ereignisses kombinieren, sodass neu verbundene Clients den aktuellen Stand als Chiffretext erhalten. Halten Sie Kanal- und Ereignisnamen dabei allgemein, denn Routing-Metadaten bleiben unverschlüsselt.
const bird = new BirdClient({
apiKey: process.env.BIRD_API_KEY!,
realtime: {
key: process.env.BIRD_REALTIME_KEY,
secret: process.env.BIRD_REALTIME_SECRET,
// 32 random bytes, yours alone. Never sent to Bird.
encryptionMasterKey: process.env.BIRD_REALTIME_MASTER_KEY,
},
});
// Sealed in your process. The edge forwards ciphertext.
await bird.realtime.publish(APP_ID, {
event: "order.updated",
channels: ["private-encrypted-orders"],
data: { order_id: "ord_123", status: "shipped" },
});
Isolieren Sie Mandanten-Streams und validieren Sie Zustände auf Ihrem Server.
Verbindungsauthentifizierung und Kanalautorisierung decken unterschiedliche Teile der Zugriffskontrolle ab. Autorisierte Verbindungen blockieren anonyme Sockets, während private und Presence-Kanäle festlegen, welcher angemeldete Nutzer oder Mandant einen bestimmten Stream lesen darf. Senden Sie kundenspezifische Updates über private Kanäle, die Ihr Auth-Endpunkt verifiziert. Nutzen Sie Client-zu-Client-Ereignisse für flüchtige UI-Signale wie Tippindikatoren, und leiten Sie zustandsändernde Aktionen über Ihr Backend.
Binden Sie Traffic an eine Region und trennen Sie Umgebungen per App.
Wählen Sie beim Erstellen einer Realtime-App eine dedizierte Region, damit WebSocket-Verbindungen und veröffentlichte Ereignisse nah bei Ihren Nutzern bleiben, auch wenn die Heimatregion Ihres Workspace anderswo liegt. Jede App läuft in einem eigenen isolierten Namespace mit separaten Zugangsdaten und Kontingenten. Mit getrennten Apps für Entwicklung, Staging und Produktion gelangen Test-Broadcasts daher nicht in Live-Kundenkanäle.
Implementierungsleitfäden für Ihr Backend.
Unter Kanäle autorisieren finden Sie das Format der Webhook-Anfrage und die Signierhilfen des SDK. Unter Autorisierte Verbindungen erzwingen setzen Sie den 30-Sekunden-Verbindungshandshake durch, unter Verschlüsselte Kanäle konfigurieren Sie Hauptschlüssel und Schlüsselrotation, und unter Mitgliedsverbindungen beenden richten Sie Nutzeranmeldung und Remote-Trennung ein.
Entwickeln Sie weiter mit Realtime.
Kombinieren Sie Kanalautorisierung mit Live-Presence, Zustands-Caching und Backend-Webhooks, alles mit denselben App-Zugangsdaten.
Verbindung 26911.052733
Verbindung 26896.319537
Channels
Leiten Sie öffentliche Broadcasts, private Streams, verschlüsselte Payloads und gecachte Zustände per Kanalpräfix.
Presence
Zeigen Sie, wer über Tabs und Geräte hinweg online ist, verfolgen Sie Abgänge und senden Sie einzelnen Nutzern direkt Nachrichten.
Sam hat zwei Tabs geöffnet
presence-operationsEin Tab wird geschlossen
Sam hat noch eine aktive Verbindung. Kein member_removed-Ereignis.
Der letzte Tab wird geschlossen
Das Mitglied verlässt diesen Presence-Kanal.
Benachrichtigung zustellen
realtime.member_removed identifiziert Mitglied und Kanal.
Maya hat zwei Tabs geöffnet
presence-operationsEin Tab wird geschlossen
Maya hat noch eine aktive Verbindung. Kein member_removed-Ereignis.
Der letzte Tab wird geschlossen
Das Mitglied verlässt diesen Presence-Kanal.
Benachrichtigung zustellen
realtime.member_removed identifiziert Mitglied und Kanal.
Sam hat zwei Tabs geöffnet
Ein Tab wird geschlossen
Der letzte Tab wird geschlossen
Benachrichtigung zustellen
Maya hat zwei Tabs geöffnet
Ein Tab wird geschlossen
Der letzte Tab wird geschlossen
Benachrichtigung zustellen
Webhooks
Starten Sie Backend-Workflows, wenn Kanäle aktiv werden, Mitglieder gehen oder ein Cache vorgewärmt werden muss.
Skalieren, ohne die Kontrolle zu verlieren.
Trennen Sie Produktions- und Sandbox-Traffic in eigene Workspaces, beschränken Sie API-Schlüssel auf genau die Kanäle, die jeder Dienst oder Agent benötigt, und verfolgen Sie Berechtigungsänderungen im Audit-Log.