¿Ya eres cliente de NinjaOne? Inicia sesión para ver más guías y las últimas actualizaciones.

Instalación del agente NinjaOne: tokenización de los agentes

  • Última actualización 21 de abril de 2026

Tema

Este artículo describe cómo asignar automáticamente información crítica sobre los puntos finales de destino al agente NinjaOne durante la implementación.

Entorno

NinjaOne Endpoint Management

Descripción

Puede utilizar tokens alfanuméricos con un instalador de agente «genérico» especializado al implementar el agente NinjaOne en terminales Windows, Linux y macOS. Los tokens representan el servidor, la organización, la ubicación y la función de cada agente.

Cómo implementar el agente NinjaOne (NinjaOne, Inc., 07:10:00)

Capítulos del vídeo

  • 0:00 Generación del instalador dedicado
  • 2:30 Instalador con tokens (migraciones masivas)
  • 4:16 Revocación de tokens
  • 5:08 Aprovechamiento de los tokens en un script
  • 6:32 Implementación en AD e Intune

Índice

Cómo funciona la tokenización automática

La tokenización automática genera automáticamente un token para cada combinación de ubicación y organización. Este proceso continuará a medida que añadas nuevas organizaciones y ubicaciones. Este enfoque simplifica las instalaciones basadas en scripts, acelera las implementaciones masivas y ofrece múltiples ventajas con respecto a los flujos de trabajo tradicionales. Por ejemplo:

  • El instalador genérico admite la implementación mediante scripts al aceptar un token (por ejemplo, a través de un parámetro de línea de comandos) para asignar el servidor de destino, la organización, la ubicación y la función. Se integra fácilmente con los scripts de implementación existentes.
  • A diferencia de los instaladores específicos para sistemas operativos que utilizan directorios estáticos, el instalador compatible con tokens admite rutas de instalación dinámicas basadas en la organización.
  • El instalador está alojado en una URL persistente que siempre proporciona la última versión del agente, lo que elimina la necesidad de actualizar los scripts cuando se lanzan nuevas versiones.

Si se desactiva la tokenización automática, NinjaOne ya no creará automáticamente tokens para nuevas ubicaciones y organizaciones, pero seguirá generando tokens cuando se añada un nuevo dispositivo, en función de las selecciones realizadas durante el proceso de adición del dispositivo. Aunque la generación sigue siendo «automática», el usuario debe añadir un dispositivo para crear el token.

Esta diferencia es clave. Con la tokenización automática activa, los tokens se crean de forma proactiva para todas las combinaciones posibles sin necesidad de una acción adicional por parte del usuario. Con la tokenización automática inactiva, NinjaOne solo crea tokens según sea necesario durante la adición del dispositivo.

Gestión del instalador en NinjaOne

El instalador genérico incluye opciones para la prevención de desinstalaciones, la deduplicación y la creación automática de tokens. Puede gestionar estas funciones desde NinjaOne navegando a Administración → General → Configuración → Instalador del agente.

No cambie el nombre del instalador ni monte varios volúmenes DMG (archivos de disco) con el instalador. Si lo hace, se borrará el token o el agente obtendrá un token incorrecto. 
Figura 1: Administración → General → Configuración → Instalador del agente (haga clic para ampliar)

El panel del instalador del agentele permite configurar estos ajustes:

  • Prevención de desinstalación: cuando está activa, los usuarios finales no pueden desinstalar el agente de NinjaOne de los terminales en los que está presente.
  • Deduplicación de agentes: active la deduplicación para detectar y fusionar automáticamente las entradas de dispositivos duplicadas que se encuentren en NinjaOne durante la implementación.
  • Creación automática de tokens: para crear automáticamente tokens de agente genéricos para todas sus organizaciones y ubicaciones de NinjaOne, asegúrese de que esta opción no esté desactivada.
  • Gestión del instalador: active esta configuración para mostrar la funciónInstaladores de agente en las páginas del panel de control.

Revocación de tokens

Puede revocar tokens de un solo dispositivo o de varios dispositivos a la vez.

Si revoca un token mientras la creación automática de tokens está activada, NinjaOne generará nuevos tokens para cada uno.

Revocación de un único token

Para revocar un solo token:

  1. En NinjaOne, acceda al panel de control de la organización o el sistema seleccionado.
  2. Abre la pestaña Dispositivos y selecciona Instaladores de agentes.
Figura 2: Gestionar instaladores de agentes desde el panel de control del sistema (haz clic para ampliar)
  1. En la tabla Instaladores de agentes , pase el cursor sobre la entrada del dispositivo que desea revocar, haga clic en el icono de engranaje y seleccione Revocar en el menú desplegable.
Debe tener permisos suficientes en NinjaOne para actualizar la organización; de lo contrario, el botón Revocar no aparecerá. Para obtener más información sobre los permisos, consulte
Figura 3: Flujo de trabajo de revocación de tokens (haga clic para ampliar)

Una vez que haya revocado el acceso de uno o más dispositivos:

  • Las entradas de la tabla «Instaladores de agentes » correspondientes a los dispositivos revocados se desactivarán.
    • La columna «Estado » del instalador lo indicará como «Inactivo».
    • Las columnas «Fecha de revocación » y «Revocado por » se completarán con la fecha en que se produjo la revocación y el ID del usuario que realizó la acción
  • El registro de actividades de NinjaOne registrará una entrada que contenga «Actividad: Organización actualizada → Instalador de agente revocado».

Revocación de varios tokens

Para revocar varios tokens:

  1. En NinjaOne, acceda al panel de control de la organización o el sistema seleccionado.
  2. Abra la pestaña Dispositivos y seleccione Instaladores de agente.
  3. En la tabla Instaladores de agente , marque las casillas de verificación de cada dispositivo que desee revocar.
  4. Haga clic en Revocar.
Figura 4: Revocación de varios dispositivos (haga clic para ampliar)

Visualización de los detalles del instalador y obtención del comando de instalación

Para ver los detalles de los instaladores asignados a una organización o sistema concreto, siga estos pasos:

  1. En NinjaOne, acceda al panel de control de la organización o el sistema seleccionado.
  2. Abra la pestaña Dispositivos y seleccione Instaladores de agentes.
  3. Haga clic en el valor que aparece en la columna «Token» del instalador que desea revisar.
Figura 5: Ver los detalles del instalador de tokens (haga clic para ampliar)

Se abrirá la ventana Detalles del instalador, que mostrará información similar a la del ejemplo que se muestra en la siguiente figura.

Con la ventana de detalles del instalador de tokens abierta, puede seleccionar un nuevo sistema operativo o tipo de distribución, lo que generará una URL, un comando y un archivo de descarga que puede utilizar para instalar el token. 

Figura 6: Cambiar el tipo de distribución del instalador del token (haga clic para ampliar)

Recursos adicionales

Para saber cómo implementar el agente de NinjaOne en los puntos finales compatibles, consulte los siguientes artículos:

FAQ

Próximos pasos