Een apparaat koppelen

Deze gids laat zien hoe je een telefoon aan Control Center koppelt, zodat je overal berichten en tickets kunt lezen en erop kunt antwoorden. Dezelfde flow koppelt ook een tweede browser of desktopapp. Zie Afstandsbediening en mobiel voor hoe de verbinding werkt en wat het beveiligingsmodel is.

Vereisten

Een desktop- of webclient die met je server is verbonden en een ingestelde werkruimte. Koppelingsbewerkingen vereisen een volledige client, dus een gekoppelde telefoon kan nooit een ander apparaat koppelen — of intrekken.
De server bereikbaar vanaf het apparaat dat je koppelt. Op hetzelfde netwerk werkt dit gewoon; verder weg draagt de relay met broker het verkeer. Als het paneel Niet bereikbaar antwoordt in plaats van een QR-code of referenties, publiceer dan eerst een route — de tunneloptie bij Instellingen → Server → Verbinding en status (Deze server delen), of de --public-url van de server (zie Een headless server draaien).
Voor een telefoon: niets te installeren. De QR opent de Remote-webapp (remote.usectrl.dev standaard).

Zelf hosten. Remote en de relay-broker zijn opensource in deze repo: de telefoonapp (apps/cc_remote, een Flutter-web-PWA die je naar Cloudflare Pages kunt deployen via zijn wrangler.jsonc, naar de nginx-image docker/cc_remote, of naar elke statische host met HTTPS — service workers en IndexedDB zijn gebonden aan een secure context) en de relay (apps/cc_signaling_server, één stateless Dart-binary die geen app-gegevens bevat en het koppelingsgeheim nooit ziet — hij stuurt alleen end-to-end verzegelde frames door). Zie hun README’s voor de stappen om te builden en te draaien.

Stap 1: Het koppelingspaneel openen

Open Instellingen → Jij → Je apparaten. De sectie Je apparaten toont de clients die aan je account zijn gekoppeld op deze server. (De servereigenaar ziet elk apparaat op de server; alle anderen zien alleen hun eigen apparaten.)

Stap 2: Een nieuwe client koppelen

Klik op Een nieuwe client koppelen in de paginakop, geef hem een label (bijv. “Mijn telefoon”), kies het type — Webbrowser, Desktop-app of Telefoon — en klik op Koppelen.

Voor een telefoon verschijnt een QR-code. Scan die met de camera van de telefoon, of kopieer de link en open hem in een willekeurige browser. Hij wijst de Remote-app naar je server en bevat de referentie.
Voor een browser of desktop kopieer je in plaats daarvan de getoonde link (of het apparaat-id en de koppelingssleutel) naar de nieuwe client. De link voor één klik wordt alleen aangeboden wanneer je vanuit de webclient koppelt, omdat een desktop-binary geen web-origin heeft om er een te bouwen.

De telefoon-QR en de link die cc_server pair --client-url op de CLI afdrukt, zijn verschillende payloads en niet uitwisselbaar: de CLI-link vult het verbindingsformulier van de webclient in, terwijl deze QR de volledige verbindingsdescriptor en identiteitsvingerafdruk van de server bevat voor de Remote-PWA.

Aan de telefoonkant koppelt het openen van een koppelingslink niet stilzwijgend. Remote toont de naam die de server adverteert en vraagt je om te bevestigen voordat er iets wordt opgeslagen, zodat een vervalste link de app niet kan kapen naar de server van iemand anders.

Gekoppelde apparaten beheren

Vanuit Instellingen → Jij → Je apparaten kun je:

Naam wijzigen van een apparaat
Intrekken van een apparaat dat je niet meer vertrouwt. Intrekken vernietigt de referentie en verbreekt de live-sessie binnen enkele seconden, dus bij opnieuw verbinden faalt het gesloten

Intrekken is de juiste stap voor een verloren of vervangen telefoon. Het is onmiddellijk en onomkeerbaar vanuit het perspectief van het apparaat.

Referenties die via dit paneel worden aangemaakt, zijn tijdgebonden: ze verlopen 30 dagen na afgifte en de verbindingscontrole faalt daarna gesloten. Een referentie die met cc_server pair op de opdrachtregel is aangemaakt, heeft helemaal geen vervaldatum — trek hem handmatig in wanneer de machine waarvoor hij bedoeld was, buiten gebruik gaat.

Van werkruimte wisselen vanaf de telefoon

Een gekoppelde telefoon kan onafhankelijk van de desktop tussen werkruimtes wisselen. De telefoon stuurt de werkruimte mee met elke aanroep en de server controleert bij elke aanroep je lidmaatschap en rol in die werkruimte — dus de telefoon bereikt alleen werkruimtes waarvan je lid bent en wisselen daar verandert nooit wat de desktop toont.

Een telefoonsessie is bovendien beperkt tot een kleine allow-list van tools die vooral lezen: hij kan tickets, agenten, ruimtes, berichten en nieuwsfeedartikelen opvragen en lezen, en hij kan een ticket bijwerken of toewijzen, een bericht in een ruimte sturen en een artikel als gelezen of bewaard markeren. Alles buiten die set wordt geweigerd voordat het de dispatcher van de server bereikt.

Gerelateerde gidsen

Een headless server draaien: zorg ervoor dat de server überhaupt bereikbaar is
Verbinden met een externe server: wijs er een volledige client naar
Ruimtes gebruiken: wat je vanaf de telefoon vooral zult doen
Tickets maken en beheren: triëren onderweg