Documentos de la guía
Qué puedes hacer desde el teléfono
Con el teléfono enlazado al PC, aunque no estés delante de él, puedes:
- Ver los proyectos y las sesiones del PC conectado
- Ver la terminal de la app y escribir en ella
- Leer conversaciones de Switcher, enviar mensajes y responder a solicitudes de aprobación
- Abrir sesiones nuevas, retomar sesiones anteriores, y renombrar o archivar sesiones
- Cambiar la herramienta, la conexión y el modelo de cada proyecto
- Consultar las estadísticas de uso de varios PC
Lo único que solo se puede hacer en el PC es crear cuentas nuevas en una herramienta e iniciar sesión con ellas.
Qué app usar
| App | Estado | Dónde conseguirla |
|---|---|---|
| App web (PWA) | Disponible | https://app.switchboard.twentyoz.kr |
| App de Android | Disponible (APK) | Pestaña Android de la página de descargas |
| App de iPhone | En preparación | Mientras tanto, usa la app web |
App web
Abre https://app.switchboard.twentyoz.kr en el navegador del teléfono y úsala directamente, sin instalar nada. Con Añadir a pantalla de inicio, en el menú del navegador, la tendrás en la pantalla de inicio como cualquier otra app.
App de Android
- En la página de descargas, elige la pestaña Android y descarga
Agent-Switchboard-Android-<versión>.apk. - Abre el archivo y instálalo. Si el navegador o el gestor de archivos te pide permiso para instalar, concédelo.
Si antes instalaste un APK con otra firma, el nuevo no se podrá instalar encima. En ese caso, desinstala la app anterior, instala el APK nuevo y vuelve a enlazar el PC e iniciar sesión con Google.
Activar la conexión con el teléfono en el PC
La conexión con el teléfono viene desactivada.
- En el PC, abre 환경 설정 › 휴대폰 (Preferencias › Teléfono).
- Activa 휴대폰 연결 켜기 (Activar la conexión con el teléfono).
Aunque la actives, el PC no abre ningún puerto: solo establece conexiones salientes hacia el servidor de retransmisión. Si el PC no puede usar el almacén seguro del sistema operativo, no podrás activarla.
Opción 1: código QR
No necesitas cuenta de Google.
- En el PC, ve a Preferencias › Teléfono › 새 휴대폰 연결 (Conectar un teléfono nuevo) y pulsa 연결 QR 만들기 (Crear QR de conexión). El QR solo se puede crear cuando el PC ya está conectado al servidor de retransmisión.
- En la app del teléfono, ve a PC 연결 (Conectar PC), pulsa QR 코드 스캔 (Escanear código QR) y escanea el QR de la pantalla del PC. Si no puedes usar la cámara, pulsa 주소 복사 (Copiar dirección) en el PC y usa 연결 링크 붙여넣기 (Pegar enlace de conexión) en el teléfono.
- El teléfono muestra un número de 6 dígitos. Comprueba que coincide con el de la ventana de aprobación del PC y apruébalo.
Cada QR vale para un solo uso durante 5 minutos. Si ha caducado o ya se usó, crea otro.
Opción 2: cuenta de Google
Si inicias sesión con la misma cuenta de Google en el PC y en el teléfono, se enlazan sin QR.
- En el PC, inicia sesión con Google desde el menú de cuenta de la esquina inferior izquierda o desde 내 컴퓨터 (Mis equipos) en el rail. El estado también aparece en Preferencias › Teléfono, en Google 계정 · PC 목록 동기화 (Cuenta de Google · sincronización de la lista de PC).
- En la app del teléfono, inicia sesión con la misma cuenta de Google.
- El teléfono muestra los PC de esa cuenta, incluidos los que están apagados. Pulsa el que quieras y se conectará sin QR.
Decidir qué se acepta sin aprobación
Se configura en Preferencias › Teléfono › 대시보드·세션 접근 권한 (Permisos de acceso al panel y a las sesiones).
- 같은 계정 휴대폰·웹 자동 허용 (Aceptar automáticamente teléfonos y web de la misma cuenta): si está activado, un teléfono nuevo autenticado con la misma cuenta de Google se conecta sin confirmar el número. Si está desactivado, tendrás que aprobar en el PC la primera conexión.
- 같은 계정 다른 PC 자동 허용 (Aceptar automáticamente otros PC de la misma cuenta): decide si se salta la ventana de aprobación cuando otro PC de tu cuenta abre este desde Mis equipos en el rail. Ese PC podrá escribir en la terminal de este, así que actívalo solo si todos los PC los administras tú.
Aunque la aceptación automática esté activada, en estos casos tendrás que confirmar el número en la ventana de aprobación del PC:
- Cuando vuelve a entrar un dispositivo al que desconectaste o cerraste la sesión desde este PC
- Cuando se intentan registrar automáticamente más de 3 dispositivos distintos en menos de 1 hora
Cada vez que entra un dispositivo nuevo con tu cuenta, el PC te avisa con una notificación y lo anota en el registro de actividad.
Quien autoriza la conexión es el PC
El servidor de cuentas solo guarda la lista de PC; no autoriza conexiones. La prueba de inicio de sesión de Google que envía el teléfono la verifica el propio PC. Así, aunque alguien manipulara la lista del servidor de cuentas, no obtendría acceso a la terminal del PC.
Notificaciones
La app de Android puede avisarte de aprobaciones pendientes, tareas terminadas y errores. Activa las notificaciones en la app del teléfono y, después, en Preferencias › Teléfono › 연결한 휴대폰 (Teléfonos conectados) del PC, activa o desactiva 작업 완료 알림 (Aviso de tarea terminada) para cada dispositivo. Los avisos de solicitudes de aprobación, de dispositivos nuevos y de errores se envían siempre, con independencia de este ajuste.
El PC cifra cada notificación con una clave propia del dispositivo, generada por el teléfono. El servidor de retransmisión y los servicios push de Apple y Google solo ven el token push y el texto cifrado. Si el teléfono no consigue descifrar una notificación, muestra un texto fijo: "Hay algo que revisar". Los dispositivos que tienen la app abierta y conectada no reciben notificaciones.
Qué ve el servidor de retransmisión
Todo lo que se intercambian el teléfono y el PC va cifrado de extremo a extremo; el servidor de retransmisión solo pasa texto cifrado.
Lo que el servidor no puede ver
- Lo que escribes en la terminal y lo que esta muestra
- El contenido de las conversaciones de Switcher
- El secreto de emparejamiento y las claves de sesión
- Las claves de API y los tokens OAuth
- Tu dirección de correo y tu token de Google (los recibe para verificar el inicio de sesión, pero no los guarda)
Lo que el servidor sí maneja
- La dirección IP de conexión (para evitar abusos y en los registros de acceso)
- El identificador de sala del PC (derivado de su clave pública), y el tamaño y la hora de los datos cifrados
- Si usas una cuenta de Google: el identificador de la cuenta; la clave pública, el nombre y la última conexión de cada PC; el id, el nombre y la plataforma de cada teléfono; y el hash de sesión
- Si activas la sincronización de uso: los paquetes cifrados de uso mensual
Cómo funciona el cifrado
- El secreto de un solo uso del QR va en el fragmento de la dirección, así que nunca llega al servidor.
- En cada conexión, ambos extremos generan una clave de sesión nueva. Si el servidor de retransmisión intentara interponerse, las claves no coincidirían y la conexión fallaría.
- El servidor de retransmisión no guarda ni acumula mensajes.
Para más detalles sobre el tratamiento de datos, consulta la Política de privacidad.
Gestionar los dispositivos conectados
En Preferencias › Teléfono › Teléfonos conectados puedes hacer lo siguiente con cada dispositivo:
- 이름 바꾸기 (Renombrar): el nombre cambia solo en la lista de este PC.
- 연결 끊기 (Desconectar): se desconecta solo de este PC. Para volver, tendrá que enlazarse con un QR nuevo o pasar por la ventana de aprobación de este PC.
- 로그아웃 (Cerrar sesión; para dispositivos que entraron con cuenta de Google): el teléfono cierra la sesión de la cuenta y se desconecta de todos los PC de esa cuenta.
- 모두 끊기 (Desconectar todos): desconecta todos los teléfonos enlazados a este PC.
Si generas una identidad de escritorio nueva, se desconectan todos los teléfonos y cambia la huella del escritorio. También se cierra la sesión de la cuenta de Google.
Uso combinado de varios PC
Si activas 여러 PC 사용량 합쳐 보기 (Ver el uso combinado de varios PC) en Preferencias › Teléfono, el número de tokens por fecha, herramienta, modelo y proyecto se guarda en el servidor de cuentas cifrado con una clave que solo conocen los dispositivos de tu cuenta. El contenido de las conversaciones no se sube. El total lo ves en las estadísticas del teléfono y en 모든 PC (Todos los PC), dentro del resumen del PC.
Los registros guardados se conservan hasta que los borres. Para hacerlo, pulsa 서버에서 이 PC 기록 지우기 (Borrar del servidor los registros de este PC) o 계정 사용량 기록 모두 지우기 (Borrar todos los registros de uso de la cuenta).
Tu propio servidor de retransmisión
De entrada se usan el servidor de retransmisión oficial y la dirección oficial de la app del teléfono. En Preferencias › Teléfono › 주소 (Direcciones) puedes cambiarlos por tu propio servidor de retransmisión (dirección wss://) y tu propia app para el teléfono (dirección https://). Si dejas el campo vacío y guardas, vuelves a la dirección oficial. En la dirección de la app pon solo sitios de confianza: la app que se sirva desde ahí podrá escribir en la terminal de este PC.
Si no consigues conectar, consulta Solución de problemas.