Netwerkvereisten (firewall en proxy)

Op deze pagina staat alles wat een netwerkbeheerder moet toestaan zodat Lumicast-players en de Lumicast-webapp goed werken.

Kort gezegd: sta uitgaand HTTPS-verkeer (poort 443) toe naar de Lumicast-domeinen hieronder. Meer is niet nodig. Geen inkomende verbindingen, geen port forwarding, geen VPN en geen afwijkende poortnummers.

Poorten

Richting	Protocol	Poort	Vereist
Uitgaand	HTTPS (en WebSocket via TLS)	443	Ja
Uitgaand	HTTP (stuurt door naar HTTPS)	80	Aanbevolen
Inkomend	alles	alle	Nee

Lumicast vraagt je nooit om een poort in je firewall open te zetten. Players starten de verbinding altijd zelf en maken alleen uitgaande verbindingen via standaard HTTPS. Live updates lopen via een WebSocket over dezelfde verbinding op poort 443. Een extra regel is dus niet nodig, zolang je firewall of proxy WebSocket-upgrades niet tegenhoudt (zie Proxy's en TLS-inspectie).

We sturen ook geen verkeer naar afwijkende poorten aan jouw kant en maken nooit verbinding met je netwerk van buitenaf.

Domeinen die je moet toestaan

Lumicast gebruikt drie domeinen:

Domein	Wat je toestaat	Gebruikt voor
lumicast.com	Het hele domein (aanbevolen)	Webapp, inloggen, API, WebSocket-updates, player-downloads
lumicast.app	*.lumicast.app (alle subdomeinen op het eerste niveau)	Apps en ingesloten content die op je schermen wordt weergegeven
lumicast.media	Minimaal cdn.lumicast.media	Afbeeldingen, video's, lettertypes en andere media

Waarom deze regels zo ruim zijn:

• Binnen elk van deze domeinen gebruiken we subdomeinen. We kunnen niet garanderen dat elk subdomein altijd hetzelfde blijft, of dat er later geen nieuwe bijkomen.
• Bij lumicast.app moet alles op het eerste subdomeinniveau bereikbaar zijn: *.lumicast.app. Elke app krijgt daar een eigen subdomein.
• Bij lumicast.com raden we aan het hele domein toe te staan, omdat we in de loop van de tijd diensten toevoegen en soms hernoemen.

We publiceren geen vaste lijst met hostnamen

Onze hostnamen veranderen als we diensten toevoegen of hernoemen. Een lijst die je vandaag opschrijft, werkt dus vroeg of laat niet meer. Maak daarom per domein een regel aan in plaats van losse hostnamen op een allowlist te zetten.

Hoe databronnen je schermen bereiken

Een veelgestelde vraag is welke externe systemen een scherm moet kunnen bereiken om databronnen en apps te laten werken. Voor de ingebouwde integraties is het antwoord: geen enkel.

Al het ophalen, pollen en verwerken gebeurt aan de kant van Lumicast:

1. Lumicast vraagt de integratie of API volgens een schema op (of ontvangt een webhook), op onze servers.
2. Lumicast bewaart het laatste resultaat.
3. Het resultaat gaat via de bestaande HTTPS/WebSocket-verbinding met Lumicast naar je schermen.

Een scherm met een weer-app, een treinvertrektijden-app of een SharePoint-lijst praat dus niet zelf met de weerdienst, de API van het spoor of SharePoint. Het praat alleen met Lumicast. De drie domeinen hierboven toestaan is genoeg.

Databronnen op je eigen netwerk

Dit werkt ook andersom: koppel je een databron aan een API die alleen binnen je eigen netwerk bereikbaar is, dan kan Lumicast die niet bereiken. Onze servers doen het pollen, dus de API moet via internet bereikbaar zijn. Een webhook-databron is meestal de oplossing, omdat je systeem de data dan zelf naar ons stuurt.

Lumicast toestaan op je eigen API

Stel je een API open voor Lumicast en wil je beperken wie hem kan aanroepen? Houd er dan rekening mee dat we op dit moment geen vaste set uitgaande IP-adressen kunnen garanderen. Gebruik liever authenticatie (een API-sleutel, een token of een ondertekende webhook) dan een IP-allowlist. Is een IP-allowlist voor jou een harde eis, neem dan contact op via team@lumicast.com, dan kijken we samen met je mee.

Content die je zelf toevoegt

Sommige content laadt het scherm rechtstreeks bij een externe partij, omdat de content nu eenmaal zo werkt:

• De app Webpage, die de URL laadt die je invult.
• De apps YouTube, Vimeo en Video Stream, die streamen vanaf de aanbieder die je opgeeft.
• Afbeeldingen of bestanden waarnaar je via een externe URL verwijst in plaats van ze naar Lumicast te uploaden.

Gebruik je een van deze, sta dan ook de domeinen van die content toe. Media die je naar Lumicast uploadt, komt van cdn.lumicast.media en heeft verder niets nodig.

Lettertypes

Gebruikt een pagina een lettertype van Google Fonts, dan laadt het scherm de lettertypebestanden van:

• fonts.googleapis.com
• fonts.gstatic.com

Lettertypes die je zelf naar Lumicast uploadt, komen van cdn.lumicast.media. Is Google Fonts geblokkeerd, dan worden pagina's nog steeds weergegeven, maar met een standaardlettertype.

Proxy's en TLS-inspectie

Gebruikt je netwerk een proxy of een firewall met TLS-inspectie? Controleer dan het volgende:

• WebSocket-verbindingen moeten zijn toegestaan. Schermen houden een WebSocket naar Lumicast open om contentwijzigingen direct te ontvangen. Is die geblokkeerd, dan toont een scherm nog steeds content, maar komen updates laat of helemaal niet binnen.
• Bij TLS-inspectie moet het apparaat het rootcertificaat vertrouwen. Op sommige player-apparaten (Samsung Tizen, LG webOS, Android TV) is dat lastig of onmogelijk. Kan een scherm geen verbinding maken terwijl een gewone computer op hetzelfde netwerk dat wel kan, dan is een inspecterende proxy meestal de oorzaak. De eenvoudigste oplossing is de Lumicast-domeinen uit te sluiten van inspectie.
• Captive portals en gastwifi waarbij je regelmatig opnieuw in de browser moet inloggen, verbreken de verbinding van schermen. Zet schermen op een netwerksegment zonder portal, of zet hun MAC-adressen op een allowlist.

Controleren of het werkt

Vanaf een apparaat op hetzelfde netwerk als het scherm:

1. Open https://app.lumicast.com in een browser. De pagina moet laden en je moet kunnen inloggen.
2. Open https://cdn.lumicast.media in een browser. Elke reactie behalve een verbindingsfout of een blokkade door beleid betekent dat het domein bereikbaar is.

Op het scherm zelf toont het servicemenu de huidige verbindingsstatus. Toont een scherm wel een koppelcode maar komt het nooit online, dan is meestal een geblokkeerde WebSocket de oorzaak en niet een geblokkeerd domein.

Kom je er nog steeds niet uit? Neem contact op via team@lumicast.com en vermeld de naam van het scherm en het merk van de firewall of proxy die je gebruikt.