ID de nodo o ID de red: cuál se une a una red ZeroTier

Dos identificadores aparecen en toda conversación sobre ZeroTier, y se parecen lo suficiente como para confundirlos en una ventana de chat. El ID de nodo nombra un dispositivo. El ID de red nombra la red virtual a la que ese dispositivo quiere unirse. Unirse requiere el segundo, y autorizar a un miembro requiere el primero.

Dos identificadores, dos tareas

La identidad de nodo se genera cuando el servicio se ejecuta por primera vez en una máquina, y es una dirección hexadecimal de diez caracteres. Permanece con esa instalación hasta que se eliminan los archivos de identidad, por lo que una reinstalación puede producir un miembro nuevo que nadie ha aprobado. Un ID de red son dieciséis caracteres hexadecimales, e identifica una red virtual en lugar de una máquina. El controlador que posee la red es él mismo un nodo, por lo que los primeros diez caracteres del ID de red coinciden con la dirección del controlador.

Ninguno de los dos valores es un secreto y ninguno sustituye al otro. Compartir el ID de red con todos los participantes es normal; compartir un ID de nodo identifica un dispositivo ante el controlador.

Lea cada valor del comando que lo informa

Un comando informa la identidad del servicio local, y otro distinto informa las redes a las que se ha unido. Pedir un valor al comando equivocado es como la gente acaba pegando un ID de red en una lista de miembros.

zerotier-cli info
zerotier-cli status
zerotier-cli listnetworks

El primero imprime la dirección del nodo y si el servicio está en línea. El segundo añade información de versión y puerto. El tercero lista las redes unidas con sus ID, estado y direcciones asignadas, y es el único que debe usarse cuando necesita el ID de red.

Únase con la red, autorice con el nodo

El comando de unión toma el ID de red que proporciona quien administra el controlador. Una respuesta positiva del comando significa que la solicitud se envió, no que se haya concedido la pertenencia en una red privada.

Tras la unión, el administrador autoriza el dispositivo por su ID de nodo en la lista de miembros de esa red. Ya no necesita el ID de red, y no puede autorizar un dispositivo por su nombre de host, porque la identidad es la dirección. Si usted es el administrador, lea la lista de miembros y compare la dirección del nodo con la solicitud. Una solicitud que nombra una red pero no una dirección de nodo no es accionable.

El prefijo compartido tiene una razón

Como un ID de red empieza con la dirección de nodo del controlador, los mismos diez caracteres aparecen en ambos lugares. Es una comodidad de enrutamiento, no una pista de que los dos valores sean intercambiables.

También explica por qué la identidad de un controlador importa más que su nombre mostrado. Restaurar un controlador con una identidad nueva crea un espacio de direcciones distinto, así que las redes definidas con la antigua no son las mismas redes aunque se reutilicen los nombres.

Guarde la identidad del controlador en su copia de seguridad junto con su configuración. Tratar esa identidad como una etiqueta regenerable convierte una restauración en un rediseño.

Verifique el resultado, no la salida del comando

Una unión correcta es el comienzo de la comprobación, no su final. Después mire la entrada de red y lea tres campos: el estado, la dirección asignada y el ID de red.

zerotier-cli listnetworks -j
ip -br addr show | grep zt
ping -c 2 10.147.20.5

El primer comando imprime la misma lista en una forma analizable, lo que facilita compararla con lo que el administrador esperaba. El segundo confirma que la interfaz recibió una dirección, y el tercero prueba un par en la red en lugar del estado local.

Si la entrada dice ACCESS_DENIED, el ID de nodo no está autorizado. Si dice NOT_FOUND, el ID de red es incorrecto. Si dice OK sin dirección, la asignación de direcciones del controlador es la siguiente pregunta, y ninguna de esas tres se responde uniéndose de nuevo.