Baustein [0·0·0] · Fundament Produkt-Infrastruktur

MATE Hub: Isolierte Integrations-Data-Plane für ERP-Konnektoren.

Der MATE Hub hinter hub.mateit.de bündelt OAuth-Broker, AES-256-GCM-Token-Vault, ClamAV-Virenscan, Hintergrund-Jobs und Paket-Store in einer strikt getrennten Infrastruktur. Ihr ERP bleibt die führende Datenquelle – ohne verstreute API-Schlüssel oder ungeprüfte Einzel-Skripte.

Transport, kein ArchivIn-Transit-Verarbeitung & Auto-Purge
AES-256-GCM & ClamAVEnvelope-Vault & Fail-Closed-Scan
Odoo 19 & 20 ReadyThin Clients & Paket-Store /v1/modules
hub.mateit.de · Data-Plane-Architektur EU-Hosting
MATE Hub · Isolierte Data Plane TLS 1.2+ / RLS No-Archive ERP THIN CLIENT Odoo 19 / 20 GoBD im ERP EXTF & Export-Log 1 Instanz-Key mh_... / Bridge-Key Multi-Company X-Odoo-Company-Ref Keine OAuth-Secrets DATA PLANE · HUB.MATEIT.DE Services & Sicherheit OAuth-Broker 1 Redirect-URI Auto-Refresh Token-Vault AES-256-GCM KEK getrennt ClamAV Scan Fail-Closed EXTF & PDFs Celery Worker Retry-After Audit-Log Paket-Store /v1/modules Kanonische Odoo-Bundles & Releases EXTERNE APIS Partner-Dienste DATEV API EXTF & Belege ITscope / EDI Getrennte DBs Control Plane mate-core getrennt Portal & Rechte Kernprinzip: Payloads nur in Transit (Auto-Purge ≤ 30 Tage) · Append-only Audit ohne Secrets
MATE Hub Traefik-Routing · Service-DBs · Odoo 19 & 20

Warum Integrationen eine eigene Data Plane brauchen.

Direkt im ERP verdrahtete API-Zugänge erzeugen Wartungsschulden bei jedem Versionssprung und jeder Token-Rotation. Der MATE Hub zieht diese Infrastruktur-Schicht sauber aus dem ERP heraus.

Klare Trennung von Control Plane & Data Plane

Kundenportal, Lizenzen, Abonnements und Entitlements laufen getrennt in der Control Plane. Der MATE Hub verantwortet ausschließlich die technische Integrationsausführung, den Paket-Store und die abgesicherte API-Kommunikation nach außen.

Serverseitiger OAuth/OIDC-Broker

Statt pro Kunden-Domain einzelne OAuth-Apps bei externen Anbietern zu registrieren, stellt der Hub eine zentrale, geprüfte Redirect-URI bereit. Ein proaktiver Refresh-Daemon hält Verbindungen stabil und widerruft Tokens bei Bedarf sauber.

AES-256-GCM-Vault mit Envelope-Encryption

Refresh-Tokens und sensible Verbindungsdaten werden pro Mandant mit Envelope-Encryption (DEK pro Tenant, KEK getrennt im Vault) verschlüsselt. Es existiert kein Lese-Endpunkt nach außen: Tokens verlassen den Vault ausschließlich intern zum API-Gateway.

ClamAV-Virenscan (fail-closed) vor Weitergabe

Jede ausgehende Datei – etwa EXTF-Buchungsstapel oder PDF-Belegbilder Richtung DATEV – durchläuft im Hub automatisch einen ClamAV-Scan. Ist der Scanner nicht erreichbar, blockiert das System fail-closed und wiederholt den Job erst nach erfolgreicher Prüfung.

Celery-Job-Orchestrierung & Append-only Audit

Asynchrone Übertragungen reagieren sauber auf Rate-Limits und Retry-After-Vorgaben externer APIs. Jede Aktion erzeugt einen unveränderlichen Audit-Eintrag mit Request-Korrelation – strikt ohne Passwörter, Tokens oder Nutzdaten in den Protokollen.

Paket-Store & kanonische Odoo-Thin-Clients

Über den Endpunkt /v1/modules liefert der Hub versionierte Odoo-Client-Bundles für Odoo 19 und Odoo 20 aus. Die Module im ERP bleiben schlank, updatefähig und benötigen lediglich einen rotierbaren Instanz- oder Bridge-Key.

Vertrauensgrenzen, Datenschutz und bewusste Abgrenzung.

Plan vor Code gilt gerade für Infrastruktur: Bevor ein Mandant produktiv schaltet, sind Datenhoheit, Löschfristen und Betriebsverantwortung schriftlich geklärt.

Wann es passt & Voraussetzungen

Der MATE Hub ist das technische Fundament für Unternehmen, die produktive MATE-Schnittstellen wie DATEV in Odoo 19 oder Odoo 20 sicher, mandantengetrennt und ohne eigene OAuth-App-Pflege betreiben möchten.

  • Saubere Datenhoheit im ERP: EXTF-Erzeugung, Kontenrahmen, GoBD-Exportprotokolle und Belegarchive bleiben vollständig in Ihrer ERP-Datenbank.
  • Getrennte Service-Datenbanken: Jeder Konnektor-Service läuft mit eigener Datenbank, eigenem Vault-Namespace und Row Level Security (tenant_id) – ohne gemeinsame Tabellen zwischen DATEV und anderen Apps.
  • Einzelmandant oder Multi-Company: Jedes Unternehmen erhält einen rotierbaren Instanz-Key (mh_...) oder arbeitet bei mehreren Gesellschaften in einer Datenbank über einen Bridge-Key mit expliziter Firmenkennung.
  • Vertraglicher Rahmen: Auftragsverarbeitungsvertrag (Art. 28 DSGVO), dokumentierte TOMs, EU-Hosting und definierte Offboarding-Löschung (Vault- und Payload-Purge).

Grenzen & bewusste Einordnung

Der MATE Hub ersetzt weder Ihr ERP noch ein Revisionsarchiv – er löst gezielt das Betriebs- und Sicherheitsproblem zwischen ERP und externen Partner-APIs.

  • Kein zweites Buchhaltungs- oder Dokumentenarchiv: Nutzdaten liegen nur verschlüsselt in Transit und werden nach bestätigter Zustellung innerhalb der vereinbarten Retention (maximal 30 Tage) automatisch gelöscht.
  • Kein allgemeiner No-Code-Bastelkasten: Der Hub ist kein Ersatz für generische Automatisierungstools, sondern eine strikt typisierte, geprüfte Plattform für kritische Geschäftsbelege.
  • Kein ungeprüftes KI-Training: Übertragene Finanz- oder Belegdaten werden niemals über Mandantengrenzen geteilt oder für KI-Training verwendet.
  • Eigenbetrieb bei eigener App-Registrierung: Betreiber mit eigener produktiver App-Registrierung im jeweiligen Partner-Portal können den Direktmodus im Client weiterhin nutzen.

Häufige Fragen zum MATE Hub.

Antworten zur Architektur, Mandantentrennung und Datenhaltung hinter hub.mateit.de.

Speichert der MATE Hub unsere Buchhaltungs- oder ERP-Daten dauerhaft?

Nein. Der MATE Hub arbeitet nach dem Prinzip Transport statt Archiv. Nutzdaten wie DATEV-Buchungsstapel oder Belegbilder werden ausschließlich verschlüsselt in Transit verarbeitet und nach bestätigter Zustellung gemäß kurzer Retention automatisch gelöscht. Die GoBD-relevante Datenhaltung und Exportprotokolle bleiben vollständig in Ihrem ERP.

Warum laufen OAuth-Tokens und API-Aufrufe über den Hub statt direkt im Odoo-Modul?

Weil externe OAuth-Integrationen wie DATEV sonst für jede Kundeninstanz eine eigene App-Registrierung, eigene Callback-URLs und lokale Client-Secrets im ERP erfordern würden. Über den MATE Hub bleiben Refresh-Tokens im AES-256-GCM-Vault gekapselt, während das Odoo-Modul als schlanker Client lediglich mit einem rotierbaren Instanz- oder Bridge-Key kommuniziert.

Wie sind Mandanten und unterschiedliche Integrations-Services voneinander getrennt?

Jeder Integrations-Service nutzt eine eigene Datenbank, eigene Vault-Namespaces und getrennte Deployments. Innerhalb eines Services greift strikte Mandanten-Isolation per tenant_id und Row Level Security. Es gibt keine geteilten Schemata zwischen DATEV und anderen Konnektoren und keine Secrets oder Nutzdaten in Protokollen.

Welche Odoo-Versionen und Zugangswege unterstützt der MATE Hub?

Die kanonischen Odoo-Clients des MATE Hub unterstützen Odoo 19 und Odoo 20. Für Einzelmandanten kommt ein firmenspezifischer Instanz-Key zum Einsatz; bei Multi-Company-Datenbanken trennt entweder ein eigener Schlüssel je Unternehmen oder ein mandantenübergreifender Bridge-Key die Firmen sauber über X-Odoo-Company-Ref.

Kann der MATE Hub auch im Zusammenspiel mit bestehenden Systemen außerhalb von Odoo genutzt werden?

Die Data-Plane ist API-basiert aufgebaut und trennt Control Plane, Paket-Store und einzelne Konnektor-Services sauber voneinander. Aktuell stehen die kanonischen Clients für Odoo 19 und 20 produktiv im Mittelpunkt; ob eine Anbindung an weitere ERP- oder Bestandssysteme über den Hub sinnvoll ist, prüfen wir gemeinsam im Architekturgespräch.

Ein echter Vorgang genügt.

Sie planen eine abgesicherte DATEV- oder ERP-Integration auf Odoo 19/20 und möchten Mandantentrennung, Schlüsselverwaltung und AVV vorab sauber prüfen? Schildern Sie uns kurz Ihre Systemumgebung.

Matthias GrdanGeschäftsführung · Prozess- & ERP-Architektur
Architektur- & IntegrationsteamFeste Projektleitung · Villingen-Schwenningen

Das Erstgespräch ist kostenlos. Ihre Anfrage wird direkt über unseren Google-Workspace-Mailservice übermittelt – alternativ als vorbereiteter E-Mail-Entwurf oder per Klick in die Zwischenablage.

Bei konfiguriertem Endpunkt erfolgt die Übermittlung über unseren Google-Workspace-Mailservice; in der lokalen Vorschau entsteht ein E-Mail-Entwurf im Browser. Datenschutzhinweise

Erstgespräch anfragen