Dokumentation › Administration
Zentrales technisches und organisatorisches Fundament für ConnectCLOUD - Kunden-Onboarding, Administration, OIDC Single Sign-On, Berechtigungskonzept und microtech ERP-Anbindung.
Zuletzt geändert am 18.11.2026
Auf dieser Seite
Zielgruppe & Rolle
Rolle: IT-Administrator (Kunde / MBCOM), IT-Consultant | Voraussetzung: Einladung zur Ersteinrichtung oder administrativer Portal-Zugriff
Basiskonfiguration
Die Basiskonfiguration bildet das organisatorische, sicherheitstechnische und netzwerkseitige Fundament für die gesamte ConnectCLOUD-Plattform. Sie stellt sicher, dass Kundenorganisationen, Benutzeridentitäten, Zugriffsrechte und die ERP-Konnektivität zu microtech büro+ vor der Bereitstellung einzelner Connect-Produkte (ConnectINVOICE, ConnectWORKFLOW, ConnectELO, ConnectPORTAL) standardisiert und sicher eingerichtet sind.
Architektur & Einrichtungs-Lebenszyklus
Die Basiskonfiguration gliedert sich in drei aufeinander aufbauende Säulen, die den Lebenszyklus von der initialen Freischaltung bis zur produktionsreifen Mandantenaktivierung abbilden:
graph TD
subgraph "1. Konto & Organisation"
Onboarding["Kunden-Onboarding<br/>(Einladung & Wizard)"]
Admin["Kunden-Administration<br/>(Stammdaten & Recovery)"]
end
subgraph "2. Identität & Zugriff"
OIDC["Zugriff & Authentifizierung<br/>(Entra ID / OIDC SSO)"]
RBAC["Berechtigungskonzept<br/>(Rollen & Gruppen-Mapping)"]
end
subgraph "3. microtech ERP-Anbindung"
ERPBase["microtech Basis-Konfiguration<br/>(GraphQL & HTTP/2)"]
NetBird["NetBird Anbindung<br/>(WireGuard & Auto-TLS)"]
PortalConfig["Portal Mandantenkonfiguration<br/>(Mandanten-Zuordnung & Indizierung)"]
end
Onboarding --> OIDC
OIDC --> RBAC
RBAC --> Admin
Admin --> ERPBase
ERPBase --> NetBird
NetBird --> PortalConfig
PortalConfig --> Products["Connect-Produkte<br/>(INVOICE, WORKFLOW, PORTAL)"]
Die drei Säulen der Basiskonfiguration
1. Konto & Organisation
Die organisatorische Ebene umfasst die initiale Mandanten-Provisionierung, Stammdatenverwaltung sowie Notfall- und Wiederherstellungsmechanismen für Kunden-Administratoren.
- Kunden-Administration:
Zentraler Verwaltungsbereich (
/customer-admin) für kundenweit gültige Einstellungen. Ermöglicht die Pflege von allgemeinen Unternehmensstammdaten, Benachrichtigungsverteilern, verifizierten Notfall-Wiederherstellungsadressen (Recovery Contacts), Einmal-Wiederherstellungscodes (2FA-Besitzfaktor) sowie die Zuweisung kundenweiterCUSTOMER_ADMIN-Rechte mit automatischer Step-Up-Re-Authentifizierung.
2. Identität & Zugriff
Die Sicherheitsebene regelt die zentrale Authentifizierung via Enterprise Single Sign-On (SSO) und die feingranulare Autorisierung über Rollen und Gruppen.
-
Zugriff & Authentifizierung (OIDC / SSO): Standardisierte Anbindung an OpenID Connect (OIDC) Identity Provider wie Microsoft Entra ID (Azure AD). Detaillierte Schritt-für-Schritt-Anleitung zur App-Registrierung, Web Redirect URIs, Generierung von Client Secrets (Value vs. Secret ID), Microsoft Graph API-Berechtigungen (
openid,profile,email,User.Read,GroupMember.Read.All), Administratorzustimmung (Admin Consent) und Token-Konfiguration desgroups-Claims. -
Berechtigungskonzept & Rollenmodell: Mandantenbezogene Zugriffskontrolle und rollenbasierte Berechtigungssteuerung (RBAC). Dokumentiert das Zusammenspiel zwischen Pre-Login Domain-Routing (
customers/login-domains.json), E-Mail-Regex-Prüfungen (allowedEmailRegex), den Rollenhierarchien (CUSTOMER_ADMIN,TENANT_ADMIN,TENANT_ADMIN_VIEWER,TENANT_DATA_VIEWER,TENANT_VIEWER) und dem flexiblen IdP-Gruppen-Mapping je Mandant.
3. ERP- & Netzwerkanbindung (microtech)
Die Integrationsebene stellt die verschlüsselte Echtzeit-Kommunikation zwischen den ConnectCLOUD-Diensten und dem On-Premises- oder Cloud-basierten ERP-System her.
-
microtech Basis-Konfiguration: Grundlegende Bereitstellung der microtech GraphQL API und HTTP/2-Schnittstelle in
BpConfig.exe. Beschreibt die Anlage vertraulicher OAuth2-Clientanwendungen, Vergabe von Supervisor-Rechten für den API-Benutzer (ConnectCLOUD), Standard-URL-Schemata sowie Anforderungen an das microtech Dokumentenmanagement (DMS). -
Automatische NetBird-Anbindung (Auto-TLS & VPN): Sichere On-Premises-Anbindung ohne eingehende Firewall-Portweiterleitungen oder feste öffentliche IP-Adressen über ein verschlüsseltes WireGuard-Overlay-Netzwerk. Beinhaltet das zeitlich begrenzte Server-Enrollment (60 Min. Gültigkeit), das Einzeiler-PowerShell-Bootstrap-Skript, automatische ECDSA P-256 TLS-Zertifikatserstellung, unterbrechungsfreie Zertifikatsrotation (Dual-Trust) und feste FQDN-Endpunkte.
-
microtech Mandantenkonfiguration im Portal: Die microtech-Verbindung Ihres Mandanten unter Einstellungen › Integrationen › microtech: Basis-URL, Mandant (auf Wunsch vom Server ermittelt), Client-ID und Client-Secret, TLS-Zertifikat, Live-Verbindungstest (OAuth2-Token & GraphQL-Query) sowie die NetBird-Einrichtung auf derselben Seite.
Schrittweise Einrichtungs-Roadmap
Für eine strukturierte und fehlerfreie Bereitstellung empfiehlt sich die Umsetzung in der folgenden Reihenfolge:
| Phase | Schritt | Thema | Dokumentation | Ziel & Ergebnis |
|---|---|---|---|---|
| 1. Organisation | 1.1 | Kunden-Administration | Kunden-Administration | Notfallkontakte verifizieren, Recovery-Codes sichern, Benachrichtigungsverteiler pflegen. |
| 2. Identität | 2.1 | IdP & Single Sign-On | Zugriff & Authentifizierung | Entra ID App-Registration, Secret, Graph-Rechte und Gruppen-Claim einrichten. |
| 2.2 | Rollen & Berechtigungen | Berechtigungskonzept | E-Mail-Routing-Domains (allowedEmailRegex) und IdP-Gruppen-Mappings je Mandant definieren. |
|
| 3. ERP-Anbindung | 3.1 | microtech Vorbereitung | microtech Basis-Konfiguration | HTTP/2, OAuth2-Client und GraphQL-Zugriff in BpConfig.exe und büro+ konfigurieren. |
| 3.2 | NetBird Overlay VPN | Automatische NetBird-Anbindung | Einzeiler-PowerShell-Bootstrap ausführen (auch neben einem bestehenden VPN), WireGuard-Peer koppeln und Auto-TLS aktivieren. | |
| 3.3 | Verbindung im Portal | microtech konfigurieren | Verbindung unter Einstellungen › Integrationen › microtech eintragen, Mandanten ermitteln, Verbindungstest durchführen und Verbindung aktivieren. |
Nächste Schritte: Ersteinrichtung starten
Neue Kunden und Mandanten legt MBCOM in den Stammdaten an. Starten Sie die Ersteinrichtung mit der Kunden-Administration.
Nach erfolgreichem Abschluss der Basiskonfiguration und ERP-Kopplung fahren Sie mit der produktbezogenen Systemkonfiguration für ConnectINVOICE, ConnectWORKFLOW, ConnectELO oder ConnectPORTAL fort.
Hat das geholfen?
https://app.mbcom.cloud/knowledge/docs/base