Publieke kanalen
Een Realtime-kanaal is publiek, tenzij de naam begint met private- of presence-. Een client heeft alleen de publieke app-sleutel nodig om zich te abonneren, dus behandel het kanaal als leesbaar voor iedereen met die sleutel.
const orders = bird.subscribe("orders");
orders.bind("order-updated", (data) => {
console.log(data);
});let orders = bird.subscribe("orders")
orders.bind("order-updated") { data in
print(data ?? "")
}val orders = bird.subscribe("orders")
orders.bind("order-updated") { data ->
println(data)
}Publieke kanalen vereisen geen registratie of autorisatie-endpoint. Een kanaal bestaat zolang ten minste één verbinding geabonneerd is en verdwijnt wanneer de laatste verbinding vertrekt.
Wanneer gebruik je een publiek kanaal
Gebruik publieke kanalen voor gegevens die elke bezoeker mag lezen, zoals buildresultaten, live scores, vluchtinformatie, kijkersaantallen of statuspagina-incidenten.
Gebruik een privékanaal voor gegevens die bij een gebruiker, account of tenant horen. Publieke kanaalabonnementen vereisen geen autorisatie, dus een client kan elke kanaalnaam proberen die hij kan raden of samenstellen.
Beperkingen van publieke kanalen
- Ledenidentiteit: Publieke kanalen houden leden niet bij en tonen geen ledenlijst. De events bird:member_added en bird:member_removed horen bij presence-kanalen.
- Client-events: Publieke kanalen weigeren events waarvan de naam begint met client-. Gebruik een geautoriseerd privé- of presence-kanaal voor client-afkomstige events.
Verbindingsaantallen
Het tellen van verbindingen werkt op elk kanaaltype. Schakel Connection counting en Connection count events in om bird:connection_count te ontvangen met het aantal geabonneerde verbindingen.
Naamgeving
Kanaalnamen zijn hoofdlettergevoelig en kunnen maximaal 164 letters, cijfers en de volgende tekens bevatten: _ - = @ , . ;. Zo identificeren Orders en orders verschillende kanalen.
Houd gevoelige of klantidentificerende gegevens uit publieke kanaalnamen. orders onthult geen klantinformatie. orders-user-4821 toont het bestaan van gebruiker 4821 aan iedereen die toegang heeft tot de applicatie.
Volgende stappen
- Privékanalen beperken abonnementen tot clients die door je backend zijn goedgekeurd.
- Events publiceren legt uit hoe je vanaf je server publiceert en naar meerdere kanalen verzendt.
- Realtime-overzicht definieert kanalen, leden en verbindingen.
Gerelateerde bronnen
Ga verder met de documentatie, handleidingen en voorbeelden voor dit onderwerp.