Hudu-Anbindung einrichten

octoja mit Hudu verbinden, um Kunden aus Hudu zu importieren und Geräte stündlich als Assets nach Hudu zu synchronisieren.

Hudu-Anbindung einrichten

Die Hudu-Integration verbindet octoja mit deiner Dokumentationsplattform Hudu. Sobald die Verbindung steht, kannst du deine Kunden aus Hudu importieren und deine Geräte als Assets nach Hudu synchronisieren. So taucht die von octoja verwaltete Hardware an derselben Stelle auf, an der dein Team auch den Rest seiner Dokumentation pflegt.

Was die Integration leistet

Die Verbindung läuft in beide Richtungen:

Kundenimport — octoja ordnet deine Kunden den Hudu-Companies zu. Du kannst sie von Hand zuordnen oder octoja automatisch Vorschläge machen lassen und Kunden aus Hudu übernehmen.
Gerätesynchronisierung — octoja legt für jedes von dir verwaltete Gerät ein Hudu-Asset an oder aktualisiert es. Assets werden pro Company entdoppelt (über eine gespeicherte Verknüpfung, dann die Geräte-ID, dann die Seriennummer, zuletzt den Namen), und Geräte werden in Hudu niemals gelöscht. Die Synchronisierung kann automatisch stündlich laufen.

Jede Geräteart, die octoja kennt, bekommt ihre eigene Zuordnung — Server und Arbeitsplätze ebenso wie Netzwerkgeräte, etwa Switches, Firewalls, Drucker und NAS. Jede Art verweist auf ein Hudu-Asset-Layout, das die Felder definiert, die octoja schreibt. octoja kann dir ein fertiges Layout anlegen, sodass du in Hudu nicht zuerst eines bauen musst.

Voraussetzungen

Eine aktive Hudu-Instanz (selbst gehostet oder Hudu Cloud), in der du Administrator bist.
Die Berechtigung Integrationsverwaltung in octoja, die über Gruppen unter Administration → Gruppen vergeben wird. Diese Berechtigung erlaubt es dir, externe Plattformen anzubinden und ihre Einstellungen zu ändern.
Um Kunden aus Hudu zu importieren, brauchst du zusätzlich die Berechtigung Kundenverwaltung, die genauso vergeben wird.

Schritt 1 — Einen API-Schlüssel in Hudu erstellen

octoja spricht über einen Hudu-API-Schlüssel mit Hudu. Erstelle einen im Admin-Bereich von Hudu.

Öffne in Hudu den Bereich Admin und klicke unter Account Administration auf API Keys.

Die Admin-Seitenleiste von Hudu mit aufgeklapptem Bereich Account Administration, in dem der Eintrag API Keys unter Integrations, External Apps, Hudu Bridge, Import Data und Export Data hervorgehoben ist.

Klicke auf + New API Key, vergib einen Namen wie octoja und belasse die Berechtigung auf Full access. Lass das Feld Company leer, damit der Schlüssel alle Kunden sehen kann, und lass Allowed IP Addresses leer, sofern du den Zugriff nicht per IP einschränkst. Klicke dann auf Create.

Das Hudu-Formular New API Key mit dem Namen octoja, der Berechtigung Full access, leerem Feld Company und leerem Feld Allowed IP Addresses sowie der blauen Schaltfläche Create am unteren Rand.

Hudu zeigt den Schlüssel nur einmal an. Kopiere ihn mit dem Kopier-Symbol an einen sicheren Ort — das ist die einzige Gelegenheit, den Schlüssel zu sehen.

Die Seite API Keys in Hudu nach dem Erstellen eines Schlüssels mit dem Hinweis, dass der Schlüssel jetzt kopiert werden muss, weil er danach nicht mehr angezeigt wird, darüber der Schlüsselwert und rechts ein Kopier-Symbol.

Schritt 2 — Die URL deiner Hudu-Instanz kopieren

octoja braucht außerdem die Adresse deiner Hudu-Instanz. Kopiere sie aus der Adressleiste deines Browsers — nur die Basis-Adresse (zum Beispiel https://deinefirma.huducloud.com), ohne den Pfad dahinter.

Eine Browser-Adressleiste mit einer Hudu-Instanz-URL der Form https://deinefirma.huducloud.com — der Wert, den du in octoja in das Feld Hudu URL einträgst.

Schritt 3 — Hudu in octoja verbinden

Trage nun beide Werte in octoja ein, um die Verbindung herzustellen.

Öffne in octoja Administration → Integrationen, suche die Karte Hudu und klicke auf Einrichten. Dadurch öffnet sich der Dialog Hudu einrichten.
Füge deine Hudu URL und den erstellten API-Schlüssel ein. Der Schlüssel wird sicher auf dem Server gespeichert und nie an den Browser gesendet.
Klicke auf Verbindung testen, um zu prüfen, ob octoja Hudu erreicht. Wenn Verbindung erfolgreich erscheint, klicke auf Verbinden.

Der octoja-Dialog zum Einrichten von Hudu mit ausgefülltem Feld Hudu URL, einem maskierten API-Schlüssel, der grünen Meldung „Connection successful“ und den Schaltflächen „Test connection“ und „Connect“ in der Fußzeile.

Schritt 4 — Kunden und Geräte zuordnen

Nach dem Verbinden öffnet sich die Hudu-Integrationsseite auf dem Reiter Konfiguration, auf dem du die Einrichtung abschließt.

Die Konfigurationsseite der Hudu-Integration in octoja mit dem Bereich Customer mapping und der Schaltfläche „Match customers“, dem Bereich Device mapping mit je einem Auswahlfeld pro Geräteart und der Schaltfläche „Create octoja layout“, dem Bereich Device sync mit dem Schalter „Automatically sync devices hourly“ sowie einer roten Danger Zone mit der Schaltfläche „Disconnect Hudu“.

Bereich	Was zu tun ist
Kundenzuordnung	Ordne jeden octoja-Kunden einer Hudu-Company zu, damit die Geräte beim richtigen Kunden landen. Klicke auf Kunden zuordnen, um den Dialog Hudu-Unternehmen zuordnen zu öffnen und von Hand zuzuordnen, oder wähle im Aktionsmenü dieses Dialogs Automatisch nach Name zuordnen, damit octoja Vorschläge macht. Sichere den Dialog mit Zuordnungen speichern.
Gerätezuordnung	Wähle für jede Geräteart das passende Hudu-Asset-Layout — die Liste kommt direkt aus deiner Hudu-Instanz. Arten, die du nicht zuordnest, werden bei der Synchronisierung übersprungen, und octoja befüllt nur die Felder, die das gewählte Layout tatsächlich definiert. Hast du noch kein passendes Layout, klicke auf octoja-Layout erstellen (siehe Schritt 5).
Gerätesynchronisierung	Aktiviere Geräte stündlich automatisch synchronisieren, damit Hudu von selbst aktuell bleibt. octoja legt pro Gerät genau ein Asset an oder aktualisiert es und löscht in Hudu niemals Assets. Die Zeile unter dem Schalter zeigt dir, wann zuletzt synchronisiert wurde.

Klicke oben auf der Seite auf Einstellungen speichern, wenn du fertig bist.

Schritt 5 — Das octoja-Geräte-Layout in Hudu erstellen

Ein Klick auf octoja-Layout erstellen legt in Hudu ein fertiges Asset-Layout mit dem Namen octoja Device an, sodass du die Felder nicht selbst definieren musst. Es enthält die Felder, die octoja bei der Synchronisierung befüllt.

Das Asset-Layout „octoja Device“ in Hudu mit acht Feldern — Hostname, Primary IP, MAC Address, Serial Number, Operating System, octoja Device ID, Agent Version — und einem Datumsfeld Last Seen.

Wähle zurück in der Gerätezuordnung dieses octoja Device-Layout für die Gerätearten aus, die du synchronisieren möchtest.

Kunden aus Hudu importieren

Beim Import werden Hudu-Companies als octoja-Kunden übernommen und die Kundenzuordnung gleich mit angelegt. Der Import läuft über die Kundenliste, nicht über die Integrationsseite.

Öffne Kunden und klicke auf die Schaltfläche Aktionen (die drei Punkte neben Kunde hinzufügen).
Wähle Aus Hudu importieren. Der Eintrag ist vorhanden, sobald Hudu verbunden ist.
Suche die gewünschten Unternehmen, hake sie an und bestätige mit … Kunden importieren. Companies, die bereits einem octoja-Kunden zugeordnet sind, tragen den Hinweis Bereits importiert.

Die Gerätesynchronisierung im Blick behalten

Ist Geräte stündlich automatisch synchronisieren eingeschaltet, überträgt octoja deine Geräte von selbst einmal pro Stunde als Assets nach Hudu.

Wie diese Läufe gelaufen sind, siehst du auf der Hudu-Integrationsseite im Reiter Historie. Dort stehen die letzten Synchronisierungsversuche mit ihrem Ergebnis; klappe eine Zeile auf, um zu sehen, was octoja gesendet und was Hudu geantwortet hat.

Verbindung trennen

Um die Verbindung zu entfernen, öffne die Hudu-Integrationsseite und nutze in der Gefahrenzone die Schaltfläche Hudu trennen. Deine Kundenzuordnungen und Einstellungen bleiben erhalten, sodass du dich später ohne erneute Zuordnung wieder verbinden kannst. Bereits in Hudu angelegte Assets bleiben in Hudu.

Tipps

Bewahre den API-Schlüssel sicher auf — Hudu zeigt ihn nur einmal an. Hast du ihn verloren, erstelle in Hudu einen neuen Schlüssel und trage ihn erneut unter Einrichten ein.
Trage nur die Basis-URL von Hudu ein (ohne Pfad am Ende). Schlägt der Verbindungstest fehl, zeigt octoja den Grund an, den Hudu zurückmeldet — meist eine falsche Adresse oder ein Schlüssel, der nicht mehr aktiv ist.
Gerätearten, die du nicht zuordnest, werden übersprungen — du kannst zum Beispiel nur Server synchronisieren und Arbeitsplätze auslassen.
Die stündliche Synchronisierung löscht in Hudu niemals Assets. Wenn du ein Gerät in octoja entfernst, wird sein Hudu-Asset nicht entfernt; räume solche Assets bei Bedarf direkt in Hudu auf.
Wie du weitere Dokumentations- oder Alarmierungswerkzeuge anbindest, findest du im übrigen Bereich Integrationen.