Erdinc Akay

Endpunkt-Dokumentation für die octoja REST API

API-Referenz

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

API-Authentifizierung

Gibt die Plattformversion zurück — keine Authentifizierung erforderlich

About-API

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

Asset-Logs-API

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

Customers-API

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

Devices-API

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

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

Fehlercodes

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

Users-API

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

Berichte-Referenz

Beginnen Sie hier - verstehen Sie, was octoja ist und wie es Ihnen helfen kann

Überblick

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

Was ist octoja RMM?

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

Erreichbarkeit & Status von octoja

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

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

Kern-RMM-Funktionen

Wie du das octoja-Community-Forum unter community.octoja.de für Fragen, Diskussionen und Erfahrungsaustausch nutzt

Community-Forum

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

Lernen Sie octoja Schritt für Schritt - beginnen Sie hier, wenn Sie neu sind

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

Stefan Steuer

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

Anleitungen

Übertragen Sie Kundendaten und andere Assets von anderen Produkten zu octoja

Migration

PowerShell-Monitoring-Scripte aus einem anderen RMM in octoja Custom Checks übersetzen — einfügen oder hochladen, übersetzen lassen, jeden Check testen und dann importieren.

Checks mit dem Check-Importer übernehmen

Kunden, Standorte und Geräte aus einem bestehenden RMM wie NinjaOne oder Datto nach octoja übernehmen — beide Systeme verbinden, Kunden spiegeln, dann den Agent ausrollen.

Von einem angebundenen Quell-RMM zu octoja migrieren

Kunden anlegen und ihre Standorte hinterlegen

Kunden

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

Standort hinzufügen

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

Kunde erstellen

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

Die Kundenübersicht

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

Verwalten Sie, wer Zugriff auf octoja hat und was er tun kann

Benutzer und Gruppen

Schritt-für-Schritt-Anleitung: Ein neues Benutzerkonto in octoja erstellen und Berechtigungen zuweisen.

Benutzer erstellen

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

Eine Gruppe erstellen

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

Berechtigungen zuweisen

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

Tag-Regeln konfigurieren

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

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

Authentifizierung

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

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

Installation und Verwaltung des octoja Überwachungsagenten auf Geräten

Agenten

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

Agent auf Windows bereitstellen

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

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

Enrollment-Tokens konfigurieren

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

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

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

Geräte

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

Geräteleistung live überwachen

Den Bildschirm eines Geräts aus der octoja-Weboberfläche ansehen und steuern — Toolbox-Panel-Anleitung für Windows-Agenten.

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

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

Das Inventar durchsuchen

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

Starte ein verwaltetes Gerät aus octoja neu, indem du den Neustart-Befehl des Betriebssystems in einer Remote-Terminal-Sitzung ausführst — oder starte einen einzelnen Dienst neu, ohne das Gerät zu rebooten.

Ein Gerät aus der Ferne neu starten

Überwache einen Switch, Router, eine Firewall, einen Drucker oder eine FRITZ!Box in octoja, ohne einen Agent zu installieren — einer deiner vorhandenen Agenten überwacht das Gerät per SNMP oder TR-064.

Ein Netzwerkgerät ohne Agent hinzufügen

Installation und Aktualisierung von Drittanbietersoftware auf verwalteten Geräten

Software-Bereitstellung

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

Software auf Geräte verteilen

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

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

Den Software-Kiosk aktivieren

Create and customise monitoring dashboards

Dashboards

Ein Überblick über das Dashboard pro Kunde in octoja — die vier KPI-Kacheln, die drei Gerätekarten (Top kritische Geräte, neue Geräte, Offline-Geräte) und der Alarmverlauf.

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

Shortcuts, Navigationstricks und Funktionen, die Ihnen helfen, schneller in octoja zu arbeiten.

Tipps & Produktivität

Favoriten, zuletzt verwendete Einträge, Hover-Karten, Ansichtswechsel und das Teilen per URL — die nützlichsten Funktionen, um Geräte, Meldungen und Kunden schneller zu finden.

Schneller durch octoja navigieren

So sammelst du octoja Asset-Logs, Agent-Log-Dateien und Browser-Logs von jedem Gerät und hängst sie über das In-App Support-Tickets-Portal an einen Support-Fall an.

Logs für einen Support-Fall sammeln

Die in octoja verfügbaren Tastenkürzel auf einen Blick – auf macOS Ctrl durch ⌘ ersetzen

Tastenkürzel

Mit Ctrl+K schnell suchen, navigieren und Aktionen in octoja ausführen

Die Befehlsleiste verwenden

Öffne die Einstellungen in deinem Profil, um die Startseite nach der Anmeldung zu wählen und festzulegen, ob Geräte in einem neuen Tab öffnen.

Profil-Einstellungen anpassen

Verbinden Sie octoja mit Tools und Diensten von Drittanbietern

Integrationen

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

Webhooks einrichten

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

Alarme an einen Microsoft-Teams-Kanal senden

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 woasi verbinden, damit Kunden-, Standort- und Geräte-Inventar stündlich an woasi gesendet wird.

Die woasi-Integration einrichten

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

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

Hudu-Anbindung einrichten

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

Bitdefender anbinden

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

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

Erstelle einen eigenen PDF-Bericht aus octoja-Widgets — KPI-Karten, Diagramme, Tabellen und Meldungen — für einen Kunden, Standort oder den gesamten Mandanten.

Berichtsvorlage erstellen

Logo und Farben auf die octoja-Weboberfläche anwenden

Branding konfigurieren

Meldungen erstellen, zuweisen, kommentieren und filtern.

Meldungen verwalten

Schritt-für-Schritt-Anleitung zum Anhängen von Alarmierungsregeln an einen Monitoring-Check in octoja, damit ein Kanal bei wiederholtem Fehlschlag benachrichtigt wird.

Alarmierung für einen Check einrichten

Erstelle in octoja einen Workflow, der auf ein neues Gerät reagiert oder nach Zeitplan läuft, und lasse Aktionen wie Skripte, Installationen, Neustarts und Tickets auf deinen Geräten ausführen.

Eine Automatisierung erstellen

Konzepte

Wie octoja Kunden, Standorte und Geräte organisiert

Kunden-, Standort- und Gerätemodell

Erfahre, wie Benutzer, Gruppen, Berechtigungen sowie Kunden- und Gerätezugriff in octoja zusammenspielen.

Benutzer, Gruppen & Berechtigungen

So funktionieren Anmeldung und Identitätsprüfung in octoja

Das Authentifizierungsmodell

Checks überwachen Gerätezustände automatisch und melden Ergebnisse an octoja. Erfahre, wie Checks, Alerts und Konfigurationspakete zusammenspielen.

Checks

Wie octoja Sprache und regionale Einstellungen verwaltet

Lokalisierungsmodell

So funktioniert die octoja REST-API und was davon zu erwarten ist

API-Designprinzipien

Überblick über die octoja-Architektur und ihre Hauptkomponenten

Systemarchitektur

Software auf verwalteten Geräten automatisch installieren und aktualisieren

Software-Deployment

Geräte über Terminal, Datei-Explorer, Dienst- und Prozessverwaltung fernsteuern