Zum Inhalt springen
Administration
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 kundenweiter CUSTOMER_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 des groups-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?