# microtech Basis Konfiguration

> **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:

- [Automatische NetBird-Anbindung & Server-Enrollment](/knowledge/docs/base/microtech-netbird-setup.md) (Empfohlen für On-Premises)
- [microtech-Verbindung im Portal einrichten](/knowledge/docs/base/microtech-portal-config.md) (Einstellungen › Integrationen › microtech)

---

## 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](/knowledge/docs/base/microtech-netbird-setup.md) | 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](/knowledge/docs/base/microtech-portal-config.md).

---

## 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](https://docs.mbcom.cloud/changelog#systemanforderungen)
- 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.
>
> - `baseUrl` siehe [URLs](#6-urls)
> - `clientId` siehe [Anwendung anlegen](#5-anwendung-anlegen)
> - `clientSecret` siehe [Anwendung anlegen](#5-anwendung-anlegen)
> - abweichender `HTTP/2 Port`, falls nicht `443`, siehe [HTTP/2 vorbereiten](#2-http2-vorbereiten)


### 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](/knowledge/docs/base/microtech-netbird-setup.md)).
- 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](https://hilfe.microtech.de/18_graphql/oauthapidoku/#15-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**
>
> - **Für On-Premises-Installationen (Empfohlen):** Binden Sie Ihren Server ohne Firewall-Portweiterleitungen an:
>   [**Automatische NetBird-Anbindung**](/knowledge/docs/base/microtech-netbird-setup.md)
> - **Bei manueller HTTPS-Anbindung:** Fahren Sie direkt mit der Mandantenkonfiguration im Portal fort:
>   [**microtech-Verbindung im Portal**](/knowledge/docs/base/microtech-portal-config.md)
>
> Zurück zur Übersicht: [**Basiskonfiguration Übersicht**](/knowledge/docs/base.md)
