# Administration

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

```mermaid
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](/knowledge/docs/customer-administration.md)**:
  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.
  - [Zur Kunden-Administration](/knowledge/docs/customer-administration.md)

---

### 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)](/knowledge/docs/access-authentication.md)**:
  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.
  - [Zu Zugriff & Authentifizierung](/knowledge/docs/access-authentication.md)

* **[Berechtigungskonzept & Rollenmodell](/knowledge/docs/permission-concept.md)**:
  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.
  - [Zum Berechtigungskonzept](/knowledge/docs/permission-concept.md)

---

### 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](/knowledge/docs/microtech-connection.md)**:
  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).
  - [Zur microtech Basis-Konfiguration](/knowledge/docs/microtech-connection.md)

* **[Automatische NetBird-Anbindung (Auto-TLS & VPN)](/knowledge/docs/microtech-netbird-setup.md)**:
  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.
  - [Zur automatischen NetBird-Anbindung](/knowledge/docs/microtech-netbird-setup.md)

* **[microtech Mandantenkonfiguration im Portal](/knowledge/docs/microtech-portal-config.md)**:
  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.
  - [Zur microtech Mandantenkonfiguration im Portal](/knowledge/docs/microtech-portal-config.md)

---

## 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](/knowledge/docs/customer-administration.md) | Notfallkontakte verifizieren, Recovery-Codes sichern, Benachrichtigungsverteiler pflegen. |
| **2. Identität** | 2.1 | IdP & Single Sign-On | [Zugriff & Authentifizierung](/knowledge/docs/access-authentication.md) | Entra ID App-Registration, Secret, Graph-Rechte und Gruppen-Claim einrichten. |
| | 2.2 | Rollen & Berechtigungen | [Berechtigungskonzept](/knowledge/docs/permission-concept.md) | E-Mail-Routing-Domains (`allowedEmailRegex`) und IdP-Gruppen-Mappings je Mandant definieren. |
| **3. ERP-Anbindung**| 3.1 | microtech Vorbereitung | [microtech Basis-Konfiguration](/knowledge/docs/microtech-connection.md) | HTTP/2, OAuth2-Client und GraphQL-Zugriff in `BpConfig.exe` und büro+ konfigurieren. |
| | 3.2 | NetBird Overlay VPN | [Automatische NetBird-Anbindung](/knowledge/docs/microtech-netbird-setup.md) | Einzeiler-PowerShell-Bootstrap ausführen (auch neben einem bestehenden VPN), WireGuard-Peer koppeln und Auto-TLS aktivieren. |
| | 3.3 | Verbindung im Portal | [microtech konfigurieren](/knowledge/docs/microtech-portal-config.md) | 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**](/knowledge/docs/customer-administration.md).
>
> Nach erfolgreichem Abschluss der Basiskonfiguration und ERP-Kopplung fahren Sie mit der produktbezogenen [**Systemkonfiguration**](../start/getting-started.md) für ConnectINVOICE, ConnectWORKFLOW, ConnectELO oder ConnectPORTAL fort.
