Tema
Este artículo describe sus características y explica cómo generarlos.
Para saber cómo habilitar SentinelOne en la consola de NinjaOne, consulta SentinelOne.
Entorno
- Integraciones de NinjaOne
- SentinelOne
Descripción
SentinelOne utiliza tokens para acceder a la consola de gestión de la API (Interfaz de programación de aplicaciones). También puede utilizar tokens para activar la integración de SentinelOne con NinjaOne. Seleccione un tema para continuar.
- Acerca de los tokens de API en SentinelOne
- Generación de un token de API
- Estado y resincronización de los tokens de API
- Notificaciones sobre la caducidad y la renovación de los tokens de API
Acerca de los tokens de API en SentinelOne
Requisitos previos
El nivel de acceso «Ámbito de la cuenta » debe estar activado para el usuario de SentinelOne en la sección «Ámbito de acceso». Para conocer otros requisitos de ámbito de acceso, consulta SentinelOne: Guía de integración – NinjaOne Dojo.
Características de los tokens de API de SentinelOne
Los usuarios deben disponer de un token para acceder a la consola de gestión de la API. Hay varias consideraciones que hay que tener en cuenta al aprovisionar tokens para SentinelOne:
- Un usuario de SentinelOne solo puede tener un token.
- Se puede automatizar la renovación de este token. Recomendamos utilizar cualquier rol que admita opciones para ampliar el plazo de caducidad de 30 días.
- El token de la API es necesario para utilizar scripts.
- El token de la API elude la autenticación de dos factores (2FA).
- Es tu responsabilidad proteger el token de la API.
- Puede revocar o volver a generar el token desde la consola de SentinelOne (estas opciones se encuentran en los «Detalles del usuario» una vez generado el token) o a través de la API.
https://{su nombre de dominio}.sentinelone.net/docs/en/creating-service-users.html.Prácticas recomendadas para los tokens de API
Para garantizar la seguridad y el rendimiento de su integración de la API, siga estas prácticas recomendadas:
- Guarde el token de API descargado en el archivo o la ubicación que utilicen sus solicitudes de API.
- Para compartir scripts, cada usuario debe guardar su token de API con el mismo nombre de ruta.
- Proteja el archivo del token de API contra fugas accidentales o manipulaciones maliciosas.
Generación de un token de API
Cada usuario de NinjaOne solo puede generar un token, que tiene una validez de 30 días. Para ello, sigue el siguiente procedimiento.
https://{tu nombre de dominio}.sentinelone.net/docs/en/control-api-token-generation.html para obtener más información sobre cómo asignar estos permisos.- Inicie sesión en su consola de gestión web de SentinelOne.
- En el menú de navegación superior, haz clic en el menú desplegable del nombre de la cuenta y selecciona «Mi usuario».
Figura 1: Nombre de la cuenta → Mi usuario (haz clic para ampliar)
- En el panel de detalles del usuario que se abre, haz clic en el botón «Acciones ».
- En el menú desplegable «Acciones», ve a «Operaciones con tokens de API».
- Si es la primera vez que genera un token para esta cuenta, seleccione «Generar token de API». Si va a generar un nuevo token para el usuario, seleccione «Regenerar token de API».
Figura 2: Acciones → Operaciones con tokens de API → Generar token de API
- SentinelOne generará un nuevo token de API y lo mostrará en una ventana de uso único.
Figura 3: Acciones → Operaciones con tokens de API → Generar token de API
- Copia el valor del token de API al portapapeles de tu ordenador.
- Haz clic enCerrar.
- En NinjaOne, ve a Administración → Aplicaciones → Instaladas → SentinelOne → General.
- En la categoría«Configuración», haz clic en«Editar».
- Pega el valor copiado en el campo «Token de API ».
- Haz clic en«Guardar».
Figura 4: Editar la configuración de SentinelOne
Estado del token de API y resincronización
La sección «Estado de la sincronización » de la aplicación SentinelOne en tu instancia de NinjaOne muestra el estado de sincronización de la integración. Si el token de autenticación no es válido, el campo «Estado de sincronización » mostrará «Desconocido», incluso si en «Configuración» → «Estado » aparece «Conectado».
Figura 5: Estado de la sincronización (haz clic para ampliar)
Cuando la sincronización se realiza correctamente, el campo «Estado de sincronización» mostrará «Recuperación completada». También indicará las fechas y horas de los intentos de sincronización más recientes y de las sincronizaciones realizadas con éxito.
Figura 6: Estado de sincronización
La integración se sincroniza hasta seis veces cada cinco minutos. En caso de fallo, aparecerá el botón «Resincronizar» que se muestra en la Figura 7 en la sección «Estado de la sincronización» de la aplicación de integración de SentinelOne de NinjaOne.
Si ves un estado distinto de «Fetch complete», haz clic en el botón para restablecer el sondeador de la API e intentar otra sincronización.
Figura 7: Resincronizar (haz clic para ampliar)
Notificaciones de caducidad y renovación de tokens de API
NinjaOne intenta renovar los tokens automáticamente. Tras generar el token original, puedes configurar notificaciones que te avisen de los fallos en la renovación automática que provoquen la caducidad del token y requieran una renovación manual.
Para ello, sigue estos pasos:
- En NinjaOne, ve a «Administración» → «General » → «Actividades».
- Busca las actividades relacionadas con SentinelOne.
- Activa las notificaciones que desees recibir. Si es necesaria una resincronización y esta falla, la integración se interrumpirá; como mínimo, recomendamos habilitar «Se requiere resincronización de la integración» e «Integración desactivada» para asegurarte de estar siempre al tanto de las interrupciones críticas del servicio.
Figura 8: Administración → General → Actividades (haz clic para ampliar)
- Puede comprobar el estado de la sincronización en cualquier momento en NinjaOne accediendo a Administración → Aplicaciones → Instaladas → SentinelOne → General.
Figura 9: Estado de la sincronización (haz clic para ampliar)
Recursos adicionales
Consulte los siguientes recursos para obtener más ayuda con la integración en NinjaOne: