AuthTokens
En esta página 8 secciones
- Qué es un AuthToken
- Crear un token
- Abre Mis tokens
- Pon nombre al dispositivo
- Copia el token en la aplicación
- Elige el dispositivo en Mis túneles
- La lista de tokens
- Historial de IP
- Configuración del token
- Eliminar un token
- Conectar un dispositivo Android con un código QR o un PIN
- Abre Conectar dispositivo
- Escanea el código o introduce el PIN
- Grupos de tokens
- Crear un grupo
- Elige sus tokens
- Dónde se usan los tokens
- Solución de problemas
- Páginas relacionadas
Un AuthToken conecta la aplicación Localtonet de un dispositivo con tu cuenta. Crea un token para cada dispositivo en Mis tokens, inicia sesión en el dispositivo con él y luego elige ese token cuando crees un túnel.
Qué es un AuthToken #
La aplicación Localtonet inicia sesión con un AuthToken en lugar de tu correo y tu contraseña. En el panel, el token representa al dispositivo que lo usa: un túnel se crea para un token y funciona mientras la aplicación que usa ese token está conectada.
- Da a cada dispositivo su propio token. Una conexión nueva que use el mismo token sustituye a la anterior.
- El nombre de un token es solo una etiqueta. El token en sí lo genera Localtonet.
- Un AuthToken inicia sesión en un dispositivo. No protege un túnel frente a los visitantes. Para eso, consulta Control de acceso.
Mantén tus tokens en privado. Cualquiera que tenga el token puede usarlo para iniciar sesión en la aplicación. Lo mismo vale para el código QR y el PIN de un token.
Crear un token #
-
Abre Mis tokens #
Abre Mis tokens y despliega Crear token.
-
Pon nombre al dispositivo #
Escribe un nombre reconocible en Nombre del token, por ejemplo
Office-PC, y selecciona Crear token.Regla Detalle Obligatorio Un nombre vacío muestra ¡El nombre es obligatorio! Longitud Como máximo 30 caracteres. Espacios No se permiten. El campo no acepta espacios, y los espacios de un nombre pegado se eliminan. Único Dos de tus tokens no pueden tener el mismo nombre. -
Copia el token en la aplicación #
El nuevo token aparece en Tus tokens. Selecciónalo para copiar el token completo y luego inicia la aplicación Localtonet con él:
Terminallocaltonet --authtoken <YOUR_TOKEN>En Android, usa en su lugar el código QR o el PIN. Consulta Conectar un dispositivo Android más abajo.
-
Elige el dispositivo en Mis túneles #
Cuando crees un túnel, selecciona este token en Token del dispositivo. La Guía de inicio rápido muestra todo el flujo.
La lista de tokens #
Tus tokens lista todos los tokens de la cuenta en la que trabajas. Usa Buscar tokens para filtrar por nombre o token, y Actualizar para recargar la lista. En una pantalla estrecha, algunas columnas pasan al botón Detalles de cada fila.
| Columna | Qué muestra | Qué puedes hacer |
|---|---|---|
| Nombre | El nombre que diste al token. | Selecciona el nombre para renombrar el token. Se aplican las reglas de un nombre nuevo. |
| Estado | En línea significa que la aplicación Localtonet está conectada. Sin conexión significa que el dispositivo está desconectado, aunque sus túneles sigan configurados. | |
| Token | El token, con la parte central oculta. | Selecciónalo para copiar el token completo. El botón QR abre Conectar dispositivo. |
| Túneles | Túneles activos / túneles totales vinculados a este token. Un dispositivo en línea no tiene necesariamente un túnel activo. | |
| Cliente | La última versión de la aplicación notificada y su estado de actualización. | Una insignia Requiere actualización enlaza con la página de descargas, para que puedas instalar la última aplicación Localtonet. Conecta el dispositivo para actualizar esta información. |
| Dispositivo | Uso de hilos, nivel de batería y temperatura de la batería, según lo último que notificó el dispositivo. | Para dispositivos Android: Configuración del dispositivo Android, Configuración de SMS cuando es compatible y Registros de acciones del dispositivo. Gestor de proxies ofrece los mismos controles para toda una flota. |
| Acciones | Historial de IP, Configuración del token, Eliminar token. |
Historial de IP #
Historial de IP abre la lista de direcciones IP públicas registradas para el token, cada una con su fecha. Sobre la lista verás cuatro contadores: Total repetidas, Total de IP repetidas, IP repetidas en la última hora y Total de IP en la última hora. Selecciona Actualizar para refrescarlos. Es especialmente útil para un dispositivo cuya IP cambia, como un teléfono que rota su IP móvil.
Configuración del token #
Configuración del token abre un panel con el token completo, un botón Copiar token, el botón QR / PIN y dos ajustes:
| Ajuste | Qué hace | Valores |
|---|---|---|
| Modo de dispositivo USB | Usa este modo cuando el token conecte un dispositivo USB. Gestionas sus dispositivos desde Mis dispositivos USB. | Sí o No. El cambio pide confirmación. |
| Argumentos del cliente | Guarda opciones del cliente junto con el token. Selecciona Gestionar, activa Activo y rellena Argumentos. El cliente de Localtonet no aplica los argumentos guardados aquí; aplica los Argumentos definidos en un túnel. Para elegir una interfaz de red o una dirección IP local, defínelas en cada túnel. | Con Activo activado, el campo no puede estar vacío. Consulta Selección de red. |
Eliminar un token #
Selecciona Eliminar token y confirma. El panel te avisa antes:
Los túneles con este token se detendrán y se eliminarán. Un dispositivo que todavía use el token ya no podrá conectarse con él. Crea un token nuevo para ese dispositivo si lo necesitas de nuevo.
Conectar un dispositivo Android con un código QR o un PIN #
No tienes que escribir un token en un teléfono. Cada token tiene un código QR y un PIN corto.
-
Abre Conectar dispositivo #
En Mis tokens, selecciona el botón QR junto al token. Se abre el cuadro de diálogo Conectar dispositivo.
-
Escanea el código o introduce el PIN #
Abre Localtonet para Android. Escanea el código en Escanear código QR, o escribe el PIN de seis dígitos que aparece en Introducir un PIN en el campo de inicio de sesión de la aplicación y selecciona Connect.
- El PIN es válido durante un minuto. El cuadro de diálogo cuenta hacia atrás y después muestra El PIN caducó. Genera un nuevo PIN para continuar.
- Un PIN funciona una sola vez. Selecciona Generar nuevo PIN para otro dispositivo o para otro intento.
- El código QR no caduca. Contiene el propio token, así que trata una foto de él como al token.
- También puedes pegar el token en la aplicación. El cuadro de diálogo lo muestra con un botón de copiar.
Grupos de tokens #
Un grupo de tokens contiene tokens de dispositivos. Los grupos organizan los dispositivos en conjuntos: un Proxy rotativo usa los dispositivos de los grupos que selecciones, y un webhook de token se crea para un grupo.
-
Crear un grupo #
En Mis tokens, despliega Grupos de tokens, escribe un Nombre del grupo y selecciona Crear grupo. El nombre puede tener como máximo 30 caracteres, no lleva espacios y debe ser único entre tus grupos.
-
Elige sus tokens #
Se abre el cuadro de diálogo Gestionar grupo de tokens con una lista de todos tus tokens. Marca los tokens de dispositivo que pertenecen al grupo y selecciona Guardar cambios.
Para cambiar un grupo más adelante, selecciona Gestionar en su fila. El cuadro de diálogo está pensado para listas largas:
- Busca por nombre. Separa varios nombres con comas.
- Filtra por estado del dispositivo: Cualquier estado, En línea o Sin conexión.
- Cambia entre Todos, En el grupo y Fuera del grupo.
- Usa Seleccionar todos para marcar todos los tokens mostrados y luego desmarca los que quieras dejar fuera. Con Mayús+clic seleccionas un rango.
- El pie muestra lo que va a cambiar, por ejemplo +3 por añadir. Restablecer descarta tus cambios.
Cuando quitas tokens de un grupo, el cuadro de diálogo te pide confirmar, porque los proxies rotativos que usan el grupo se detienen en esos dispositivos. Un solo guardado puede cambiar hasta 5000 tokens.
Eliminar grupo elimina el grupo y sus pertenencias. Los tokens en sí se conservan.
Dónde se usan los tokens #
| Lugar | Cómo se usa el token |
|---|---|
| Formularios de creación de túneles | Token del dispositivo selecciona el dispositivo que sirve el túnel. Para mover un túnel existente a otro dispositivo, usa Cambiar AuthToken en el túnel: un túnel en ejecución se detiene, espera 2 segundos y se reinicia con el token seleccionado. |
| Proxy rotativo | Usa grupos de tokens en lugar de un solo token. Cada dispositivo conectado de un grupo seleccionado se convierte en una salida del endpoint compartido. |
| Webhooks | Un webhook de token se configura para un Grupo de AuthToken. |
| Gestor de VPN | Cuando añades un dispositivo a una red, seleccionas el token que se usa para iniciar sesión en Localtonet en ese dispositivo. Cada dispositivo necesita su propio token. |
| Terminal de dispositivos | El token vincula un equipo a tu cuenta en Mis dispositivos. |
| Dispositivos USB | Un token en Modo de dispositivo USB conecta el equipo al que están enchufados los módems o teléfonos USB. |
| Gestor de proxies | Cada teléfono Android inicia sesión con su propio token. |
También puedes listar, crear y eliminar tokens y grupos de tokens con la API y el servidor MCP.
Mientras hay un equipo seleccionado en el panel, Mis tokens muestra y crea los tokens de ese equipo. Consulta Gestión de equipos.
Solución de problemas #
Ya existe un token llamado …
Los nombres de token son únicos. Elige otro nombre, o cambia primero el nombre del token existente.
El nombre no puede tener más de 30 caracteres
Acorta el nombre del token o del grupo a 30 caracteres o menos.
El token aparece como Sin conexión
El dispositivo está desconectado. Abre la aplicación Localtonet en el dispositivo para conectarlo. Si se inició otro dispositivo con el mismo token, ese sustituyó esta conexión: crea un token distinto para cada dispositivo.
El cliente dice Wrong Token!
El valor no es un token completo. Copia de nuevo el token completo desde Mis tokens: la lista oculta la parte central, así que usa el botón de copiar en lugar de seleccionar el texto visible.
El PIN caducó
El PIN es válido durante un minuto y funciona una sola vez. Selecciona Generar nuevo PIN, o escanea el código QR en su lugar.
No se pudo cargar el código QR y el PIN
Selecciona Reintentar en el cuadro de diálogo. Si sigue fallando, copia el token y pégalo en la aplicación.