Sincronización con Netbox¶

Netbox describe su infraestructura física y virtual: equipos, máquinas virtuales, racks, sitios, direcciones. KANAP lee ese inventario y mantiene sus propios activos alineados con él.

El reparto de responsabilidades es deliberado. Netbox sigue siendo la referencia para los equipos que describe, así que el nombre, el número de serie, la posición en el rack o la dirección principal vienen siempre de ahí. KANAP conserva la capa de negocio alrededor de cada activo: entorno, aplicaciones, contratos y costes, soporte, fechas, relaciones, notas. Deja de reescribir el inventario y conserva todo lo que Netbox no conoce.

Dónde encontrarlo¶

Espacio de trabajo: Panorama IT
Ruta: Panorama IT > Netbox
Ruta: /it/netbox
Configuración de la conexión: Administración > Integraciones
Permiso: infrastructure:admin, tanto para la tarjeta de conexión como para la página de sincronización
Disponible en la nube y en la edición on-premise. No hay ningún indicador de funcionalidad que activar.

Antes de empezar¶

Una instancia de Netbox accesible para KANAP. KANAP llama a Netbox desde el servidor, no desde su navegador. La dirección que introduzca tiene que resolverse y responder desde donde se ejecuta KANAP. En la edición en la nube, esa dirección debe ser pública: una dirección privada o interna se rechaza al guardar la conexión, y de nuevo antes de cada llamada. En la edición on-premise, una dirección de su propia red es exactamente lo que se espera.

Un token de API con acceso de lectura. En Netbox, abra el menú de usuario arriba a la derecha, luego API tokens, y cree uno. Basta con un token de solo lectura: KANAP nunca escribe nada en Netbox. Póngale una descripción para reconocerlo más tarde, y rótelo como haría con cualquier otra credencial de servicio.

Una decisión sobre el certificado. Si su Netbox usa un certificado en el que KANAP no confía, normalmente un certificado autofirmado o interno, puede activar Ignorar los errores de certificado. La conexión sigue cifrada, pero el certificado deja de comprobarse, así que úselo solo con un certificado que conozca y en el que confíe, en una red que controle. En un Netbox público, instale un certificado de confianza en su lugar.

Conectar KANAP con Netbox¶

Vaya a Administración > Integraciones y abra la tarjeta Inventario de Netbox.

Campo	Qué introducir
Activar la sincronización con Netbox	El conmutador maestro. Cuando está desactivado, KANAP no llama nunca a Netbox, ni a mano ni de forma programada.
Dirección de Netbox	La dirección que usa para abrir Netbox en el navegador, por ejemplo `https://netbox.example.com`.
Token de API	El token que creó en Netbox. Se guarda cifrado y no se vuelve a mostrar. Deje el campo vacío al guardar para conservar el token ya almacenado.
Tiempo de espera (segundos)	Cuánto esperar a Netbox antes de abandonar, entre 5 y 120. Déjelo vacío para usar 30.
Ignorar los errores de certificado	Desactivado de forma predeterminada. Véase más arriba.
Sincronización automática	Se ejecuta cada hora y aplica los cambios por su cuenta. Déjela desactivada hasta que la primera ejecución le parezca correcta.
Entorno de los nuevos activos	Se aplica a los activos que crea esta integración. Después no se cambia nunca.

Probar conexión hace una llamada de solo lectura e indica la versión de Netbox encontrada, o el motivo del fallo. Ejecútela después de cada cambio de dirección o de token. Una vez guardada la configuración, la tarjeta ofrece un enlace Configurar la sincronización, que lleva a Panorama IT > Netbox.

Elegir qué se importa¶

Abra la pestaña Correspondencias en la página de Netbox. Ahí hay tres tablas. Las dos primeras deciden todo el alcance de la importación.

Rol de Netbox > Tipo de activo KANAP. Cada rol de equipo que Netbox conoce recibe un tipo de activo, o No importar.
Sitio de Netbox > Ubicación KANAP. Cada sitio de Netbox recibe una de sus ubicaciones, o No importar.

Todo lo que quede en No importar se omite: sus objetos no se crean nunca, no se actualizan nunca y no se señalan nunca como ausentes. Así deja fuera de KANAP las regletas, los paneles de parcheo o un sitio de laboratorio, mientras importa los servidores que están al lado.

Una fila adicional acompaña a los roles: Máquinas virtuales. Todas las máquinas virtuales que contiene Netbox pasan por esa única fila, sea cual sea el rol que Netbox les dé, así que una sola decisión cubre el conjunto. Una máquina virtual toma el sitio de su clúster cuando no lleva uno propio.

Cada fila muestra cuántos equipos y máquinas virtuales cubre, de modo que puede ver qué va a traer una elección. Cuando un nombre de Netbox coincide claramente con uno suyo, la fila viene rellenada y marcada como Sugerido. Una sugerencia es solo una propuesta: nada se usa hasta que pulse Guardar correspondencias. Mientras haya correspondencias sin guardar, un aviso en la parte superior de la pestaña indica cuántas son, con el botón de guardar al lado. Si pulsa Sincronizar ahora antes de que haya algún rol o algún sitio guardado, la vista previa lo indica y le devuelve a esta pestaña en lugar de enumerar todos los objetos como omitidos.

Asignar un sitio de Netbox también trae sus ubicaciones de Netbox como sub-ubicaciones de la ubicación que haya elegido. Solo las ubicaciones de primer nivel de ese sitio, y solo aquellas en las que realmente se encuentra un equipo importado. Un equipo situado más abajo, en «Edificio A > Planta 1 > Sala 101», se asocia a «Edificio A»: KANAP registra dónde está un equipo al nivel de un sitio y un edificio, no de una sala. No hay nada que configurar para esto.

Sistemas operativos¶

La tercera tabla asocia cada plataforma de Netbox con un sistema operativo de su catálogo. Netbox dice «Debian 12» donde KANAP tiene «Debian 12 (bookworm)», y es aquí donde se unen los dos. Cada fila indica cuántos objetos usan esa plataforma.

Las filas vienen rellenadas cuando KANAP ve la respuesta: el mismo nombre, o el único sistema operativo cuyo nombre empieza por el nombre de la plataforma. «Debian 12» sugiere «Debian 12 (bookworm)». Como en las otras tablas, una sugerencia solo cuenta cuando pulsa Guardar correspondencias.

Esta tabla no es un filtro. Una plataforma que quede en Sin correspondencia nunca deja nada fuera de la importación. El equipo entra y su sistema operativo se queda tal como está en KANAP. Asocie la plataforma más tarde y la siguiente ejecución rellena el campo.

Netbox concede permisos de lectura por tipo de objeto, así que un token autorizado a leer equipos, roles y sitios puede aun así tener vedadas las plataformas. Los roles y los sitios siguen funcionando y la importación no se ve afectada. Solo esta sección queda vacía, y dice por qué.

La primera sincronización¶

Pulse Sincronizar ahora. KANAP lee Netbox y muestra Revisar antes de aplicar antes de escribir nada.

La vista previa está agrupada:

Sub-ubicaciones: las filas compartidas que la ejecución crea, adopta o renombra, enumeradas una vez cada una con la ubicación a la que pertenecen y cuántos equipos acaban en ellas. Renombrar una ubicación de Netbox aparece aquí como una sola línea, no como el movimiento de cada activo.
Por crear: objetos sin equivalente en KANAP. Se van a crear.
Por actualizar: objetos asociados a un activo existente que difiere. Todavía no se ha modificado nada, los valores se escriben cuando usted aplica. Cada uno enumera los campos que cambian, campo por campo, como antes → después.
Por decidir: objetos sobre los que KANAP no decide por su cuenta. No les pasa nada hasta que los resuelva, aquí o más tarde en la página.
Omitidos: objetos fuera de alcance, contados por motivo (rol sin correspondencia, sitio sin correspondencia, sin nombre en Netbox, ignorado por usted).
Ausentes de Netbox: activos que una ejecución anterior vinculó y cuyo objeto de Netbox ha desaparecido.
Avisos: valores que Netbox devuelve y que KANAP no ha podido retomar, por ejemplo un sistema operativo que no está en su catálogo. Un objeto que no tiene nada que cambiar pero sí algo que señalar aparece también aquí.

Léala y pulse Aplicar. Los objetos que ya son idénticos se cuentan como sin cambios y no se tocan en absoluto. Un inventario grande se revisa en lotes de 500. Aplicar este lote solo escribe lo que la vista previa enumera; todo lo demás se deja exactamente como está. La página indica después cuántos objetos siguen en espera y ofrece Revisar el lote siguiente, hasta que no quede nada. Una sincronización que usted inicia nunca crea ni modifica un objeto que no se le haya mostrado. Los objetos fuera de alcance se cuentan por motivo y no se enumeran, de modo que nunca ocupan el lugar de un objeto que usted debe leer. El filtro de la parte superior restringe la lista a un objeto o a un nombre de activo.

Corregir la vista previa antes de aplicar¶

KANAP solo puede reconocer un activo por su número de serie, su nombre de host o su nombre. Un equipo que usted ha renombrado, sin ninguno de estos datos en común, aparece en Por crear y se crearía por segunda vez. La vista previa le permite resolverlo antes. Una fila para la que KANAP propone algo tiene un botón, Corregir en Por crear y Por actualizar, Decidir en los objetos que necesitan una decisión. Un objeto ya vinculado por una ejecución anterior no lo tiene: está resuelto, y la fila solo muestra lo que cambia. Una primera asociación indica en qué se basa («Reconocido por su número de serie»), para que pueda detectar un error. El botón abre estas opciones:

Vincular a un activo existente: busque el activo y selecciónelo. La fila pasa a Por actualizar y muestra lo que Netbox va a cambiar en ese activo, campo por campo, para que siga leyendo antes de aplicar.
Crear un activo nuevo: para un objeto clasificado en Por decidir, o para uno que KANAP ha asociado al activo equivocado.
No importar este objeto: el objeto queda fuera de esta sincronización y de las siguientes. Ningún activo se modifica. Pasa a Resueltos por usted en la vista previa y, una vez aplicado, a Ignorados en la página, donde podrá recuperarlo más tarde.

Una fila sobre la que ha decidido lo indica y ofrece Deshacer. Cuando varios objetos clasificados en Por decidir tienen un único activo sugerido, Vincular los N objetos que solo tienen una sugerencia los resuelve todos de una vez. Pasan a Por actualizar, donde lee lo que cambia antes de aplicar.

No se escribe nada mientras decide. Sus decisiones se aplican junto con todo lo demás cuando pulsa Aplicar, y se mantienen después: la sincronización automática sigue los vínculos que usted ha creado. Cerrar la vista previa los descarta.

La aplicación se ejecuta en segundo plano. La página la sigue y se actualiza sola cuando termina.

Cómo se asocian los objetos a los activos existentes¶

Una primera importación en un KANAP ya poblado tiene que encontrar los activos que usted ya tiene en lugar de duplicarlos. KANAP prueba cuatro cosas, en orden, y se detiene en la primera que encuentra algo:

Un vínculo existente. El objeto ya se asoció a un activo en una ejecución anterior.
El número de serie. Sobrevive a un cambio de nombre en cualquiera de los dos lados.
El nombre de host, tomado entero. par-esx-01.example.com en Netbox es el activo cuyo nombre de host está escrito así. También es el activo par-esx-01 cuando example.com es uno de sus dominios, porque ese sufijo lo declaró usted mismo.
El nombre del activo, ignorando mayúsculas, leído de la misma manera.

Si un paso encuentra exactamente un activo, esa es la asociación. Si encuentra varios, KANAP se detiene ahí y clasifica el objeto en Por decidir con los candidatos enumerados. Nunca fusiona por conjetura.

Dos señales son propuestas, nunca asociaciones. Cuando ninguno de los cuatro pasos identifica el objeto, KANAP busca un parecido en lugar de crear sin más.

Un nombre que empieza igual. Un activo cuyo nombre o nombre de host solo coincide con la primera parte del nombre de Netbox, hasta el primer punto, se ofrece como candidato. En un inventario que nombra los equipos dl3.robot-15ms.ie2000, esa primera parte es un edificio y no una máquina, y un único activo llamado dl3 absorbería toda la planta sin hacer ruido.
Una dirección ya asignada. Un activo que ya lleva la dirección principal del objeto se ofrece del mismo modo. Las direcciones se reutilizan, se comparten entre los miembros de un clúster o simplemente están obsoletas.

En los dos casos el objeto no se crea. Pasa a Por decidir con ese activo como sugerencia, bajo «Un activo tiene un nombre parecido. Decida si es el mismo equipo.» o «Un activo ya usa la dirección...», y un clic lo resuelve. Ninguna de las dos señales vincula nada por sí sola, ni siquiera cuando se encuentra un único activo: un vínculo equivocado dejaría que Netbox sobrescribiera el activo equivocado. La sincronización automática sigue la misma regla y no escribe nada para un objeto así, de modo que un equipo nuevo de Netbox nunca se convierte en un duplicado a sus espaldas.

Otras dos reglas mantienen el resultado limpio:

Un activo pertenece a un solo objeto de Netbox, y al revés. La base de datos lo impone. Un activo que ya pertenece a otro objeto queda fuera del alcance de todo lo demás, y vincular un activo ya ocupado se rechaza con un mensaje que nombra el objeto que lo retiene. Si dos objetos de Netbox llegan al mismo activo libre, ambos se le envían para que decida.
Un equipo eliminado y recreado en Netbox se recupera. Vuelve con un identificador de Netbox nuevo, así que el registro antiguo pasa a ausente, libera su activo, y el objeto nuevo lo retoma por nombre de host en la misma ejecución. Si otro objeto se ha quedado con ese activo mientras tanto, el equipo que vuelve se trata como un objeto nuevo.

Qué campos gestiona Netbox¶

Gestionado por Netbox	Sigue siendo suyo en KANAP
Nombre	Entorno
Nombre de host y dominio	Notas y descripción
Número de serie	Fechas, soporte y garantía
Fabricante y modelo	Contratos y costes
Ubicación en el rack y unidad de rack	Aplicaciones alojadas en el activo
Dirección IP principal	Conexiones y otras relaciones
Sistema operativo	Adjuntos, tareas, incidentes
Ciclo de vida	Todo lo demás del activo
Ubicación
Sub-ubicación

En un activo vinculado a Netbox, un campo gestionado aparece como Gestionado por Netbox y no se puede editar en KANAP. Cámbielo en Netbox y la siguiente ejecución lo trae. Todo lo demás del activo sigue siendo editable como siempre.

Solo se bloquean los campos que Netbox rellena de verdad para ese objeto. Netbox no tiene noción de dominio, un equipo a menudo no tiene plataforma y a veces no tiene dirección principal. Esos campos quedan para que los complete usted y, como una sincronización nunca escribe un valor vacío, lo que escriba ahí nunca se sobrescribe. La página del activo lo dice en una línea: «Netbox rellena los campos que proporciona. Los demás puede completarlos usted.»

Cada ejecución actualiza esa lista, incluso en un objeto en el que no cambió nada. Añada una plataforma en Netbox y el sistema operativo se retoma en la siguiente ejecución, y queda bloqueado a partir de ahí. Un activo importado antes de este comportamiento mantiene todos sus campos bloqueados hasta su próxima sincronización.

La página del activo lleva además una línea Origen: cuándo se hizo la última sincronización, un enlace Abrir en Netbox, y un aviso cuando el objeto ya no está.

Reglas que conviene conocer¶

Un valor vacío en Netbox nunca borra un valor de KANAP. Si Netbox no tiene número de serie y KANAP sí, se conserva el número de serie. Solo se escribe un valor que Netbox tenga de verdad.

Las ediciones manuales se corrigen. Cada ejecución compara con los valores reales del activo, así que un campo gestionado que se haya cambiado en KANAP por otra vía se vuelve a alinear en la siguiente ejecución.

Un punto solo es un dominio si usted lo dice. Un nombre de Netbox se divide en nombre de host y dominio cuando termina con un sufijo DNS de su lista de dominios, en Panorama IT > Configuración. Gana el sufijo más largo, así que un nombre acabado en corp.example.com toma ese dominio y no example.com. Todo lo demás es simplemente un nombre: dl3.robot-15ms.ie2000 pasa a ser el nombre de host tal cual, puntos incluidos, y el dominio queda intacto. No se señala nada, porque no hay nada que corregir. Para que se reconozca un sufijo, añada el dominio en la configuración: la siguiente ejecución divide el nombre por sí sola.

Los activos importados antes de esta regla, cuyo nombre de host se cortaba en el primer punto, los corrige la siguiente ejecución. La corrección aparece en la vista previa como un cambio de nombre de host cualquiera.

Los cambios de nombre se entienden. Una diferencia de mayúsculas no es un cambio de nombre. Un sufijo de dominio que usted haya declarado, tampoco: PAR-ESX-01 y par-esx-01.example.com son la misma máquina que par-esx-01 cuando example.com es uno de sus dominios.

El ciclo de vida sigue una tabla fija.

Estado en Netbox	Ciclo de vida en KANAP
Planned, Staged, Inventory	Propuesto
Active, Offline, Failed, Paused	Activo
Decommissioning	Obsoleto
Cualquier otro	Se deja sin cambios, con un aviso

Offline, Failed y Paused siguen a la vista. El ciclo de vida se mantiene en Activo, porque el equipo sigue en servicio sobre el papel. KANAP conserva el estado de Netbox y lo muestra como un aviso: en el activo, junto a su origen («Estado en Netbox: Averiado»), en la lista de objetos vinculados y entre las advertencias de la vista previa. Si en Netbox solo cambia este estado, el activo no se reescribe.

Una sincronización nunca pone un activo en Retirado. Retirar un equipo es una decisión que toma usted, desde la lista Ausentes de Netbox.

El entorno se establece una sola vez. Los activos nuevos reciben el entorno elegido en la tarjeta de la integración. Las ejecuciones posteriores no lo tocan nunca, así que puede corregirlo en KANAP y se queda corregido.

Los valores que KANAP no conoce se omiten, nunca se inventan. Un estado de ciclo de vida sin equivalente, o un sistema operativo sin correspondencia en Correspondencias y sin entrada de ese nombre en Panorama IT > Configuración, se deja sin cambios y se señala como aviso. Asocie la plataforma, o añada la entrada en la configuración, y vuelva a ejecutar. Una dirección principal IPv6 se deja fuera igual, con el aviso «La dirección principal es una dirección IPv6, que todavía no se importa.».

Las sub-ubicaciones se comparten entre equipos. Una sub-ubicación es una sola fila en una ubicación, y cada activo colocado ahí apunta a ella. Renombrar la ubicación de Netbox renombra esa única fila, así que todos los equipos que la llevan siguen a la vez, incluidos los que usted mismo haya clasificado ahí. Nada se mueve activo por activo.

Una sub-ubicación creada a mano se adopta, no se duplica. Cuando una ubicación de Netbox tiene el mismo nombre que una sub-ubicación que ya usa en esa ubicación, KANAP vincula las dos: su fila conserva su identidad, adopta la grafía de Netbox y queda marcada como Netbox a partir de entonces. Sus activos se quedan donde están.

Nunca se elimina nada. Una ubicación retirada de Netbox deja su sub-ubicación en su sitio, con los activos que la llevan. Una sub-ubicación vinculada a Netbox sigue siendo editable: renómbrela o elimínela en KANAP y la siguiente ejecución la vuelve a alinear, creándola de nuevo si un activo todavía la necesita.

Un equipo sin ubicación conserva su sub-ubicación. Solo se escribe una ubicación que Netbox comunique de verdad, la misma regla que para cualquier otro campo gestionado. Las máquinas virtuales no reciben ninguna: una máquina virtual de Netbox no lleva ubicación.

Dos ubicaciones con el mismo nombre en un mismo sitio. Netbox permite «Sala técnica» y «sala técnica» una junto a otra, KANAP no. La primera que se importa gana, y la otra se señala como aviso. Lo mismo ocurre cuando dos sitios de Netbox están asignados a la misma ubicación de KANAP y ambos contienen una ubicación con el mismo nombre.

Si Netbox no devuelve sus ubicaciones, la ejecución continúa con los equipos y deja todas las sub-ubicaciones intactas, con una nota en la vista previa que lo indica. Una asignación parcial sería peor que ninguna.

Un activo nuevo toma el proveedor de su ubicación cuando ese proveedor existe en su configuración IT, y «Otro» en caso contrario. Netbox no tiene noción de proveedor de alojamiento.

Una ejecución que falla sin parar se detiene. Después de 10 objetos seguidos que no se han podido guardar, la ejecución se detiene y se declara fallida, en vez de llenar la lista de filas en error y luego anunciar que todo ha ido bien.

Una lectura parcial no marca nada como ausente. Si Netbox contiene más páginas de las que KANAP lee en una ejecución, no se señala nada como ausente y un aviso acompaña al resultado.

Un reinicio del servidor no bloquea la página. Sincronizar ahora vuelve a funcionar de inmediato; una ejecución interrumpida por el reinicio se declara detenida sin haber terminado.

Sincronización automática¶

Active Sincronización automática en la tarjeta de la integración y KANAP ejecuta el mismo trabajo cada hora, aplicando los cambios sin vista previa. El conmutador es por espacio de trabajo, y solo se visitan los espacios de trabajo que lo han activado. El trabajo horario nunca hace la primera importación: empieza cuando usted ha aplicado una sincronización y esta ha terminado sin errores. Hasta entonces el conmutador puede estar activado sin que se ejecute nada. Lo mismo ocurre mientras una revisión no ha terminado: mientras haya objetos esperando su lote, el trabajo horario queda en pausa, porque importaría lo que nadie ha leído. Se reanuda en cuanto una sincronización que usted aplique no deje nada en espera.

Los objetos que necesitan una decisión no se resuelven nunca de forma automática. Se acumulan en Por decidir y le esperan.

Las sub-ubicaciones también las crea y renombra la ejecución automática. Un espacio de trabajo cuyo primer import ya está hecho las recibe en la siguiente ejecución horaria, sin vista previa previa.

Una ejecución manual y una ejecución programada no pueden solaparse: si ya hay una en marcha, la otra no hace nada para ese espacio de trabajo y vuelve a intentarlo más tarde. En la edición en la nube, un espacio de trabajo con la suscripción congelada o con la prueba caducada se omite hasta que se resuelva la suscripción. Las instalaciones on-premise no se ven afectadas.

La página de gestión¶

Panorama IT > Netbox es donde se trabaja una vez configurada la conexión. La banda superior muestra la última ejecución: cuándo fue, si se inició a mano o de forma automática, cuánto duró, su resultado, y cuántos objetos están vinculados o necesitan atención.

Debajo, la pestaña Objetos enumera todos los objetos de Netbox dentro del alcance, filtrados por estado.

La columna Tipo muestra el tipo de activo KANAP del activo vinculado, «Servidor físico» o «Máquina virtual» en lugar de la palabra «Equipo» para todo. Un objeto que todavía no tiene activo muestra su tipo de Netbox en gris, porque de momento no hay más que decir. Junto a los filtros de estado, un campo de búsqueda acota la lista. Busca en el nombre de Netbox, el nombre del activo y la referencia del activo, y la lista sigue al campo poco después de que deje de escribir.

Estado	Qué significa	Qué puede hacer
Por decidir	Varios activos podrían ser este objeto, dos objetos han llegado al mismo activo, un activo tiene un nombre parecido, o un activo ya lleva la dirección IP del objeto.	Vincular a... uno de los candidatos, Crear un activo, o Ignorar.
Ausentes de Netbox	El objeto ha desaparecido de Netbox. El activo queda intacto.	Marcar el activo como retirado, Ignorar, o dejarlo.
Errores	El objeto no se ha podido escribir, con el motivo en la columna Mensaje.	Corrija la causa y vuelva a ejecutar, o Ignorar el objeto.
Ignorados	Le ha dicho a KANAP que deje este objeto en paz. Se omite en cada ejecución.	Dejar de ignorar lo devuelve a la lista. Cuando el registro no contiene nada que decidir, lo retira en su lugar y el objeto se vuelve a evaluar en la siguiente sincronización.
Vinculados	El objeto y el activo están asociados y al día.	Abra cualquiera de los dos lados desde la fila.

Cada fila enlaza con el objeto en Netbox y con el activo en KANAP, con su referencia AST-.

Vincular o crear desde esta página aplica los valores de Netbox de inmediato. Lee ese único objeto en Netbox, así que sigue siendo rápido en un inventario grande. Los mensajes y los avisos se muestran en su propio idioma.

Ausentes de Netbox¶

KANAP nunca elimina un activo. Cuando un objeto desaparece de Netbox, el activo, sus vínculos y su historial se quedan exactamente como están, y el objeto se enumera como ausente para que usted decida. Marcar el activo como retirado pone el ciclo de vida en Retirado y conserva todo lo demás.

Se aplican dos salvaguardas. No se señala nada como ausente cuando la llamada a Netbox ha fallado, ni cuando Netbox ha devuelto un inventario vacío: una interrupción no es un desmantelamiento. Y un activo cuyo objeto de Netbox ha desaparecido vuelve a estar libre, así que la misma máquina recreada en Netbox se vincula de nuevo a él en lugar de crear un duplicado.

Hay un widget Sincronización con Netbox disponible en su panel de control personal. Está desactivado de forma predeterminada. Actívelo desde la configuración del panel, el icono de engranaje en Panel de control, y marque Sincronización con Netbox. El widget necesita infrastructure:admin, como el resto de la integración.

El widget no molesta cuando no hay nada que hacer: una línea que dice que la sincronización está al día, con la hora de la última ejecución. Cuando algo necesita atención, enumera solo lo que la necesita: objetos por decidir, activos ausentes de Netbox, errores, o una ejecución fallida. Cada línea abre la lista filtrada correspondiente.

Resolución de problemas¶

Lo que ve	Lo que suele significar
Netbox ha rechazado el token de API	El token se truncó al pegarlo, ha caducado, o está restringido a otra dirección. Cree uno nuevo en Netbox y vuelva a guardarlo.
No se permiten hosts privados ni internos	La edición en la nube solo llega a direcciones públicas. Publique Netbox en una dirección que KANAP pueda alcanzar, o ejecute KANAP on-premise junto a él.
No se ha podido verificar el certificado	Netbox presenta un certificado en el que KANAP no confía. Instale un certificado de confianza, o active Ignorar los errores de certificado si el certificado es suyo.
El servidor de Netbox no ha respondido a tiempo	Netbox está lento, inaccesible, o detrás de un cortafuegos que descarta la llamada. Compruébelo desde el servidor de KANAP y luego suba el tiempo de espera si la instancia es simplemente grande.
Los objetos aparecen como omitidos, con el motivo «Rol sin correspondencia» o «Sitio sin correspondencia»	Es lo esperado para todo lo que dejó en No importar. Si no debía omitirse, asigne el rol o el sitio y vuelva a ejecutar.
Un aviso dice que un sistema operativo no está en su catálogo	La plataforma de Netbox no tiene correspondencia en Correspondencias > Sistemas operativos ni entrada de ese nombre en Panorama IT > Configuración. Asóciela en la pestaña Correspondencias, o añada el sistema operativo en la configuración, y vuelva a ejecutar. El campo se deja sin cambios hasta entonces.
«Netbox no ha devuelto sus plataformas»	El token de API no puede leer las plataformas. Déle permiso sobre `dcim.platform` en Netbox, o déjelo así: los equipos se siguen importando y solo queda fuera la correspondencia de sistemas operativos.
Un activo acaba con el nombre completo de Netbox como nombre de host	El nombre no termina con un sufijo DNS de su lista de dominios, así que KANAP lo conserva tal cual. Es el resultado esperado para un nombre cuyos puntos forman parte del nombre. Si de verdad es un dominio, añádalo en Panorama IT > Configuración y vuelva a ejecutar.
La ejecución ha fallado después de unos pocos objetos	Diez objetos seguidos no se han podido guardar, así que la ejecución se ha detenido. La causa suele ser la misma para todos, y los detalles están en el registro del servidor.
«Netbox ha devuelto más páginas de las previstas. Algunos objetos no se han revisado.»	El inventario es más grande de lo que una ejecución lee. Lo leído se aplica, y no se marca nada como ausente. Reduzca el alcance en Correspondencias para que la ejecución cubra lo que le importa.
Una sub-ubicación avisa de que su nombre ya está en uso	Dos ubicaciones de Netbox de ese sitio comparten el nombre, o dos sitios asignados apuntan a la misma ubicación de KANAP y cada uno contiene una ubicación con ese nombre. Renombre una de ellas en Netbox, o fusiónelas allí. Los equipos se importan en cualquier caso, sin sub-ubicación.
«Netbox no ha devuelto sus ubicaciones»	El token de API no puede leer las ubicaciones. Déle permiso sobre `dcim.location` en Netbox, o déjelo así: la importación de equipos no se ve afectada.

Consejos¶

Primero las correspondencias, después la sincronización. Las correspondencias son el alcance. Empiece por los roles y los sitios de los que esté seguro, ejecute una vez, y amplíe después.
Declare antes sus sufijos DNS. Un nombre de Netbox solo se divide en nombre de host y dominio si termina con un sufijo que tenga en Panorama IT > Configuración. Añada los dominios que usa antes de la primera ejecución y los nombres llegarán ya divididos.
Lea la vista previa en la primera ejecución. Es la única ejecución en la que todas las asociaciones son nuevas, así que es la que merece leerse línea por línea.
Equipos renombrados: revise la lista Por crear. Todo lo que reconozca ahí está a punto de duplicarse. Vincúlelo a su activo en la vista previa, o rellene su número de serie o su nombre de host en KANAP y vuelva a abrir la vista previa.
Rellene los números de serie. Es la asociación más sólida que existe. Los activos que llevan número de serie sobreviven a los cambios de nombre en ambos lados sin caer nunca en Por decidir.
Espere antes de activar la ejecución horaria. Dos ejecuciones manuales limpias seguidas, la segunda sin nada que cambiar, significan que las correspondencias y las asociaciones son correctas.