Emparejar un dispositivo

Esta guía te muestra cómo emparejar un teléfono con Control Center, para que puedas leer mensajes y tickets y responder desde cualquier sitio. El mismo flujo sirve para emparejar un segundo navegador o una app de escritorio. Consulta Control remoto y móvil para saber cómo funciona el enlace y cuál es su modelo de seguridad.

Requisitos previos

Un cliente de escritorio o web conectado a tu servidor y un espacio de trabajo configurado. Las operaciones de emparejamiento requieren un cliente completo, así que un teléfono emparejado nunca puede emparejar —ni revocar— otro dispositivo.
Que se pueda llegar al servidor desde el dispositivo que estás emparejando. En la misma red funciona sin más; desde más lejos, es el relé intermediado el que lleva el tráfico. Si el panel responde No accesible en lugar de un QR o unas credenciales, publica antes una ruta: la activación opcional del túnel en Ajustes → Servidor → Conexión y estado (Compartir este servidor), o el --public-url del servidor (consulta Ejecutar un servidor headless).
Para un teléfono: no hay nada que instalar. El QR abre la app web Remote (remote.usectrl.dev de forma predeterminada).

Autoalojamiento. Remote y el broker del relé son de código abierto en este repositorio: la app del teléfono (apps/cc_remote, una PWA de Flutter web que puedes desplegar en Cloudflare Pages mediante su wrangler.jsonc, en la imagen nginx docker/cc_remote, o en cualquier host estático con HTTPS —los service workers y IndexedDB solo están disponibles en contextos seguros—) y el relé (apps/cc_signaling_server, un único binario de Dart sin estado que no guarda datos de la app y nunca ve el secreto de emparejamiento: solo reenvía tramas selladas de extremo a extremo). Consulta sus README para los pasos de compilación y ejecución.

Paso 1: Abrir el panel de emparejamiento

Abre Ajustes → Tú → Tus dispositivos. La sección Tus dispositivos enumera los clientes emparejados con tu cuenta en este servidor. (El propietario del servidor ve todos los dispositivos del servidor; los demás solo ven los suyos).

Paso 2: Vincular un nuevo cliente

Haz clic en Vincular un nuevo cliente en la cabecera de la página, ponle una etiqueta (por ejemplo, «Mi teléfono»), elige el tipo —Navegador web, Aplicación de escritorio o Teléfono— y haz clic en Vincular.

Para un teléfono, aparece un código QR. Escanéalo con la cámara del teléfono, o copia el enlace y ábrelo en cualquier navegador. Apunta la app Remote a tu servidor y lleva la credencial.
Para un navegador o un escritorio, copia el enlace que se muestra (o el id de dispositivo y la clave de emparejamiento) en el nuevo cliente. El enlace de un solo toque solo se ofrece cuando emparejas desde el cliente web, ya que un binario de escritorio no tiene un origen web desde el que construirlo.

El QR para teléfono y el enlace que cc_server pair --client-url imprime en la CLI son cargas útiles distintas y no son intercambiables: el enlace de la CLI rellena el formulario de conexión del cliente web, mientras que este QR lleva el descriptor de conexión completo del servidor y la huella de identidad para la PWA Remote.

En el lado del teléfono, abrir un enlace de emparejamiento no empareja en silencio. Remote muestra el nombre anunciado del servidor y te pide que confirmes antes de guardar nada, así que un enlace falsificado no puede secuestrar la app para llevarla al servidor de otra persona.

Gestionar dispositivos emparejados

Desde Ajustes → Tú → Tus dispositivos puedes:

Cambiar nombre a un dispositivo
Revocar un dispositivo en el que ya no confías. Revocar destruye su credencial y corta su sesión activa en cuestión de segundos, así que falla en cerrado al reconectarse

Revocar es lo correcto para un teléfono perdido o sustituido. Es inmediato e irreversible desde la perspectiva del dispositivo.

Las credenciales generadas desde este panel tienen un límite de tiempo: caducan 30 días después de emitirse y, a partir de ahí, la barrera de conexión las rechaza (falla en cerrado). Una credencial generada con cc_server pair en la línea de comandos no caduca en absoluto: revócala a mano cuando se retire la máquina para la que era.

Cambiar de espacio de trabajo desde el teléfono

Un teléfono emparejado puede cambiar de espacio de trabajo con independencia del escritorio. El teléfono envía el espacio de trabajo en cada llamada y el servidor comprueba en cada una tu pertenencia y tu rol en ese espacio de trabajo, así que el teléfono solo llega a los espacios de trabajo de los que eres miembro y cambiar allí nunca altera lo que muestra el escritorio.

Además, una sesión de teléfono está restringida a una pequeña lista de permitidos de herramientas con mucha lectura: puede listar y leer tickets, agentes, espacios, mensajes y artículos del feed, y puede actualizar o asignar un ticket, enviar un mensaje en un espacio y marcar un artículo como leído o guardado. Todo lo que quede fuera de ese conjunto se rechaza antes de llegar al despachador del servidor.

Guías relacionadas

Ejecutar un servidor headless: haz que se pueda llegar al servidor, para empezar
Conectar a un servidor remoto: apunta a él un cliente completo
Usar espacios: lo que harás sobre todo desde el teléfono
Crear y gestionar tickets: tria mientras vas de camino