Adopción remota de equipos UniFi por SSH

Modificado el Mié., 14 Oct. a las 9:49 A. M.

Adopción remota de equipos UniFi en el portal de Dattics (Layer 3 por SSH)

Nivel: Intermedio

⚠️ Importante — Servicio sin soporte

El portal UniFi de Dattics es un valor agregado sin costo para nuestros clientes y, por eso, no incluye soporte técnico. Esta guía se ofrece como referencia para que puedas hacer la adopción por tu cuenta.

La adopción Layer 3 consiste en vincular un equipo UniFi (AP, switch, etc.) a un controlador UniFi remoto, en este caso el portal UniFi de Dattics. Se hace conectándote al equipo por SSH e indicándole la dirección del controlador (Inform URL).

1 Verifica los requisitos previos

  • El equipo debe estar en estado de fábrica (LED blanco fijo). Si ya estuvo vinculado a otro controlador, haz un reset de fábrica.
  • Un computador conectado por cable a la misma red del equipo UniFi.
  • La dirección IP que recibió el equipo (puedes consultarla en las asignaciones DHCP de tu router o firewall).
  • La red debe permitir conexión de salida por el puerto TCP 8080 hacia internet.

2 Conéctate al equipo por SSH

En equipos nuevos o reseteados de fábrica, las credenciales son:

  • Usuario: ubnt
  • Contraseña: ubnt

Desde Windows (PowerShell o Símbolo del sistema):

ssh ubnt@192.168.1.20

Desde macOS (aplicación Terminal):

ssh ubnt@192.168.1.20

Reemplaza 192.168.1.20 por la IP de tu equipo. En la primera conexión te preguntará si confías en el equipo: escribe yes y luego ingresa la contraseña.

? ¿Error de «host key» o «REMOTE HOST IDENTIFICATION HAS CHANGED»?
Pasa cuando ya te conectaste antes a otro equipo con la misma IP. Ejecuta ssh-keygen -R 192.168.1.20 (con la IP de tu equipo) y vuelve a intentar. En Windows también puedes usar PuTTY si lo prefieres.

3 Indica al equipo la dirección del portal (Inform URL)

Una vez dentro del equipo, ejecuta este comando:

set-inform http://unifi.dattics.com:8080/inform

? Usa HTTP, NO HTTPS
La dirección debe empezar por http://. Si usas https://, el equipo no se comunicará con el portal y la adopción fallará. Copia el comando exactamente como aparece arriba, incluido el puerto :8080.

4 Adopta el equipo en el portal UniFi

Ingresa al portal UniFi de Dattics. En la lista de dispositivos, el equipo aparecerá como pendiente de adopción. Haz clic en Adopt / Adoptar y espera a que su estado cambie a Online / Conectado.

? ¿Se quedó en «Adoptando»?
Vuelve a conectarte por SSH y ejecuta otra vez el comando set-inform del paso 3.

5 Ten en cuenta el cambio de credenciales

Cuando el equipo queda vinculado, el usuario y la contraseña ubnt/ubnt dejan de funcionar. Las nuevas credenciales SSH del equipo las asigna el portal y se consultan en la plataforma UniFi, en la configuración del sitio.

✅ Si la adopción no funciona, revisa

  • Puerto TCP 8080: tu firewall o router debe permitir que el equipo salga por este puerto hacia internet.
  • HTTP y no HTTPS en el comando set-inform.
  • Estado de fábrica: si el equipo estuvo en otro controlador, haz un reset de fábrica y repite desde el paso 1.
  • Conexión por cable del computador a la misma red del equipo.

¿Le fue útil este artículo?

¡Qué bueno!

Gracias por sus comentarios

¡Sentimos mucho no haber sido de ayuda!

Gracias por sus comentarios

¡Díganos cómo podemos mejorar este artículo!

Seleccione al menos una de las razones
La verificación de CAPTCHA es obligatoria.

Comentarios enviados

Agradecemos su iniciativa, e intentaremos corregir el artículo