Associa un dispositivo

Questa guida mostra come associare un telefono a Control Center, così puoi leggere messaggi e ticket e rispondere da qualsiasi luogo. Lo stesso flusso associa un secondo browser o un’app desktop. Vedi Controllo remoto e mobile per come funziona il collegamento e il suo modello di sicurezza.

Prerequisiti

Un client desktop o web connesso al tuo server e uno spazio di lavoro configurato. Le operazioni di abbinamento richiedono un client completo, quindi un telefono associato non può mai associare — né revocare — un altro dispositivo.
Il server raggiungibile dal dispositivo che stai associando. Sulla stessa rete funziona e basta; da più lontano il traffico passa dal relay intermediato da un broker. Se il pannello risponde Non raggiungibile invece di mostrare un codice QR o delle credenziali, pubblica prima un percorso — l’opt-in del tunnel in Impostazioni → Server → Connessione e stato (Condividi questo server), oppure l’opzione --public-url del server (vedi Esegui un server headless).
Per un telefono: niente da installare. Il codice QR apre l’app web Remote (remote.usectrl.dev per impostazione predefinita).

Ospitare da sé. Remote e il broker del relay sono open source in questo repo: l’app per telefono (apps/cc_remote, una PWA web Flutter che puoi distribuire su Cloudflare Pages tramite il suo wrangler.jsonc, sull’immagine nginx docker/cc_remote, oppure su qualsiasi host statico con HTTPS — i service worker e IndexedDB richiedono un contesto sicuro) e il relay (apps/cc_signaling_server, un singolo binario Dart senza stato che non conserva dati dell’app e non vede mai il segreto di abbinamento — inoltra solo frame sigillati end-to-end). Vedi i rispettivi README per i passaggi di compilazione ed esecuzione.

Passaggio 1: apri il pannello di abbinamento

Apri Impostazioni → Tu → I tuoi dispositivi. La sezione I tuoi dispositivi elenca i client associati al tuo account su questo server. (Il proprietario del server vede tutti i dispositivi sul server; chiunque altro vede solo i propri.)

Passaggio 2: associa un nuovo client

Fai clic su Associa un nuovo client nell’intestazione della pagina, assegnagli un nome (ad es. «Il mio telefono»), scegli il tipo — Browser web, App desktop o Telefono — e fai clic su Associa.

Per un telefono compare un codice QR. Inquadralo con la fotocamera del telefono, oppure copia il link e aprilo in un qualsiasi browser. Indica all’app Remote il tuo server e trasporta la credenziale.
Per un browser o un desktop, copia invece il link mostrato (o l’ID dispositivo e la chiave di abbinamento) nel nuovo client. Il link a un tocco viene offerto solo quando esegui l’abbinamento dal client web, perché un binario desktop non ha un’origine web da cui generarlo.

Il codice QR del telefono e il link che cc_server pair --client-url stampa sulla CLI sono payload diversi e non intercambiabili: il link della CLI compila il modulo di connessione del client web, mentre questo codice QR trasporta il descrittore di connessione completo del server e l’impronta dell’identità per la PWA Remote.

Sul telefono, aprire un link di abbinamento non associa nulla in modo silenzioso. Remote mostra il nome annunciato dal server e ti chiede di confermare prima di memorizzare qualsiasi cosa, quindi un link falsificato non può dirottare l’app su un server altrui.

Gestisci i dispositivi associati

Da Impostazioni → Tu → I tuoi dispositivi puoi:

Rinomina un dispositivo
Revoca un dispositivo di cui non ti fidi più. La revoca distrugge la sua credenziale e chiude la sessione attiva entro pochi secondi, quindi fallisce in modo restrittivo alla riconnessione

La revoca è la mossa giusta per un telefono perso o sostituito. È immediata e irreversibile dal punto di vista del dispositivo.

Le credenziali create da questo pannello hanno una scadenza: scadono 30 giorni dopo il rilascio e, dopo, il gate di connessione le rifiuta in modo restrittivo. Una credenziale creata con cc_server pair dalla riga di comando non ha alcuna scadenza — revocala manualmente quando la macchina a cui era destinata viene dismessa.

Cambia spazio di lavoro dal telefono

Un telefono associato può passare da uno spazio di lavoro all’altro in modo indipendente dal desktop. Il telefono invia lo spazio di lavoro a ogni chiamata e il server verifica la tua appartenenza e il tuo ruolo in quello spazio a ogni chiamata — quindi il telefono raggiunge solo gli spazi di lavoro di cui sei membro e cambiare da lì non modifica mai ciò che mostra il desktop.

Una sessione del telefono è inoltre limitata a una piccola allow-list di strumenti prevalentemente di lettura: può elencare e leggere ticket, agenti, spazi, messaggi e articoli delle notizie, e può aggiornare o assegnare un ticket, inviare un messaggio in uno spazio e contrassegnare un articolo come letto o salvato. Qualunque cosa fuori da quell’insieme viene rifiutata prima di raggiungere il dispatcher del server.

Guide correlate

Esegui un server headless: rendi raggiungibile il server in primo luogo
Connettiti a un server remoto: punta su di esso un client completo
Usa gli spazi: ciò che farai per lo più dal telefono
Crea e gestisci i ticket: fai il triage in viaggio