Spárujte zařízení

Tenhle návod ukazuje, jak spárovat telefon s Control Center, ať odkudkoli čteš zprávy a tickety a odpovídáš. Stejný postup spáruje i druhý prohlížeč nebo desktopovou aplikaci. Jak spojení funguje a jaký má model zabezpečení, je na stránce Vzdálené ovládání a mobil.

Předpoklady

Desktopový nebo webový klient připojený k tvému serveru a založený pracovní prostor. Operace párování vyžadují plného klienta, takže spárovaný telefon nikdy nemůže spárovat — ani odvolat — jiné zařízení.
Server dosažitelný ze zařízení, které páruješ. Ve stejné síti to funguje samo; z větší dálky provoz vozí zprostředkované relé. Když panel místo QR nebo pověření odpoví Nedostupné, nejdřív zveřejni cestu — zapnutí tunelu v Nastavení → Server → Připojení a stav (Sdílet tento server), nebo --public-url serveru (viz Spusťte headless server).
U telefonu: nic neinstaluješ. QR otevře webovou aplikaci Remote (ve výchozím stavu remote.usectrl.dev).

Vlastní hosting. Remote i zprostředkovatel relé jsou v tomhle repozitáři s otevřeným zdrojovým kódem: telefonní aplikace (apps/cc_remote, Flutter web PWA, kterou nasadíš na Cloudflare Pages přes její wrangler.jsonc, do nginx image docker/cc_remote, nebo na libovolný statický hostitel s HTTPS — service workery a IndexedDB fungují jen v zabezpečeném kontextu) a relé (apps/cc_signaling_server, jeden bezstavový binární soubor v Dartu, který nedrží data aplikace a tajemství párování nikdy neuvidí — přeposílá jen rámce zapečetěné od konce ke konci). Postup sestavení a spuštění je v jejich README.

Krok 1: Otevři panel párování

Otevři Nastavení → Vy → Vaše zařízení. Sekce Vaše zařízení vypisuje klienty spárované s tvým účtem na tomhle serveru. (Vlastník serveru vidí každé zařízení na serveru; ostatní vidí jen svoje.)

Krok 2: Spáruj nového klienta

V záhlaví stránky klikni na Spárovat nového klienta, dej mu popisek (např. „Můj telefon“), vyber typ — Webový prohlížeč, Desktopová aplikace nebo Telefon — a klikni na Spárovat.

U telefonu se objeví QR kód. Naskenuj ho kamerou telefonu, nebo odkaz zkopíruj a otevři v libovolném prohlížeči. Namíří aplikaci Remote na tvůj server a veze pověření.
U prohlížeče nebo desktopu místo toho zkopíruj zobrazený odkaz (nebo id zařízení a párovací klíč) do nového klienta. Odkaz na jedno klepnutí se nabízí jen tehdy, když páruješ z webového klienta, protože desktopový binární soubor nemá webový origin, ze kterého by se dal sestavit.

QR telefonu a odkaz, který na CLI vypíše cc_server pair --client-url, jsou jiné payloady a nejdou zaměnit: odkaz z CLI vyplní formulář připojení webového klienta, zatímco tenhle QR veze úplný deskriptor spojení serveru a otisk identity pro PWA Remote.

Na straně telefonu otevření párovacího odkazu nespáruje potichu. Remote ukáže inzerovaný název serveru a než cokoli uloží, požádá o potvrzení, takže podvržený odkaz nemůže aplikaci unést na cizí server.

Správa spárovaných zařízení

V Nastavení → Vy → Vaše zařízení můžeš:

Přejmenovat zařízení
Odvolat zařízení, kterému už nedůvěřuješ. Odvolání zničí jeho pověření a do několika sekund shodí živou relaci, takže se při opětovném připojení uzavře

Odvolání je správný krok u ztraceného nebo vyměněného telefonu. Z pohledu zařízení je okamžité a nevratné.

Pověření vydaná z tohohle panelu jsou časově omezená: vyprší 30 dní po vydání a brána připojení je potom uzavře. Pověření vydané přes cc_server pair na příkazovém řádku nevyprší vůbec — odvolej ho ručně, až se stroj, pro který bylo, vyřadí.

Přepínání pracovních prostorů z telefonu

Spárovaný telefon umí přepínat pracovní prostory nezávisle na desktopu. Telefon posílá pracovní prostor s každým voláním a server u každého zkontroluje tvoje členství a roli v tom pracovním prostoru — takže telefon dosáhne jen na pracovní prostory, ve kterých jsi členem, a přepnutí tam nikdy nezmění to, co ukazuje desktop.

Relace telefonu je navíc omezená na malý seznam povolených nástrojů, převážně ke čtení: umí vypsat a číst tickety, agenty, prostory, zprávy a články kanálu novinek a umí aktualizovat nebo přidělit ticket, poslat zprávu v prostoru a označit článek jako přečtený nebo uložený. Cokoli mimo tuhle sadu se odmítne ještě předtím, než se dostane k dispečeru serveru.

Související návody

Spusťte headless server: aby byl server vůbec dosažitelný
Připojte se ke vzdálenému serveru: namiř na něj plného klienta
Používejte prostory: to, co z telefonu budeš dělat nejčastěji
Vytvářejte a spravujte tickety: třídění na cestách