Codemeta OS 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.

Geschrieben von Erdinc Akay

Zuletzt aktualisiert Vor 26 Tagen

Codemeta OS anbinden

Codemeta OS ist eine Service-Desk- und CRM-Plattform. Wenn du sie mit octoja verbindest, kann octoja Codemeta-OS-Tickets aus Check-Alarmen erstellen, dein Geräteinventar synchron halten und Kunden importieren, damit Tickets beim richtigen Kunden landen. Die Verbindung entsteht in zwei Hälften: Du erstellst einen API-Schlüssel und liest deine Workspace-ID in Codemeta OS aus, dann gibst du beides in octoja ein und richtest die Zuordnung ein.

Voraussetzungen

Die Berechtigung Integrationsverwaltung in octoja. Administratoren weisen Berechtigungen unter Administration → Gruppen zu.
Ein Codemeta-OS-Konto mit Administratorzugriff — ausreichend, um in der API-Konsole einen Schlüssel zu erstellen und die Workspace-ID auszulesen.
Für eine selbst gehostete Codemeta-OS-Instanz: die API-Basis-URL dieser Instanz. Der Cloud-Dienst unter https://os.codemeta.de/api/v1 ist die Voreinstellung und benötigt keine Anpassung.

Schritt 1 — API-Schlüssel in Codemeta OS erstellen

Öffne in Codemeta OS die API-Konsole und klicke auf Neuen Schlüssel erstellen.

Die API-Konsole von Codemeta OS mit den Tabs Schlüssel, Aktivität und Playground, dem Abschnitt API-Schlüssel und der grünen Schaltfläche „Neuen Schlüssel erstellen" oben rechts.

Vergib eine Bezeichnung (zum Beispiel octoja RMM), damit du den Schlüssel später wiedererkennst.
Wähle die Umgebung Live für den Produktiveinsatz.
Aktiviere die HTTP-Methoden GET, POST, PATCH und PUT. octoja liest und schreibt Daten — reiner Lesezugriff (GET) reicht nicht aus.
Wähle die nötigen Berechtigungen. Empfohlen sind die Bereiche für Geräte-Templates, Assets/CMDB, Standorte, Nachrichten, CRM/Kontakte, RMM-Geräte, RMM-Geräteinventar, Ticket-Typen und Tickets — alles, was octoja beim Synchronisieren von Geräten, beim Importieren von Kunden und beim Erstellen von Tickets benötigt.
Klicke auf Schlüssel erstellen.

Der Dialog „Neuen API-Key erstellen" in Codemeta OS — ein Feld Bezeichnung mit „octoja RMM", die ausgewählte Umgebung Live, die aktivierten HTTP-Methoden GET/POST/PATCH/PUT und ein Berechtigungen-Auswahlbereich.

Codemeta OS zeigt das Token nur einmal an. Klicke auf Token kopieren und bewahre es sicher auf — in einem Passwort-Manager oder Secret-Store. In Schritt 3 fügst du es in octoja ein. Geht es verloren, lässt es sich nicht erneut anzeigen; erstelle in dem Fall einen neuen Schlüssel.

Die Bestätigung „Schlüssel wurde erstellt" in Codemeta OS mit dem einmalig angezeigten Token in einem grünen Feld, der Schaltfläche „Token kopieren", einem curl-Beispiel und einer Bestätigungs-Checkbox.

Schritt 2 — Tenant-ID (Workspace-ID) herausfinden

octoja identifiziert deinen Codemeta-OS-Mandanten über die Workspace-ID.

Klappe unten links in Codemeta OS das Benutzermenü aus und klicke auf Profil.

Das ausgeklappte Benutzermenü in Codemeta OS mit Status setzen, Profil (hervorgehoben), Verwaltung und Abmelden über dem angemeldeten Administrator-Konto.

Öffne in den Einstellungen den Tab Workspaces. Jede Workspace-Karte zeigt eine Workspace-ID. Kopiere die ID des aktiven Workspace — das ist die Tenant-ID, die du in octoja einträgst.

Die Einstellungen-Seite von Codemeta OS auf dem Tab Workspaces mit dem aktiven Workspace „octoja DEMO", dessen Rolle, Registrierungsdatum und der Workspace-ID, die als Tenant-ID dient.

Schritt 3 — Verbindung in octoja einrichten

Gehe in octoja zu Administration → Integrationen und öffne Codemeta OS.
Fülle im Dialog Codemeta OS einrichten aus:

Feld	Eingabe
API-Token	Das in Schritt 1 kopierte Token
Tenant-ID	Die Workspace-ID aus Schritt 2
Basis-URL (optional)	Nur für eine selbst gehostete Codemeta-OS-Instanz. Leer lassen, um den Cloud-Dienst zu nutzen

Klicke auf Verbindung testen, um die Zugangsdaten zu prüfen, und anschließend auf Verbinden, um die Verbindung zu speichern.

Der Dialog „Codemeta OS einrichten" in octoja mit einem Feld API-Token, einem Feld Tenant-ID, einem optionalen Feld Basis-URL für selbst gehostete Instanzen sowie den Schaltflächen „Verbindung testen" und „Verbinden".

Schritt 4 — Integration konfigurieren

Nach dem Verbinden öffnet sich der Tab Konfiguration. Arbeite die drei Abschnitte durch und speichere anschließend.

Kundenzuordnung — ordne deine octoja-Kunden und -Standorte den Gegenstücken in Codemeta OS zu, damit Tickets beim richtigen Kunden landen. Nutze Kunden zuordnen und Standorte zuordnen oder lass octoja über das Zauberstab-Symbol automatisch zuordnen.
Ticket-Zuordnung — wähle den Ticket-Typ für Codemeta-OS-Tickets sowie die Prioritäten, die octoja bei Warnung und Kritisch verwendet.
Geräte-Synchronisierung — ordne jeden octoja-Gerätetyp (Windows Server, Windows Workstation, Linux Server, Linux Desktop, macOS) einem Codemeta-OS-Asset-Typ zu. octoja gleicht Geräte über den Hostnamen pro Kunde/Standort ab, legt fehlende Geräte an und lässt vorhandene unverändert. Aktiviere Geräte stündlich automatisch synchronisieren für eine stündliche Synchronisierung.

Klicke auf Einstellungen speichern, um die Konfiguration zu übernehmen.

Die Codemeta-OS-Integrationsseite in octoja auf dem Tab Konfiguration mit den Abschnitten Kundenzuordnung, Ticket-Zuordnung (Ticket-Typ und Prioritäten) und Geräte-Synchronisierung (Zuordnung der Gerätetypen und Schalter für stündliche Synchronisierung).

Aktivität nachverfolgen

Der Tab Historie listet unter Zuletzt zugestellt jeden Ticket-Erstellungs- und Wiederherstellungsversuch auf, den octoja an Codemeta OS sendet — so kannst du Zustellungen bestätigen und Fehler eingrenzen.

Die Codemeta-OS-Integrationsseite in octoja auf dem Tab Historie mit dem Zustell-Protokoll „Zuletzt zugestellt", das jeden Ticket-Erstellungs- und Wiederherstellungsversuch festhält.

Das steht jetzt zur Verfügung

Kunden importieren aus Codemeta OS nach octoja.
Codemeta-OS-Tickets erstellen — automatisch aus octoja-Check-Alarmen.
Zeiten erfassen aus Fernwartungs-Sitzungen oder Remote-Aktionen und einem Codemeta-OS-Ticket zuordnen.
Geräte anlegen in Codemeta OS aus octoja heraus.

Tipps

Beschränke den API-Schlüssel auf die oben genannten Berechtigungen — nicht mehr. Du kannst ihn jederzeit in der Codemeta-OS-API-Konsole erneuern und das neue Token in octoja eintragen.
Die Geräte-Synchronisierung gleicht über den Hostnamen pro Kunde/Standort ab. Stelle zuerst die Kundenzuordnung korrekt ein, sonst werden Geräte dem falschen Kunden zugeordnet.
Vorhandene Codemeta-OS-Geräte werden nie überschrieben — die Synchronisierung legt nur fehlende Geräte an.