Emparelhar um dispositivo

Este guia mostra como emparelhar um telefone com o Control Center, para você ler mensagens e tickets e responder de qualquer lugar. O mesmo fluxo emparelha um segundo navegador ou app de desktop. Consulte Controle remoto e mobile para saber como o link funciona e qual é o seu modelo de segurança.

Pré-requisitos

Um cliente desktop ou web conectado ao seu servidor e um espaço de trabalho configurado. As operações de emparelhamento exigem um cliente completo, então um telefone emparelhado nunca pode emparelhar — nem revogar — outro dispositivo.
O servidor acessível a partir do dispositivo que você está emparelhando. Na mesma rede, isso simplesmente funciona; de mais longe, o relay intermediado carrega o tráfego. Se o painel responder Inacessível em vez de um QR ou credenciais, publique um caminho primeiro — a opção de túnel em Configurações → Servidor → Conexão e status (Compartilhar este servidor), ou o --public-url do servidor (consulte Executar um servidor headless).
Para um telefone: nada a instalar. O QR abre o app web Remote (remote.usectrl.dev por padrão).

Auto-hospedagem. O Remote e o broker do relay são de código aberto neste repositório: o app do telefone (apps/cc_remote, uma PWA web em Flutter que você pode implantar no Cloudflare Pages pelo seu wrangler.jsonc, na imagem nginx docker/cc_remote, ou em qualquer host estático com HTTPS — service workers e IndexedDB dependem de contexto seguro) e o relay (apps/cc_signaling_server, um único binário Dart sem estado que não guarda dados do app e nunca vê o segredo do emparelhamento — ele encaminha apenas frames selados de ponta a ponta). Consulte os READMEs deles para as etapas de build e execução.

Etapa 1: Abrir o painel de emparelhamento

Abra Configurações → Você → Seus dispositivos. A seçã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 demais veem apenas os seus.)

Etapa 2: Emparelhar um novo cliente

Clique em Emparelhar um novo cliente no cabeçalho da página, dê um rótulo a ele (ex.: “Meu telefone”), escolha o tipo — Navegador web, App de desktop ou Telefone — e clique em Emparelhar.

Para um telefone, um código QR aparece. Leia-o com a câmera do telefone, ou copie o link e abra-o em qualquer navegador. Ele aponta o app Remote para o seu servidor e carrega a credencial.
Para um navegador ou desktop, copie o link exibido (ou o id do dispositivo e a chave de emparelhamento) para o novo cliente. O link de um toque só é oferecido quando você emparelha a partir do cliente web, já que um binário de desktop não tem uma origem web a partir da qual montá-lo.

O QR do telefone e o link que cc_server pair --client-url imprime na CLI são payloads diferentes e não são intercambiáveis: o link da CLI preenche o formulário de conexão do cliente web, enquanto este QR carrega o descritor de conexão completo do servidor e a impressão digital de identidade para a PWA Remote.

No lado do telefone, abrir um link de emparelhamento não emparelha silenciosamente. O Remote mostra o nome anunciado pelo servidor e pede que você confirme antes de armazenar qualquer coisa, então um link forjado não pode sequestrar o app para o servidor de outra pessoa.

Gerenciar dispositivos emparelhados

Em Configurações → Você → Seus dispositivos, você pode:

Renomear um dispositivo
Revogar um dispositivo em que você não confia mais. A revogação destrói a credencial dele e encerra a sessão ativa em poucos segundos, então ele é rejeitado ao tentar se reconectar

Revogar é a atitude certa para um telefone perdido ou substituído. É imediato e irreversível do ponto de vista do dispositivo.

As credenciais emitidas neste painel têm prazo limitado: elas expiram 30 dias após a emissão e, depois disso, a verificação de conexão passa a rejeitá-las. Uma credencial emitida com cc_server pair na linha de comando não tem validade alguma — revogue-a manualmente quando a máquina para a qual ela servia for aposentada.

Trocar de espaço de trabalho pelo telefone

Um telefone emparelhado pode alternar entre espaços de trabalho independentemente do desktop. O telefone envia o espaço de trabalho em cada chamada e o servidor confere a sua associação e o seu papel nesse espaço de trabalho a cada uma delas — assim, o telefone alcança apenas os espaços de trabalho dos quais você é membro, e alternar ali nunca muda o que o desktop mostra.

Uma sessão de telefone é ainda restrita a uma pequena lista de permissões de ferramentas com foco em leitura: ela pode listar e ler tickets, agentes, espaços, mensagens e artigos do feed, além de atualizar ou atribuir um ticket, enviar uma mensagem em um espaço e marcar um artigo como lido ou salvo. Qualquer coisa fora desse conjunto é recusada antes de chegar ao dispatcher do servidor.

Guias relacionados

Executar um servidor headless: torne o servidor acessível em primeiro lugar
Conectar a um servidor remoto: aponte um cliente completo para ele
Usar espaços: o que você vai fazer a maior parte do tempo pelo telefone
Criar e gerenciar tickets: faça a triagem em qualquer lugar