Endpunkt-Dokumentation für die octoja REST API

API-Referenz

Gibt die Plattformversion zurück — keine Authentifizierung erforderlich

About-API

Token-basierte Authentifizierung, Token-Refresh und OIDC/SSO-Login

API-Authentifizierung

Endpoints zum Abfragen von Geräte-Aktivitätsprotokolleinträgen

Asset-Logs-API

Schema, REST-Endpunkte, Widget-Katalog, Raster-Einschränkungen und Berechtigungs-Referenz für den octoja-Bereich „Berichte“.

Berichte-Referenz

Kunden auflisten, abrufen, erstellen, aktualisieren und löschen

Customers-API

Geräte auflisten, abrufen, aktualisieren und löschen

Devices-API

Referenzliste der octoja-Fehlercodes mit Erläuterungen und Schritten zur Fehlerbehebung.

Fehlercodes

Gruppen erstellen, lesen, aktualisieren und löschen über die REST-API

Groups-API

Erstelle, verwalte und kommentiere Meldungen programmatisch und erfasse Zeit dafür — mit Verweis auf die interaktive API-Referenz für die vollständige Spezifikation.

Meldungen-API

Benutzer auflisten, abrufen, erstellen, aktualisieren und löschen

Users-API

Zeiteinträge nach Zeitraum, Gerät oder Meldung filtern und seitenweise abrufen.

Zeiteinträge abrufen

Beginne hier — erfahre, was octoja ist und wie es dir helfen kann

Überblick

Erfahre, was octoja RMM ist und für wen es entwickelt wurde.

Was ist octoja RMM?

octoja ist eine Remote-Monitoring-und-Management-Plattform für IT-Dienstleister.

Kern-RMM-Funktionen

Definitionen der wichtigsten Objekte und Begriffe in octoja

Kernkonzepte

Was du auf help.octoja.de findest und wie das octoja Help Center aufgebaut ist

Help Center

Google Chrome ist der empfohlene Browser für octoja und bietet die beste Erfahrung. Andere Chromium-basierte Browser wie Microsoft Edge werden ebenfalls vollständig unterstützt.

Unterstützte Browser

Erfahre, welche octoja-Version du nutzt und wo du den Changelog findest — inklusive der Frage, in welchem Release ein abgeschlossener Feature-Request veröffentlicht wurde.

octoja-Version und Changelog finden

Vorgehen, wenn octoja nicht erreichbar ist oder eine Seite nicht lädt

Erreichbarkeit & Status von octoja

Lerne octoja Schritt für Schritt kennen — beginne hier, wenn du neu bist

Erste Schritte

Das erste Mal bei octoja anmelden und die Oberfläche kennenlernen

Schritt 1 – Erstanmeldung

Ein Unternehmen in octoja anlegen, um dessen Geräte zu überwachen

Schritt 2 – Ersten Kunden anlegen

Den octoja Agent auf einem Gerät installieren, damit es überwacht werden kann

Schritt 3 – Deinen ersten Agent bereitstellen

Einen Monitoring-Check auf einem Gerät einrichten und laufen sehen

Schritt 4 – Deinen ersten Check aktivieren

Das Home-Dashboard öffnen und nach Schweregrad, Status, Kunde und Gerätetyp filtern.

Schritt 5 – Den Status auf einen Blick prüfen

Schritt-für-Schritt-Anleitungen für bestimmte Aufgaben in octoja

Anleitungen

Kunden anlegen und ihre Standorte hinterlegen

Kunden

Wie du die Kunden-Tabelle liest, durchsuchst, sortierst und exportierst — deine zentrale Liste aller Kunden, die du in octoja verwaltest.

Die Kundenübersicht

Schritt-für-Schritt-Anleitung zum Erstellen eines neuen Kunden in octoja und zum Hinzufügen seiner Standorte.

Kunde erstellen

Lege viele octoja-Kunden auf einmal an, indem du eine CSV- oder Excel-Datei hochlädst und ihre Spalten den Kundenfeldern zuordnest.

Kunden aus CSV oder Excel importieren

Schritt-für-Schritt-Anleitung zum Hinzufügen eines neuen Standorts zu einem Kunden in octoja.

Standort hinzufügen

Installation und Verwaltung des octoja Überwachungsagenten auf Geräten

Agenten

Der octoja Agent hält sich automatisch aktuell — sieh die Agent-Version je Gerät, stoße ein Update manuell an und behebe veraltete Agents.

Agent aktualisieren

Schritt-für-Schritt-Anleitung zur Installation und Bereitstellung des octoja Agent auf Linux.

Agent auf Linux bereitstellen

Schritt-für-Schritt-Anleitung: Den octoja Agent auf macOS installieren und bereitstellen.

Agent auf macOS bereitstellen

Den octoja Agent auf einem Windows-Computer oder -Server installieren

Agent auf Windows bereitstellen

Erfahre, wo du die Installationsprotokolle des octoja Agent findest und wie du typische Windows-Installationsfehler wie 1603 löst.

Agent-Installationsprobleme unter Windows beheben

Erfahre, wie du den octoja Agent per Microsoft Intune auf viele Windows-Geräte gleichzeitig ausrollst — mit den richtigen Befehlszeilenargumenten.

Agent über Microsoft Intune bereitstellen

Erfahre, welche Ordner und Prozesse du in deinem Antivirus- oder EDR-Produkt ausschließt, damit der octoja Agent ohne Fehlalarme läuft.

Antivirus-Ausnahmen für den octoja Agent konfigurieren

Deinstalliere den octoja Agent unter Windows, macOS und Linux — und erfahre, was das Löschen eines Geräts aus dem octoja-Inventar auf dem Gerät selbst bewirkt.

Den Agent von einem Gerät entfernen

Steuere, ob das octoja-Agent-Symbol im Traybereich verwalteter Geräte erscheint — für eine Gruppe über ein Konfigurationspaket oder je Gerät überschrieben.

Den octoja-Agent im Traybereich anzeigen oder ausblenden

Neue Geräte dazu verpflichten, ein Token zu hinterlegen, bevor sie einen Agent registrieren können

Enrollment-Tokens konfigurieren

Arbeiten mit Geräten, Terminals und Live-Überwachung

Geräte

Active-Directory-Konten direkt von der Geräteseite eines Domain Controllers in octoja anlegen, deaktivieren und ihr Kennwort zurücksetzen.

Active-Directory-Benutzer auf einem Domain Controller verwalten

Mit der Inventar-Seite Software, Hardware, Dienste und Tags über alle Geräte hinweg durchsuchen, filtern und exportieren.

Das Inventar durchsuchen

Starte ein verwaltetes Gerät aus octoja neu — per Automatisierung mit dem Schritt „Gerät neu starten“, über ein Remote-Terminal oder starte einen einzelnen Dienst neu.

Ein Gerät aus der Ferne neu starten

Erfahre, wie du Synology- und QNAP-NAS-Geräte in octoja über ein Überwachungsgerät überwachst — ganz ohne Agent-Installation auf dem NAS.

Ein NAS ohne Agent überwachen (Synology & QNAP)

Überwache Switch, Router, Firewall, Drucker oder FRITZ!Box ohne Agent — ein Agent fragt es über das Netzwerk ab, von SNMP bis zu Custom-Script-Checks.

Ein Netzwerkgerät ohne Agent hinzufügen

Aktualisiere das Inventar eines Geräts bei Bedarf direkt von der Detailseite — und verstehe die Meldungen, die octoja zeigt, wenn der Scan nicht starten kann.

Eine Inventarisierung manuell starten

CPU, Arbeitsspeicher, Festplatten, Prozesse und Dienste eines verbundenen Geräts in Echtzeit anzeigen

Geräteleistung live überwachen

Verstehe, wie octoja agentenlose Netzwerkgeräte abbildet — Geräteklassen, Überwachungsgerät, Online-Status und welche Checks zu welcher Klasse passen.

Netzwerkgeräte-Referenz

Windows- und macOS-Geräte aus der octoja-Weboberfläche ansehen und steuern — Voraussetzungen, Zustimmung und Sitzungseinstellungen.

Remote-Desktop verwenden

Live-Terminal-Sitzung direkt über die octoja-Weboberfläche öffnen – ohne VPN oder separates Remotezugriff-Tool

Terminal auf einem Gerät öffnen

Einen angemeldeten Benutzer direkt am Gerät fragen und seine Auswahl oder Texteingabe in octoja lesen.

Eine Benachrichtigung mit Antwort senden

Dateien im Datei-Explorer übertragen und Ordner als ZIP-Archive auf einem Gerät bereitstellen.

Dateien übertragen und ZIP-Archive entpacken

Verwalte virtuelle Maschinen und Prüfpunkte eines Hyper-V-Hosts direkt in octoja.

Hyper-V-VMs verwalten

Standorte mit vorhandenen Agents durchsuchen und gefundene Netzwerkgeräte in die Überwachung übernehmen.

Netzwerkgeräte entdecken und überwachen

QEMU-VMs und LXC-Container eines Proxmox-VE-Hosts prüfen und Snapshots verwalten.

Proxmox-VMs und Container verwalten

Eine einmalige Windows-Fernwartung ohne Installation des vollständigen Agents starten.

Schnellsupport starten

Installation und Aktualisierung von Drittanbietersoftware auf verwalteten Geräten

Software-Bereitstellung

Aktiviere den Software-Kiosk, damit Nutzer deiner verwalteten Geräte freigegebene Software selbst über den octoja-Agent im Traybereich installieren.

Den Software-Kiosk aktivieren

Eigene Installationspakete (MSI oder EXE) als Custom Packages hochladen und über die Standard-Konfigurationspaket-Verteilung an Windows-Geräte verteilen.

Eigene Pakete erstellen und verteilen

Konfigurationsfelder, Paketmanager und Zeitplansyntax für Software-Deployments

Referenz für Software-Deployments

Software zu einem Konfigurationspaket hinzufügen, um sie automatisch auf verwalteten Geräten zu installieren

Software auf Geräte verteilen

Monitoring-Dashboards erstellen und anpassen

Dashboards

Ein Überblick über das Kundendashboard sowie Checknamen-Filter und gespeicherte Seitengrößen im Haupt-Dashboard von octoja.

Das Kundendashboard

Zeige Warnungen, kritische Störungen und Offline-Server deines Bestands auf einer Vollbild-Tafel — die TV-Ansicht öffnen, filtern und ihre Alarmtöne einrichten.

Die TV-Ansicht für den Live-Status deines Bestands einrichten

Verwalte, wer Zugriff auf octoja hat und was diese Personen tun können

Benutzer und Gruppen

Schritt-für-Schritt-Anleitung: Ein neues Benutzerkonto in octoja erstellen, per E-Mail einladen und Berechtigungen zuweisen.

Benutzer erstellen

Schritt-für-Schritt-Anleitung: Berechtigungen für Benutzer und Gruppen in octoja zuweisen.

Berechtigungen zuweisen

Schritt-für-Schritt-Anleitung: Eine neue Gruppe in octoja erstellen und Berechtigungen vergeben.

Eine Gruppe erstellen

Eine Gruppe auf bestimmte Kunden und Geräte eingrenzen und festlegen, was ihre Mitglieder tun dürfen — über die Tabs Kundenzugriff und Gerätezugriff.

Kunden- und Gerätezugriff einer Gruppe einschränken

Regeln definieren, die Geräten basierend auf ihren Eigenschaften automatisch Tags zuweisen — bei jedem Inventar-Update neu ausgewertet.

Tag-Regeln konfigurieren

Anmeldung absichern — Passwörter, Zwei-Faktor-Authentifizierung und Single Sign-On

Authentifizierung

Verknüpfe dein Microsoft-Konto und melde dich ohne separates Passwort bei octoja an

Mit Microsoft anmelden (SSO)

Ändere dein Passwort selbst über dein Profil — oder lass es von einem Administrator zurücksetzen, wenn du ausgesperrt bist

Passwort zurücksetzen

Zwei-Faktor-Authentifizierung für dein eigenes octoja-Konto einrichten, oder als Administrator für einen anderen Benutzer aktivieren oder entfernen.

Zwei-Faktor-Authentifizierung für einen Benutzer aktivieren

Verbinde octoja mit Tools und Diensten von Drittanbietern

Integrationen

Verbinde octoja mit einem Microsoft-Teams-Kanal und sende Alarmkarten über Power Automate.

Alarme an einen Microsoft-Teams-Kanal senden

Erstelle Benachrichtigungsgruppen in octoja, damit Alarme dein Team per SMS, Anruf oder App-Push erreichen, und leite eine Alarmregel darauf.

Alarme per SMS, Anruf und App-Push verschicken

octoja mit Autotask PSA verbinden: Alarme öffnen Tickets, Entwarnungen kommentieren sie und schließen nicht zugewiesene, Geräte werden Konfigurationselemente.

Autotask-PSA-Anbindung einrichten

Verbinde Bitdefender GravityZone mit octoja, um Agent-Status, isolierte Bedrohungen und EDR-Vorfälle auf jedem Gerät zu sehen.

Bitdefender anbinden

octoja mit c-entron Service-Board verbinden, damit Check-Alarme Helpdesk-Tickets öffnen und Entwarnungen sie kommentieren und schließen.

c-entron Service-Board anbinden

Codemeta OS mit octoja verbinden, um Tickets aus Check-Alarmen zu erstellen, Geräte zu synchronisieren und Kunden zu importieren — mit API-Schlüssel und Workspace-ID.

Codemeta OS anbinden

Verbinde octoja mit DocBee, damit Check-Alarme DocBee-Tickets öffnen, Entwarnungen sie kommentieren und unbearbeitete schließen und deine Geräte stündlich als Objekte nach DocBee synchronisiert werden.

Die DocBee-Integration einrichten

octoja mit TANSS verbinden, Alarmregeln auf den Kanal TANSS-Ticket leiten, damit Check-Alarme Tickets öffnen und schließen, und deine verwalteten Geräte nach TANSS synchronisieren.

Die TANSS-Integration einrichten

octoja mit woasi verbinden, damit Kunden-, Standort- und Geräte-Inventar stündlich an woasi gesendet wird.

Die woasi-Integration einrichten

Der Check ESET Security läuft auf dem Gerät und liest ESET Endpoint oder Server Security lokal aus — ohne Cloud-Zugriff, ohne Zugangsdaten, ohne Kundenzuordnung.

ESET-Schutz mit dem Check ESET Security überwachen

octoja mit Freshservice verbinden, damit Check-Alarme Tickets öffnen, Erholungen sie schließen und Geräte ins ITAM-Inventar wandern.

Freshservice anbinden

octoja mit HaloPSA verbinden, damit Check-Alarme Tickets öffnen, Entwarnungen sie kommentieren oder schließen und Geräte als Assets synchronisieren.

HaloPSA-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

octoja mit Inserve verbinden, damit Check-Alarme Tickets öffnen, Entwarnungen eine Notiz ergänzen und Geräte automatisch synchronisiert werden.

Inserve anbinden

Verbinde octoja mit IT Glue, damit deine Geräte stündlich als Konfigurationen bei der richtigen Organisation und am richtigen Standort landen.

IT-Glue-Anbindung einrichten

octoja mit Jira Service Management verbinden, damit Check-Alarme Fälle öffnen und Entwarnungen sie kommentieren und schließen.

Jira anbinden

Verbinde lywand software mit octoja, um auf jedem Gerät einen Sicherheits-Rang und eine Liste der Schwachstellen zu sehen.

lywand software einrichten

octoja mit Odoo Helpdesk verbinden, damit Check-Alarme Tickets öffnen und Entwarnungen sie kommentieren oder schließen.

Odoo anbinden

Der Check Securepoint Antivirus Pro läuft direkt auf dem Gerät und meldet GuardX-Dienst, Echtzeitschutz, Signaturalter und Bedrohungen an octoja.

Securepoint Antivirus Pro auf deinen Geräten überwachen

octoja mit TOPdesk verbinden, damit Check-Alarme Incidents erzeugen, Entwarnungen sie kommentieren oder schließen und Geräte als Assets synchronisieren.

TOPdesk-Anbindung einrichten

Empfange signierte JSON-Ereignisse von octoja an deinem eigenen HTTPS-Endpunkt.

Webhooks einrichten

Verbinde Acronis Cyber Protect Cloud mit octoja, ordne Kunden ihren Acronis-Mandanten zu und überwache den Schutzstatus deiner Geräte.