Integración domótica Snipe-IT, gratuita y de código abierto
Snipe-IT en Gladys: garantías y licencias que vencen, activos prestados, consumibles bajos.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Siga su inventario Snipe-IT en Gladys: las garantías y licencias a punto de vencer, los activos prestados y los que se esperan de vuelta, los consumibles que se agotan, las auditorías y los mantenimientos. Todo se queda en su red local: Gladys habla directamente con su servidor Snipe-IT, y solo lo lee.
Probado con un servidor Snipe-IT 8.8.1 real (la imagen Docker oficial). Sus comentarios son bienvenidos en el foro de Gladys.
Requisitos previos
- Gladys Assistant 5.1 o posterior.
- Un servidor Snipe-IT (versión 6 o posterior) accesible desde la máquina de Gladys.
- Un token de API personal: en Snipe-IT, abra el menú de su perfil (arriba a la derecha), Gestionar claves de API y luego Crear nuevo token, y cópielo enseguida (solo se muestra una vez). El usuario del token debe poder ver al menos los activos; las licencias, los consumibles y los mantenimientos se leen si el usuario puede verlos.
Configuración
- Abra la pestaña Configuración de la integración.
- En Dirección de Snipe-IT, introduzca la dirección que abre en su
navegador, por ejemplo
http://192.168.1.50ohttps://snipeit.example.org. - Pegue el token de API.
- Garantía que vence en (días): una garantía se considera a punto de vencer esta cantidad de días antes de su fin (30 por defecto).
- Licencia que vence en (días): lo mismo para las licencias (30 por defecto).
- Leer Snipe-IT cada: 15 minutos, 30 minutos, 1 hora (por defecto), 3 o 6 horas.
- Idioma de los nombres y mensajes fija los nombres de las funciones (fijados al añadir el dispositivo), los textos y las fechas de las variables de escena. Francés por defecto.
- Guarde y luego use Probar la conexión: muestra la versión de Snipe-IT y el número de activos y licencias.
- En la pestaña Descubrimiento, añada el dispositivo Snipe-IT.
Dispositivos
Snipe-IT (un dispositivo para su inventario):
| Función | Valor |
|---|---|
| Activos | número de activos (Snipe-IT deja fuera los archivados) |
| Activos prestados | activos asignados a un usuario, una ubicación u otro activo |
| Garantías a punto de vencer | activos cuya garantía termina en el plazo configurado |
| Licencias a punto de vencer | licencias cuya fecha de vencimiento cae en el plazo configurado |
| Consumibles bajo el mínimo | consumibles en su cantidad mínima o por debajo (mínimo superior a 0) |
| Auditorías atrasadas | activos cuya fecha de próxima auditoría ya pasó |
| Devoluciones atrasadas | activos prestados cuya fecha de devolución prevista ya pasó |
| Mantenimientos en curso | mantenimientos iniciados y no terminados |
| Próximo vencimiento | tipo, nombre y fecha del próximo vencimiento de la semana, o «Ninguno» |
Las garantías y licencias ya vencidas no se cuentan. Si el token no puede ver las licencias o los consumibles, sus funciones se quedan sin valor.
Widget del panel
Vencimientos Snipe-IT: cuatro mosaicos (activos, prestados, garantías y licencias que vencen, consumibles con stock bajo) y los vencimientos de los próximos siete días, lo atrasado primero (en rojo). Sin permiso para ver los consumibles, no aparece el mosaico de stock bajo: devoluciones previstas, auditorías, fines previstos de mantenimientos, garantías y licencias que vencen. Solo lectura.
Disparadores de escena
- Garantía que vence: la garantía de un activo entra en el plazo configurado. Una vez por activo y fecha de fin. Variables: activo, etiqueta de activo, modelo, fecha de fin, días restantes.
- Licencia que vence: una licencia entra en el plazo configurado. Una vez por licencia y fecha. Variables: licencia, puestos, fecha de vencimiento, días restantes.
- Consumible bajo el mínimo: un consumible llega a su cantidad mínima o baja de ella. Se anuncia de nuevo tras reponerlo por encima. Variables: consumible, restante, mínimo.
- Devolución atrasada: un activo prestado supera su fecha de devolución prevista. Una vez por préstamo. Variables: activo, etiqueta de activo, prestado a, devolución prevista, días de retraso.
La primera lectura tras la instalación es silenciosa: lo que ya está pendiente se ve en el dispositivo, sin anunciarse. Los disparadores se activan en la primera lectura posterior al cambio (después de medianoche, dentro del intervalo configurado).
Acciones de escena
Leer los vencimientos de la semana: lee Snipe-IT y devuelve Vencimientos (el número de vencimientos de los próximos siete días y de lo atrasado), Atrasados y Texto del resumen, una frase lista para enviar o decir, por ejemplo «3 vencimiento(s) en Snipe-IT: Devolución Laptop Bob (2 día(s) de retraso), Licencia Antivirus (22/10/2026), Garantía Home server (25/10/2026).»
Ejemplos de escenas
- Resumen del lunes: cada lunes a las 9:00 → «Leer los vencimientos de la semana» → continuar solo si el número de vencimientos es mayor que 0 → enviar el texto del resumen como mensaje.
- Recordatorio de préstamo: disparador «Devolución atrasada» → mensaje «{{triggerEvent.data.asset}} debía volver de {{triggerEvent.data.assigned_to}} el {{triggerEvent.data.expected}}».
- Lista de la compra: disparador «Consumible bajo el mínimo» → mensaje «Solo quedan {{triggerEvent.data.remaining}} {{triggerEvent.data.consumable}}».
Solución de problemas
- «Token rechazado»: el token fue revocado, caducó o no se pegó entero. Cree uno nuevo.
- «El usuario de este token no puede ver los activos»: dé al usuario el permiso «Ver» sobre los activos en Snipe-IT y compruebe que esté activado.
- «Snipe-IT no responde»: compruebe la dirección desde la máquina de
Gladys. El contenedor usa una red puente:
localhostes el propio contenedor, introduzca en su lugar la dirección IP del servidor. - «Esta dirección no responde como Snipe-IT»: responde en su lugar una
página de acceso de un proxy, o la dirección no es la de Snipe-IT
(compruebe
APP_URLy la ruta detrás de un proxy inverso). - Para ver más en los registros de la integración, configure
LOG_LEVEL=debug.
Límites
- Solo lectura: la integración nunca modifica su inventario.
- Cada lectura son al menos cuatro peticiones (activos, licencias, consumibles, mantenimientos, 500 filas por petición), muy por debajo del límite de la API de Snipe-IT (120 peticiones por minuto por defecto).
- Un servidor Snipe-IT por integración. Los componentes y accesorios no se siguen.
- Sin relación con Grokability ni con el proyecto Snipe-IT.
Parámetros de configuración
Estos son los parámetros que Snipe-IT te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Conectar Snipe-IT | section | No | Introduzca la dirección de su servidor Snipe-IT y un token de API personal: en Snipe-IT, abra el menú de su perfil, Gestionar claves de API y luego Crear nuevo token. El usuario del token debe poder ver los activos y, si es posible, las licencias, los consumibles y los mantenimientos. La integración solo lee su inventario. |
| Dirección de Snipe-IT | string | Sí | |
| Token de API | secret | Sí | |
| Garantía que vence en (días) | number | No | Una garantía se considera a punto de vencer esta cantidad de días antes de su fin. |
| Licencia que vence en (días) | number | No | |
| Leer Snipe-IT cada | select | No | |
| Idioma de los nombres y mensajes | select | No | Los nombres de las funciones se fijan al añadir el dispositivo a Gladys. |
Cómo instalar Snipe-IT en Gladys
- En Gladys, abre Integraciones: Snipe-IT aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-snipeit:1.0.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-snipeit.
Snipe-IT requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Snipe-IT es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación