Activar un Fing Agent con un código o un enlace

Un Fing Agent instalado como snap, en Docker o en una Raspberry Pi se puede activar escribiendo un breve código de activación en setup.fing.com, sin analizar la red desde la aplicación móvil de Fing. El agente muestra el código en su página de estado local y mediante un comando de terminal; debes introducirlo en el navegador con la sesión iniciada en tu cuenta de Fing, elegir un destino y confirmar.

Qué es la activación con un código

Lo que debes saber sobre el código:

• Tiene ocho caracteres y se muestra como XXXX-XXXX, por ejemplo KDPM-W7XG. El guion es opcional al escribirlo o pegarlo, se admiten mayúsculas y minúsculas, y el código nunca contiene caracteres fáciles de confundir, como 0 y O o 1 e I.
• Es válido durante 10 minutos. Un código caducado deja de funcionar y el agente obtiene uno nuevo la próxima vez que abres la página o ejecutas el comando.
• Solo se puede usar una vez. Después de una activación correcta, queda consumido.
• Solo funciona desde una cuenta de Fing con la sesión iniciada, y la activación nunca se produce sin tu confirmación explícita en el sitio web.

Este artículo explica el flujo estándar, dónde encontrar el código en cada tipo de instalación, qué hacer cuando falla la activación, cómo utilizar códigos para sitios remotos y cómo desactivar un agente desde la interfaz web. El flujo clásico, que consiste en analizar la red con la aplicación móvil de Fing, sigue funcionando junto con el flujo mediante código.

Flujo estándar: abre fingagent.local y sigue el enlace

La forma más rápida requiere un navegador en la misma red que el agente. Desde que se enciende hasta que el agente está en funcionamiento, se tarda aproximadamente un minuto.

En el dispositivo

1. Enciende el dispositivo o inicia el agente y espera un momento a que se conecte a Fing. El agente solo solicita un código cuando alguien lo pide, por lo que no se muestra nada hasta que abras su página o ejecutes el comando descrito en las secciones siguientes.
2. En un ordenador, tableta o teléfono conectado a la misma red, abre http://fingagent.local/ en un navegador. Escribe http:// explícitamente: la página se sirve mediante HTTP sin cifrar, y Chrome y Edge podrían intentar utilizar https:// y fallar con un error de conexión. Safari la abre directamente.
3. La página de estado del agente muestra el nombre del agente, su número de serie, la versión y la plataforma, el código actual en un tamaño grande, el tiempo restante antes de que se sustituya por un código nuevo y un botón Activar ahora. La página se actualiza automáticamente cada diez segundos; no tienes que volver a cargarla. La primera carga puede tardar unos segundos mientras el agente obtiene un código.

En el navegador

1. Haz clic en Activar ahora. El navegador abre setup.fing.com con el código ya cumplimentado. Si no has iniciado sesión, inicia sesión o crea primero una cuenta de Fing. El código se conserva durante el inicio de sesión.
2. En la página Activar un Fing Agent, comprueba la vista previa del dispositivo: tipo de agente, plataforma, versión y número de serie parcial. En Activar agente en, elige el destino. Tu espacio de trabajo personal aparece seleccionado de forma predeterminada. Cada entrada muestra tu función y cuántos espacios de agente están en uso.
3. Haz clic en Activar agente, revisa el cuadro de diálogo Confirmar activación y haz clic en Confirmar y activar. El sitio web espera a que el dispositivo confirme la recepción, lo que suele tardar unos segundos.
4. En Agente activado, haz clic en Abrir aplicación web para ver el agente y su red. El propietario del espacio de trabajo recibe un correo electrónico de confirmación.

En unos diez segundos desde tu confirmación, la página de estado cambia a «Agente activado. Este agente está activo y analizando esta red». El agente sigue respondiendo a fingagent.local mientras está en ejecución, esté activado o no, por lo que el nombre sigue dirigiendo a este dispositivo.

Si fingagent.local no se abre

Instalación mediante snap: dónde aparecen el código y el enlace

En una instalación mediante snap (Ubuntu, Ubuntu Core o Raspberry Pi OS con snapd), el agente se ejecuta como el snap fing-agent. El código está disponible en tres lugares. Todos son de solo lectura: muestran cómo activar el agente, pero nunca lo activan por sí mismos.

fing-agent.activate

Fing Agent  (serial FNG-2417-4K7C | v6.2.1 | snap)
  STATUS: not activated yet. To activate this agent:
    1. open   https://setup.fing.com
    2. enter  KDPM-W7XG
    or open pre-filled:  https://setup.fing.com/?code=KDPM-W7XG
    (code expires in ~9m 47s)

sudo snap logs fing-agent

Instalación mediante Docker: dónde aparecen el código y el enlace

En Docker, el agente se ejecuta dentro del contenedor, al igual que la página de estado. La instalación oficial, tanto si se realiza mediante el archivo compose como mediante el comando manual docker run, asigna al contenedor el nombre FingAgent y lo ejecuta en modo de red del host. Los comandos siguientes dan por hecho esta configuración. Si has asignado otro nombre al contenedor, utiliza ese nombre.

docker exec FingAgent fing-agent.activate

docker logs FingAgent | grep -E 'Local address|Attached'

Solución de problemas de activación

La mayoría de los problemas pertenecen a uno de estos tres grupos: el código ya no es válido, el plan no tiene espacio para otro agente o no se puede acceder al propio agente. El mensaje del sitio web indica cuál es tu caso.

El código ha caducado o no se acepta

«Este código no es válido» aparece justo después de introducir el código. El sitio web muestra el mismo mensaje tanto si el código se ha escrito mal como si ha caducado o ya se ha utilizado, de modo que un desconocido no puede comprobar qué códigos existen. Los códigos caducan 10 minutos después de emitirse, por lo que un código copiado de una captura de pantalla o de un mensaje recibido hace un rato normalmente ya no será válido.

1. Vuelve al dispositivo: la página de estado o el comando fing-agent.activate siempre muestran el código actual.
2. Introduce el código nuevo. Si has llegado desde un enlace cumplimentado, sustituye el código en la página en lugar de volver a abrir el enlace antiguo.

«La activación no se ha completado. Este código ya no es válido» aparece después de hacer clic en Confirmar y activar. El código todavía era válido cuando la página lo comprobó, pero caducó antes de que confirmaras. Esto suele ocurrir cuando el registro, el cambio de espacio de trabajo o la compra de un plan tarda más de 10 minutos. Haz clic en Introducir un código nuevo y utiliza el código que muestra ahora el dispositivo.

«Demasiados intentos» significa que varios códigos han fallado seguidos desde tu cuenta. Espera unos minutos, lee el código actual del dispositivo y vuelve a intentarlo una sola vez.

Tu plan no tiene espacios de agente libres

Los espacios de agente pertenecen al propietario del espacio de trabajo de destino y se comparten entre todos los espacios de trabajo que tiene ese propietario. La página comprueba los espacios en cuanto reconoce el código y de nuevo cada vez que cambias el destino, por lo que ves el problema antes de confirmar, no después.

Cuando la solución es realizar una compra, Ver planes sustituye al botón Activar agente y lleva consigo tu código. Cuando terminas en la página de planes, un botón Completar activación del agente te devuelve con el código ya cumplimentado. Las compras suelen tardar más que los 10 minutos de validez del código, por lo que si después ves «Este código no es válido», lee el código nuevo del dispositivo y continúa. La compra no se verá afectada.

Si aparece el mensaje «Se alcanzó el límite de agentes antes de que se completara esta activación» después de confirmar, otra persona utilizó el último espacio mientras confirmabas. Revisa las opciones de planes y vuelve a intentarlo.

El agente está desconectado o no se puede acceder a él

La activación la completa el propio agente: Fing envía la activación al dispositivo a través de su conexión activa y espera una confirmación. Si el dispositivo no está conectado, la activación no puede finalizar.

«El dispositivo está desconectado» aparece debajo de la vista previa del dispositivo antes de confirmar. El agente no ha informado a Fing durante un tiempo. Comprueba que el dispositivo tenga alimentación y acceso a la red, y que nada bloquee el puerto TCP saliente 4443. Cuando vuelva a conectarse, mostrará un código nuevo; lo más probable es que el que tienes ya haya caducado.

«Algo ha salido mal por nuestra parte» aparece después de confirmar. El envío al dispositivo ha fallado por un motivo temporal, normalmente porque el agente se estaba reconectando en ese momento, por ejemplo justo después de reiniciarse o desactivarse. Tu código sigue siendo válido. Espera un momento y haz clic en Volver a intentarlo. Si continúa fallando, ejecuta fing-agent.activate en el dispositivo: una línea «WARNING: not connected to the backend» significa que el agente no puede conectarse a Fing.

La página de estado del dispositivo indica «Agente activado», pero tú no lo has activado. Otra persona introdujo primero el código o el agente ya se había activado anteriormente en otra cuenta. El código se ha consumido y el agente ahora pertenece a esa cuenta. Para moverlo, el propietario actual debe desactivarlo desde la interfaz web (consulta la última sección). El agente mostrará entonces un código nuevo la próxima vez que se abra su página o se ejecute su comando.

El dispositivo no muestra ningún código. El agente no tiene conexión con Fing, por lo que no se puede emitir ningún código; la página de estado muestra un campo de código vacío. En este estado, el comando muestra «no code available right now (agent not connected?)». Soluciona primero la conexión.

Activar agentes en redes remotas

El código separa dos funciones que el flujo de análisis móvil obliga a desempeñar a una sola persona: alguien con acceso físico o remoto al dispositivo lee el código y el titular de la cuenta lo canjea desde cualquier lugar. Esto hace que el flujo sea útil para sitios gestionados y dispositivos sin interfaz, que no tienen pantalla ni teclado propios.

Envía una Raspberry Pi preconfigurada y pide a alguien del sitio que comparta el código

1. Prepara la Raspberry Pi con la imagen de Fing Agent o instala el snap fing-agent antes de enviarla. No la actives. Un dispositivo que se haya activado para realizar pruebas debe desactivarse primero; de lo contrario, se enviará vinculado a tu espacio de trabajo de prueba.
2. Envía el dispositivo. Pide a la persona del sitio que lo conecte a la red con un cable Ethernet y lo encienda.
3. Pídele que abra http://fingagent.local/ en un portátil o teléfono conectado a la misma red y que te envíe el código que aparece en la página o el enlace asociado a Activar ahora. También sirve una foto de la página. Recuérdale que el código es válido durante 10 minutos, por lo que debe enviarlo en cuanto aparezca, y tú debes estar preparado para utilizarlo.
4. En tu propio navegador, con la sesión iniciada en tu cuenta de Fing, abre setup.fing.com, introduce el código o abre el enlace, elige el espacio de trabajo del cliente como destino y confirma.
5. Dile a la persona del sitio que la página ahora muestra «Agente activado». No tiene que hacer nada más.

Hay dos aspectos que debes tener en cuenta. Si el sitio no puede abrir fingagent.local, por ejemplo porque el portátil está conectado a una red Wi-Fi de invitados o porque la persona utiliza Android, pídele que analice la red con la aplicación de Fing, que mostrará el agente y podrá activarlo directamente. Además, si ya hay un Fing Agent en ejecución en esa red, esté activado o no, el nuevo dispositivo responderá a fingagent-2.local y después a fingagent-3.local para el siguiente, porque cada agente conserva su nombre mientras está en ejecución. Pide a la persona del sitio que pruebe con el número siguiente.

Si gestionas muchos sitios, el documento JSON de http://<device-ip>/activation permite que un script recopile códigos de un lote de dispositivos recién instalados; aun así, un usuario con la sesión iniciada debe introducir el código en setup.fing.com.

Utiliza SSH o Escritorio remoto para leer el código y actívalo desde tu propia cuenta

Si ya administras la máquina que ejecuta el agente, no necesitas que haya nadie en el sitio.

En ambos casos, el agente termina en el espacio de trabajo que has elegido, contigo o con tu organización como propietario, y el propietario del espacio de trabajo recibe el correo electrónico de confirmación. La máquina remota nunca contiene tus credenciales de Fing.

Desactivar un agente desde la interfaz web

La desactivación libera el agente de tu cuenta y libera su espacio. El software permanece instalado en el dispositivo, que se puede volver a activar con un código nuevo, por ti o por otra persona. Utilízala cuando retires un sitio, traslades un agente a otro espacio de trabajo o cliente, o quieras volver a enviar un dispositivo utilizado para realizar pruebas.

1. Inicia sesión en la aplicación web de Fing y abre Cuenta y, después, Fuentes. Cada fuente de monitorización tiene su propia fila.
2. En la fila del agente, abre el menú … y elige Desactivar.
3. Lee el cuadro de diálogo ¿Desactivar fuente de monitorización?. Advierte de que los ajustes personalizados asociados a esta fuente, como los dispositivos bloqueados automáticamente, el tiempo de inactividad programado, las pruebas de velocidad y otras configuraciones de monitorización, podrían eliminarse, y que el dispositivo permanece instalado y se puede volver a activar más adelante con un código de activación nuevo.
4. Haz clic en Desactivar. Aparece una confirmación cuando se ha desactivado la fuente y el propietario de la cuenta recibe un correo electrónico.

Qué ocurre en el dispositivo:

• Fing interrumpe la conexión del agente y este se vuelve a conectar automáticamente. Su registro muestra una línea DEACTIVATED.
• El agente no obtiene un código nuevo por sí mismo. La próxima vez que alguien abra su página de estado o ejecute fing-agent.activate, solicitará uno y lo mostrará. Si la página de estado se había dejado abierta en la vista «Agente activado», vuelve a cargarla: esa vista solo se actualiza una vez cada hora.
• El agente sigue respondiendo al mismo nombre fingagent.local que reclamó al iniciarse.
• El análisis se detiene hasta que el agente vuelva a activarse. El historial de red asociado a la fuente desactivada no se transfiere a la nueva activación.