Zum Inhalt springen
microtech Komponente im Portal konfigurieren
Administration

microtech Komponente im Portal konfigurieren

Zuletzt geändert am 18.11.2026

Auf dieser Seite

title: microtech Komponente im Portal konfigurieren description: Die microtech-Verbindung eines Mandanten im ConnectCLOUD Portal einrichten: Basis-URL, Mandant, Zugangsdaten, Verbindungstest und NetBird. keywords: [microtech, Mandantenkonfiguration, Portal, GraphQL, OAuth2, NetBird, Mandant, BpConfig, Integrationen]

Zielgruppe & Rolle

Rolle: Mandanten-Administrator / IT-Admin | Voraussetzung: microtech ERP Basis-Anbindung vorhanden (immer 1. Schritt der Mandantenkonfiguration)

Unterstützung durch MBCOM

Auf Wunsch kann die vollständige Einrichtung der microtech-Konfiguration im Portal durch MBCOM übernommen werden.

Die microtech-Verbindung verbindet Ihren Mandanten mit Ihrer microtech-Instanz über die GraphQL-API. Sie ist die Grundlage für alle weiteren Module.

Jeder Mandant richtet seine eigene Verbindung ein, und zwar unter Einstellungen › Integrationen › microtech. Es gibt keine zentral verwalteten Server und keine Zuordnung in der Kunden-Administration mehr. Zum Ansehen genügt die Berechtigung tenant:settings:read, zum Ändern wird tenant:settings:write benötigt (Mandanten-Administratoren haben beides).


Verbindung

Im Bereich Verbindung hinterlegen Sie die Daten Ihres microtech-Servers:

Feld Beschreibung
Verbindung aktiv Nur eine aktive Verbindung wird von ConnectCloud genutzt.
Basis-URL Adresse des microtech-Servers, z. B. https://erp.ihrefirma.de/microtech/erp oder die NetBird-Adresse aus der Einrichtung. Bei einer NetBird-Einrichtung wird sie automatisch gesetzt, sobald das Zertifikat aktiviert ist.
Mandant Die microtech-Mandantennummer. Mit „Mandanten ermitteln“ liest ConnectCLOUD die Mandanten vom Server aus; ein Klick auf einen Eintrag übernimmt ihn. Nicht aktive microtech-Mandanten sind gekennzeichnet.
Client-ID Client-ID der microtech-Anwendung (siehe Basis-Konfiguration).
Client-Secret Zugehöriges Secret. Es wird verschlüsselt gespeichert und nie wieder angezeigt; bleibt das Feld unverändert, wird das gespeicherte Secret behalten. Ändert sich die Adresse des Servers, muss das Secret erneut eingegeben werden.
TLS-Zertifikat (PEM) Zertifikat des microtech-Servers für die verschlüsselte Verbindung über NetBird. Es gilt nur für NetBird-Adressen (*.netbird.cloud) und wird bei der NetBird-Einrichtung automatisch verwaltet (Anzeige des Fingerabdrucks).
Erweitert › GraphQL-URL (abweichend) Nur angeben, wenn die GraphQL-Schnittstelle nicht unter der Basis-URL und dem Mandanten erreichbar ist. Das Portal zeigt die tatsächlich verwendete GraphQL-URL an.

Klicken Sie nach Änderungen auf Speichern.


NetBird-Einrichtung

Steht Ihr microtech-Server in einem internen Netz ohne Portfreigaben, richten Sie die Anbindung im Bereich NetBird-Einrichtung derselben Seite ein. Das Portal erzeugt einen einmaligen PowerShell-Befehl, der auf dem Windows-Server NetBird installiert, das TLS-Zertifikat erzeugt und hochlädt. Läuft auf dem Server bereits ein anderes VPN, beantworten Sie die Frage „Läuft auf dem Server schon ein anderes VPN?“; ConnectCLOUD wird dann getrennt daneben eingerichtet. Nach der Ausführung bestätigen Sie mit „In microtech aktiviert“, dass das Zertifikat in microtech ausgewählt wurde.

Den vollständigen Ablauf beschreibt die Anleitung zur automatischen NetBird-Anbindung.


Verbindungstest

Bevor Sie die Verbindung aktivieren, sollten Sie den Verbindungstest durchführen. Der Test prüft:

  1. OAuth-Token: Es wird ein echtes OAuth-Token von Ihrer microtech-Instanz angefordert.
  2. GraphQL-API: Anschließend wird eine Testabfrage gegen die GraphQL-API ausgeführt.

Fehlerbehebung

Falls der Test fehlschlägt, prüfen Sie:

  • Ist die microtech-Instanz von außen bzw. über das NetBird-Netzwerk erreichbar? Stimmt die Basis-URL?
  • Stimmen Client-ID und Client-Secret mit den Werten aus der microtech-Anwendungsverwaltung überein?
  • Bei NetBird- oder selbstsignierten Zertifikaten: Ist das passende Zertifikat hinterlegt und in BpConfig.exe aktiviert?
  • Ist GraphQL im Mandanten aktiviert?
  • Hat der zugeordnete Benutzer die Berechtigung Zugriff über GraphQL erlaubt?

Details zur Einrichtung finden Sie in der Basis-Konfiguration.


Nicht mehr vorhanden

Folgende frühere Bereiche gibt es nicht mehr; ihre Aufgaben übernimmt die Seite unter Einstellungen › Integrationen › microtech:

  • der Reiter microtech in der Kunden-Administration (zentrale Server, Mandanten-Zuordnung, Hinweisbanner „Verbindung wird zentral verwaltet“),
  • die microtech-Seite der Mandanten-Administration (/admin) mit den Schaltern für Aktivierung und Indizierung,
  • die Seiten für ERP-Daten (Adressen, Artikel, Vorgänge, Projekte, Auswertungen) und die Release-Übersicht.

Bestehende zentrale Server-Einträge werden nicht übernommen; tragen Sie die Verbindung einmal je Mandant neu ein.


Abschluss der Basiskonfiguration & nächste Schritte

Die microtech-Mandantenkonfiguration schließt die Basiskonfiguration ab. Konfigurieren Sie nun die weiteren produktbezogenen Komponenten Ihres Mandanten (Reihenfolge beliebig):

Fahren Sie anschließend mit der produktbezogenen Systemkonfiguration fort oder kehren Sie zur Basiskonfiguration Übersicht zurück.

Hat das geholfen?