Snipe-IT Smart-Home-Integration, kostenlos und Open Source

Snipe-IT in Gladys: ablaufende Garantien und Lizenzen, verliehene Assets, knappes Material.

• Veröffentlicht von guim31
• Geräte
• Version 1.0.1
• Erfordert Gladys >=5.1.0
• ★ 0

Auf GitHub ansehenAlle Integrationen

Verfolge dein Snipe-IT-Inventar in Gladys: bald ablaufende Garantien und Lizenzen, verliehene Assets und erwartete Rückgaben, knappes Verbrauchsmaterial, Audits und Wartungen. Alles bleibt in deinem lokalen Netzwerk: Gladys spricht direkt mit deinem Snipe-IT-Server und liest ihn nur.

Getestet mit einem echten Snipe-IT-8.8.1-Server (das offizielle Docker-Image). Rückmeldungen sind im Gladys-Forum willkommen.

Voraussetzungen

• Gladys Assistant 5.1 oder neuer.
• Ein Snipe-IT-Server (Version 6 oder neuer), erreichbar vom Gladys-Rechner.
• Ein persönliches API-Token: Öffne in Snipe-IT das Menü deines Profils (oben rechts), API-Schlüssel verwalten, dann Neues Token erstellen, und kopiere es sofort (es wird nur einmal angezeigt). Der Benutzer des Tokens muss mindestens die Assets sehen dürfen; Lizenzen, Verbrauchsmaterial und Wartungen werden gelesen, wenn er sie sehen darf.

Konfiguration

1. Öffne den Tab Konfiguration der Integration.
2. Gib unter Snipe-IT-Adresse die Adresse ein, die du im Browser öffnest, zum Beispiel http://192.168.1.50 oder https://snipeit.example.org.
3. Füge das API-Token ein.
4. Garantie läuft ab in (Tagen): so viele Tage vor ihrem Ende gilt eine Garantie als bald ablaufend (standardmäßig 30).
5. Lizenz läuft ab in (Tagen): dasselbe für Lizenzen (standardmäßig 30).
6. Snipe-IT lesen alle: 15 Minuten, 30 Minuten, 1 Stunde (Standard), 3 oder 6 Stunden.
7. Sprache der Namen und Meldungen legt die Namen der Funktionen (beim Hinzufügen des Geräts festgelegt), die Texte und die Daten der Szenenvariablen fest. Standardmäßig Französisch.
8. Speichere und nutze dann Verbindung testen: sie zeigt die Snipe-IT-Version und die Anzahl der Assets und Lizenzen.
9. Füge im Tab Erkennung das Gerät Snipe-IT hinzu.

Geräte

Snipe-IT (ein Gerät für dein Inventar):

Funktion	Wert
Assets	Anzahl der Assets (Snipe-IT lässt archivierte weg)
Herausgegebene Assets	an einen Benutzer, einen Standort oder ein anderes Asset herausgegeben
Bald ablaufende Garantien	Assets, deren Garantie im eingestellten Fenster endet
Bald ablaufende Lizenzen	Lizenzen, deren Ablaufdatum im eingestellten Fenster liegt
Verbrauchsmaterial unter Minimum	Verbrauchsmaterial auf oder unter seiner Mindestmenge (Minimum über 0)
Überfällige Audits	Assets, deren nächstes Auditdatum vorbei ist
Überfällige Rückgaben	herausgegebene Assets, deren erwartetes Rückgabedatum vorbei ist
Laufende Wartungen	begonnene und nicht abgeschlossene Wartungen
Nächste Frist	Art, Name und Datum der nächsten Frist der Woche, oder „Keine"

Bereits abgelaufene Garantien und Lizenzen werden nicht gezählt. Darf das Token die Lizenzen oder das Verbrauchsmaterial nicht sehen, bleiben ihre Funktionen ohne Wert.

Dashboard-Widget

Snipe-IT-Fristen: vier Kacheln (Assets, herausgegeben, ablaufende Garantien und Lizenzen, knappes Verbrauchsmaterial) und die Fristen der nächsten sieben Tage, Überfälliges zuerst (rot). Ohne das Recht, das Verbrauchsmaterial zu sehen, fehlt die Kachel für knappes Material: erwartete Rückgaben, Audits, geplante Wartungsenden, ablaufende Garantien und Lizenzen. Nur lesend.

Szenen-Auslöser

• Garantie läuft ab: die Garantie eines Assets erreicht das eingestellte Fenster. Einmal pro Asset und Enddatum. Variablen: Asset, Inventarnummer, Modell, Enddatum, verbleibende Tage.
• Lizenz läuft ab: eine Lizenz erreicht das eingestellte Fenster. Einmal pro Lizenz und Datum. Variablen: Lizenz, Plätze, Ablaufdatum, verbleibende Tage.
• Verbrauchsmaterial unter Minimum: ein Verbrauchsmaterial fällt auf oder unter seine Mindestmenge. Erneut gemeldet, nachdem es darüber aufgefüllt wurde. Variablen: Verbrauchsmaterial, verbleibend, Minimum.
• Rückgabe überfällig: ein verliehenes Asset überschreitet sein erwartetes Rückgabedatum. Einmal pro Ausleihe. Variablen: Asset, Inventarnummer, verliehen an, erwartete Rückgabe, Tage überfällig.

Das erste Lesen nach der Installation bleibt still: was bereits ansteht, ist am Gerät sichtbar, wird aber nicht gemeldet. Die Auslöser feuern beim ersten Lesen nach der Änderung (nach Mitternacht, im eingestellten Intervall).

Szenen-Aktionen

Fristen der Woche lesen: liest Snipe-IT und gibt Fristen (die Anzahl der Fristen der nächsten sieben Tage und des Überfälligen), Überfällig und Zusammenfassung zurück, einen Satz zum Senden oder Vorlesen, zum Beispiel „Fristen in Snipe-IT (3): Rückgabe Laptop Bob (2 Tag(e) überfällig), Lizenz Antivirus (22.10.2026), Garantie Home server (25.10.2026)."

Szenenbeispiele

• Montagsübersicht: jeden Montag um 9:00 → „Fristen der Woche lesen" → nur weiter, wenn die Anzahl der Fristen über 0 liegt → die Zusammenfassung als Nachricht senden.
• Ausleih-Erinnerung: Auslöser „Rückgabe überfällig" → Nachricht „{{triggerEvent.data.asset}} sollte am {{triggerEvent.data.expected}} von {{triggerEvent.data.assigned_to}} zurück sein".
• Einkaufsliste: Auslöser „Verbrauchsmaterial unter Minimum" → Nachricht „Nur noch {{triggerEvent.data.remaining}} {{triggerEvent.data.consumable}}".

Fehlerbehebung

• „Token abgelehnt": das Token wurde widerrufen, ist abgelaufen oder wurde nicht vollständig eingefügt. Erstelle ein neues.
• „Der Benutzer dieses Tokens darf die Assets nicht sehen": gib dem Benutzer in Snipe-IT das Recht „Anzeigen" für Assets und prüfe, ob er aktiviert ist.
• „Snipe-IT antwortet nicht": prüfe die Adresse vom Gladys-Rechner aus. Der Container nutzt ein Bridge-Netzwerk: localhost ist der Container selbst, gib stattdessen die IP-Adresse des Servers ein.
• „Diese Adresse antwortet nicht wie Snipe-IT": eine Anmeldeseite eines Proxys antwortet stattdessen, oder die Adresse ist nicht die von Snipe-IT (prüfe APP_URL und den Pfad hinter einem Reverse-Proxy).
• Für mehr Details in den Protokollen der Integration setze LOG_LEVEL=debug.

Grenzen

• Nur lesend: die Integration ändert dein Inventar nie.
• Jedes Lesen sind mindestens vier Anfragen (Assets, Lizenzen, Verbrauchsmaterial, Wartungen, 500 Zeilen pro Anfrage), weit unter dem Limit der Snipe-IT-API (standardmäßig 120 Anfragen pro Minute).
• Ein Snipe-IT-Server pro Integration. Komponenten und Zubehör werden nicht verfolgt.
• Nicht mit Grokability oder dem Snipe-IT-Projekt verbunden.

Konfigurationseinstellungen

Diese Einstellungen fragt Snipe-IT in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
Snipe-IT verbinden	section	Nein	Gib die Adresse deines Snipe-IT-Servers und ein persönliches API-Token ein: Öffne in Snipe-IT das Menü deines Profils, API-Schlüssel verwalten, dann Neues Token erstellen. Der Benutzer des Tokens muss Assets sehen dürfen, wenn möglich auch Lizenzen, Verbrauchsmaterial und Wartungen. Die Integration liest dein Inventar nur.
Snipe-IT-Adresse	string	Ja
API-Token	secret	Ja
Garantie läuft ab in (Tagen)	number	Nein	So viele Tage vor ihrem Ende gilt eine Garantie als bald ablaufend.
Lizenz läuft ab in (Tagen)	number	Nein
Snipe-IT lesen alle	select	Nein
Sprache der Namen und Meldungen	select	Nein	Die Namen der Funktionen werden beim Hinzufügen des Geräts zu Gladys festgelegt.

So installierst du Snipe-IT in Gladys

1. Öffne in Gladys Integrationen: Snipe-IT erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-snipeit:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-snipeit.

Snipe-IT benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen

Snipe-IT ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

• Alle Integrationen durchsuchen, native und aus der Community
• Deine eigene externe Integration bauen und veröffentlichen
• Quellcode auf GitHub — Quelle dieser Dokumentation

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂