Emparelhar um dispositivo

Este guia mostra-lhe como emparelhar um telemóvel com o Control Center, para que possa ler mensagens e tickets e responder de qualquer lugar. O mesmo fluxo emparelha um segundo navegador ou uma aplicação para computador. Consulte Controlo remoto e telemóvel para saber como a ligação funciona e qual é o seu modelo de segurança.

Pré-requisitos

Um cliente de computador ou web ligado ao seu servidor e um espaço de trabalho configurado. As operações de emparelhamento exigem um cliente completo, pelo que um telemóvel emparelhado nunca pode emparelhar — ou revogar — outro dispositivo.
O servidor acessível a partir do dispositivo que está a emparelhar. Na mesma rede isto funciona sem mais; a partir de mais longe, é o relay intermediado que transporta o tráfego. Se o painel responder Inacessível em vez de um código QR ou de credenciais, publique primeiro um caminho — a opção de túnel em Definições → Servidor → Ligação e status (Partilhar este servidor), ou o --public-url do servidor (ver Executar um servidor headless).
Para um telemóvel: não há nada para instalar. O código QR abre a aplicação web Remote (remote.usectrl.dev por predefinição).

Alojamento próprio. O Remote e o broker do relay são de código aberto neste repo: a aplicação para telemóvel (apps/cc_remote, uma PWA Flutter para web que pode implementar no Cloudflare Pages através do seu wrangler.jsonc, na imagem nginx docker/cc_remote, ou em qualquer alojamento estático com HTTPS — os service workers e o IndexedDB exigem um contexto seguro) e o relay (apps/cc_signaling_server, um único binário Dart sem estado que não guarda dados da aplicação e nunca vê o segredo de emparelhamento — apenas reencaminha frames selados ponto a ponto). Consulte os respetivos READMEs para os passos de compilação e execução.

Passo 1: Abrir o painel de emparelhamento

Abra Definições → Você → Seus dispositivos. A secção Seus dispositivos lista os clientes emparelhados com a sua conta neste servidor. (O proprietário do servidor vê todos os dispositivos do servidor; todos os outros vêem apenas os seus.)

Passo 2: Emparelhar um novo cliente

Clique em Emparelhar um novo cliente no cabeçalho da página, atribua-lhe um rótulo (por exemplo, “O meu telemóvel”), escolha o tipo — Navegador web, Aplicação para computador ou Telefone — e clique em Emparelhar.

Para um telemóvel, aparece um código QR. Leia-o com a câmara do telemóvel, ou copie o link e abra-o em qualquer navegador. Este aponta a aplicação Remote ao seu servidor e transporta a credencial.
Para um navegador ou computador, copie antes o link apresentado (ou o id do dispositivo e a chave de emparelhamento) para o novo cliente. O link de um clique só é oferecido quando está a emparelhar a partir do cliente web, uma vez que um binário de computador não tem uma origem web a partir da qual o construir.

O código QR do telemóvel e o link que cc_server pair --client-url imprime na CLI são cargas úteis diferentes e não são intercambiáveis: o link da CLI preenche o formulário de ligação do cliente web, enquanto este código QR transporta o descritor de ligação completo do servidor e a impressão digital de identidade para a PWA Remote.

Do lado do telemóvel, abrir um link de emparelhamento não emparelha em silêncio. O Remote mostra o nome anunciado do servidor e pede-lhe que confirme antes de guardar seja o que for, pelo que um link forjado não pode desviar a aplicação para o servidor de outra pessoa.

Gerir dispositivos emparelhados

Em Definições → Você → Seus dispositivos pode:

Renomear um dispositivo
Revogar um dispositivo em que já não confia. A revogação destrói a sua credencial e encerra a sua sessão ativa em segundos, pelo que falha de forma fechada na reconexão

A revogação é a medida certa para um telemóvel perdido ou substituído. É imediata e irreversível do ponto de vista do dispositivo.

As credenciais emitidas a partir deste painel têm prazo limitado: expiram 30 dias após a emissão e a verificação de ligação recusa-as de forma fechada a partir daí. Uma credencial emitida com cc_server pair na linha de comandos não tem expiração nenhuma — revogue-a manualmente quando a máquina a que se destinava for reformada.

Mudar de espaço de trabalho a partir do telemóvel

Um telemóvel emparelhado pode alternar entre espaços de trabalho independentemente do computador. O telemóvel envia o espaço de trabalho em todas as chamadas e o servidor verifica a sua pertença e função nesse espaço de trabalho em cada uma delas — pelo que o telemóvel só alcança os espaços de trabalho de que é membro, e alternar aí nunca altera o que o computador mostra.

Uma sessão de telemóvel está ainda restringida a uma pequena lista de permissões de ferramentas predominantemente de leitura: pode listar e ler tickets, agentes, espaços, mensagens e artigos do feed, e pode atualizar ou atribuir um ticket, enviar uma mensagem num espaço e marcar um artigo como lido ou guardado. Tudo o que fique fora desse conjunto é recusado antes de chegar ao despachante do servidor.

Guias relacionados

Executar um servidor headless: tornar o servidor alcançável antes de mais
Ligar a um servidor remoto: apontar um cliente completo para ele
Usar espaços: aquilo que fará sobretudo a partir do telemóvel
Criar e gerir tickets: triagem em movimento