Zum Inhalt springen
microtech Basis Konfiguration
Administration

microtech Basis Konfiguration

Grundlegende Anbindung von microtech büro+ über GraphQL API, HTTP/2, OAuth2 und DMS für ConnectCLOUD.

Zuletzt geändert am 18.11.2026

Auf dieser Seite

Zielgruppe & Rolle

Rolle: IT-Administrator / microtech Betreuer | Voraussetzung: microtech ERP Server mit Supervisor-Rechten

Basis Konfiguration

Die microtech-Schnittstelle bildet das Herzstück der ConnectCLOUD und ermöglicht die nahtlose Kommunikation zwischen Ihrem microtech büro+ und den verschiedenen Connect-Produkten.

Die hier beschriebene Basis-Konfiguration bildet das Fundament für alle Anbindungen an microtech. Während die GraphQL-Anbindung eine zwingende Voraussetzung für alle ConnectCloud Produkte darstellt, gibt es darüber hinaus modulspezifische microtech Anpassungen:


Anbindungswege im Überblick

Für die sichere Kommunikation zwischen ConnectCLOUD und Ihrem microtech-Server stehen zwei Wege zur Verfügung:

Kriterium Option A: Automatische NetBird-Anbindung (Empfohlen) Option B: Manuelle HTTPS-Freigabe
Geeignet für On-Premises-Installationen, interne Firmennetzwerke Server mit bestehender externer Domain / Reverse Proxy
Firewall & Ports Keine Portfreigaben erforderlich (nur ausgehend HTTPS/UDP) Eingehende Portfreigabe (Port 443 oder abweichend) nötig
Zertifikat Automatisch generiertes ECDSA-Zertifikat (inkl. unterbrechungsfreier Rotation) Öffentliches TLS-Zertifikat einer vertrauenswürdigen CA nötig
Einrichtung Einzeiler-PowerShell-Befehl aus den Integrations-Einstellungen im Portal Manuelle Konfiguration von DNS, Router, Firewall & BpConfig
Anleitung Zur NetBird-Anleitung Siehe folgende Abschnitte

Konfiguration im Portal

Die microtech-Verbindung wird je Mandant im Portal unter Einstellungen › Integrationen › microtech hinterlegt (Basis-URL, Mandant, Client-ID und Client-Secret, bei NetBird zusätzlich das Zertifikat). Dort steht auch die Einrichtung über NetBird mit dem Einzeiler-PowerShell-Befehl zur Verfügung. Eine zentrale Server-Verwaltung in der Kunden-Administration gibt es nicht mehr. Details: microtech-Verbindung im Portal.


Versionsanforderungen an microtech

Für den Einsatz von ConnectCLOUD ist eine aktuelle microtech-Version erforderlich.

  • Unterstützt werden aktuelle microtech-Versionen. Siehe Systemanforderungen im Changelog
  • Grundsätzlich ist die jeweils aktuellste stabile Version von microtech einzusetzen.
  • Bevorzugt wird die microtech-Version, mit der das jeweilige ConnectCLOUD-Produkt getestet wurde. Maßgeblich ist hierzu das jeweilige Changelog.
  • Veraltete Versionen sowie Express-Updates werden nicht unterstützt.

GraphQL-Anbindung

Checkliste der zu übermittelnden Daten

Diese Checkliste ersetzt nicht die Anleitung, sondern fasst nur die im Portal einzutragenden bzw. an MBCOM weiterzugebenden Daten im Bezug auf GraphQL zusammen.

1. Partner-App aktivieren oder Schlüssel eintragen

  • Partner-App-Schlüssel oder einen passenden Enterprise-microtech-Schlüssel eintragen.
  • Prüfen, dass unsere Partner-App danach in Anwendungen verwalten als Anwendungsart auswählbar ist.
  • Alternativ kann eine eigene App angelegt werden.

2. HTTP/2 vorbereiten

  • BpConfig.exe auf dem Server öffnen.
  • HTTP/2 aktivieren.
  • Den HTTP/2 Port festlegen: Im Standard auf 443 (bei öffentlicher Domain) bzw. auf 8443 (bei automatischer NetBird-Anbindung).
  • Firewall, Portfreigabe, Reverse Proxy und externe Erreichbarkeit müssen zum verwendeten Port passen (entfällt bei NetBird).
  • Ein gültiges Zertifikat hinterlegen:
    • NetBird-Anbindung: Das Zertifikat wird vom Bootstrap-Skript automatisch als ECDSA P-256 Zertifikat erzeugt und im Speicher Eigene Zertifikate abgelegt. Wählen Sie dieses anhand des ausgegebenen Thumbprints aus.
    • Manuelle HTTPS-Freigabe: Das Zertifikat muss als .pfx vorliegen, auf dem microtech-Server im Zertifikatsspeicher Eigene Zertifikate installiert sein und von einer öffentlich vertrauenswürdigen Stammzertifizierungsstelle stammen.
  • Das Zertifikat muss zur verwendeten Domain passen.
  • Der Server muss über diese Domain von außen per HTTPS erreichbar sein.

Hilfe: HTTPS- und Domain-Anforderungen

3. GraphQL im Mandanten aktivieren

  • In den gewünschten Mandanten wechseln.
  • Mandant bearbeiten öffnen.
  • In das Register Weitere Angaben wechseln.
  • Prüfen, ob GraphQL aktiviert bereits gesetzt ist.
  • Falls nicht, GraphQL aktiviert aktivieren.

4. Benutzer freischalten oder anlegen

  • Informationen -> Benutzer -> Benutzer verwalten öffnen.
  • Einen bestehenden Benutzer öffnen oder einen neuen Benutzer anlegen. Dieser benötigt die Berechtigung Supervisor.
  • Ein Benutzer wie ConnectCLOUD mit der Benutzernummer 301 ist sinnvoll und empfohlen, damit Änderungen leichter zugeordnet werden können.
  • In Firmenvorgaben das Kennzeichen Zugriff über GraphQL erlaubt aktivieren.

5. Anwendung anlegen

  • Meine Firma -> Überblick -> Systemeinstellungen -> Anwendungen verwalten öffnen.
  • Eine neue Anwendung anlegen.
  • Als Anwendungsart unsere Partner-App oder eigene App auswählen.
  • Den Client-Typ auf Vertraulicher Client (Confidential Client) setzen.
  • Den passenden Benutzer auswählen.
  • GraphQL-API Zugriff aktivieren.
  • Client ID und Client Secret direkt sichern, da das Client Secret später nicht erneut angezeigt wird.

6. URLs

Im Standard:

  • Base URL: https://<server.domain>/microtech/erp/mand/<MandNr>/
  • Token URL: https://<server.domain>/microtech/erp/mand/<MandNr>/token
  • GraphQL URL: https://<server.domain>/microtech/erp/mand/<MandNr>/graphql/v1
  • Anschließend baseUrl, clientId und clientSecret im Portal eintragen (oder an MBCOM übermitteln).

Manueller GraphQL-Endpunkt

Sollte bereits ein manueller GraphQL-Endpunkt eingerichtet sein, kann dieser weiterhin verwendet werden. In diesem Fall unterscheidet sich lediglich die URL-Struktur.

microtech DMS

Das microtech DMS muss vorhanden sein. Diese Voraussetzung gilt für ConnectINVOICE und ConnectELO. Ist das DMS noch nicht vorhanden, ist dies ein weiterer Umsetzungsteil vor der Anbindung von ConnectCLOUD. Für ConnectELO werden zusätzlich bestimmte DMS-Einstellungen in microtech benötigt.

Unterstützung durch MBCOM

Auf Wunsch kann die vollständige Einrichtung der ConnectCLOUD-Schnittstelle durch MBCOM übernommen werden.


Nächster Schritt in der Basiskonfiguration

Zurück zur Übersicht: Basiskonfiguration Übersicht

Hat das geholfen?