# Kunden-Administration

> **Zielgruppe & Rolle**
>
> **Rolle**: Kunden-Administrator (`CUSTOMER_ADMIN`) | **Voraussetzung**: Verifizierter Recovery-Kontakt oder Gruppen-Zuweisung


# Kunden-Administration

Die **Kunden-Administration** ist der zentrale Verwaltungsbereich für alle übergreifenden Einstellungen Ihres Kundenaccounts in ConnectCLOUD. Im Gegensatz zur mandantenbezogenen [Administration](/knowledge/docs/start/portal-getting-started.md) verwalten Sie hier Einstellungen, die kundenweit für Ihre gesamte Organisation und alle Mandanten gelten.

Sie erreichen die Kunden-Administration im linken Navigationsmenü des Portals über den Menüpunkt **„Kunden-Administration“** (`/customer-admin`).

---

## Berechtigung & Rollenkonzept

Der Zugriff auf die Kunden-Administration ist geschützt und erfordert die Rolle **`CUSTOMER_ADMIN`** (technische Berechtigungen: `customer:settings:read` und `customer:settings:write`).

### Wie wird die Rolle `CUSTOMER_ADMIN` zugewiesen?

ConnectCLOUD ermittelt die Berechtigung für Kunden-Administratoren automatisch über drei Wege:

1. **Verifizierte Wiederherstellungs-Adressen (Recovery Contacts):**
   Benutzer, deren angemeldete E-Mail-Adresse als bestätigte Notfall-Wiederherstellungsadresse hinterlegt ist, erhalten automatisch und unabhängig von Gruppenmitgliedschaften vollen administrativen Zugriff (`CUSTOMER_ADMIN`).
2. **Kundenweite Gruppen-Zuordnung (Group Role Mapping):**
   In Microsoft Entra ID (oder Ihrem IdP) hinterlegte Sicherheitsgruppen, deren Object ID im Reiter **Sicherheit** der Rolle `CUSTOMER_ADMIN` zugewiesen wurde.
3. **Automatischer Fallback (Abwärtskompatibilität):**
   Solange für Ihren Kundenaccount **keine** kundenweite Gruppen-Zuordnung hinterlegt ist, besitzen alle Benutzer mit der Rolle `TENANT_ADMIN` eines beliebigen Mandanten Ihres Accounts automatisch vollen Zugriff auf die Kunden-Administration. Sobald Sie mindestens eine Gruppe für `CUSTOMER_ADMIN` hinterlegen, greift die strikte Beschränkung auf die definierten Gruppen und verifizierten Notfallkontakte.

---

## 1. Reiter „Allgemein“

Im Reiter **Allgemein** finden Sie die Stammdaten Ihres Unternehmens sowie die Einstellungen für zentrale System- und Rechnungsbenachrichtigungen.

```mermaid
graph LR
    A[Reiter Allgemein] --> B[Kunden-Stammdaten]
    A --> C[Benachrichtigungs-E-Mail]
    A --> D[Benachrichtigungen aktiv / inaktiv]
```

### Stammdaten (Read-Only)
Die Stammdaten dienen der eindeutigen Identifikation Ihres Kundenkontos im ConnectCLOUD-System:
- **Kundennummer:** Ihre eindeutige Kundennummer bei MBCOM (z. B. `10001`).
- **Kundenname:** Der offizielle Unternehmensname Ihrer Organisation.
- **Kurzname:** Ein technischer Kurzname Ihrer Organisation.

> **Änderung der Stammdaten**
>
> Die Stammdaten werden bei der Ersteinrichtung durch MBCOM hinterlegt. Sollten sich Firmierung oder Unternehmensdaten ändern, wenden Sie sich bitte an den [MBCOM-Support](mailto:support@mbcom.de).


### Benachrichtigungs-E-Mail (Verteiler)
- **Benachrichtigungs-E-Mail:** Tragen Sie hier eine zentrale E-Mail-Adresse (z. B. ein Gruppenpostfach oder einen internen Verteiler wie `connectcloud@ihrefirma.de`) ein. An diese Adresse sendet ConnectCLOUD informative System- und Statusmeldungen (z. B. bei der Anlage neuer Mandanten).
- **Benachrichtigungen aktiv:** Aktiviert oder deaktiviert den Versand wichtiger Informationen an diese Benachrichtigungsadresse. Die Plattform-E-Mails werden über Amazon SES versendet.

> **Wichtiger Sicherheitshinweis zur Verteileradresse**
>
> Die Benachrichtigungs-E-Mail ist ein rein informativer Kanal. Sie erhält **keine** sicherheitsrelevanten Links zur Notfall-Wiederherstellung oder Stornierung. Verwenden Sie für Notfälle und Sicherheitsfunktionen die dedizierten [Wiederherstellungs-Adressen](#wiederherstellungs-adressen-sicherheitskanal) im Reiter **Sicherheit**.


Klicken Sie nach Änderungen auf **„Speichern“** in der oberen Leiste, um Ihre Eingaben zu übernehmen.

---

## 2. Reiter „Sicherheit“

Der Reiter **Sicherheit** dient der Absicherung Ihres Kundenaccounts gegen Aussperren und unberechtigten Zugriff. Hier verwalten Sie Notfall-Wiederherstellungsadressen, Einmal-Wiederherstellungscodes und kundenweite Administrator-Gruppen.

### Wiederherstellungs-Adressen (Sicherheitskanal)

Wiederherstellungs-Adressen (Recovery Contacts) bilden den exklusiven Vertrauenskanal für Notfälle und die Notfall-Wiederherstellung.

- **Persönliche Postfächer:** Hinterlegen Sie hier die persönlichen E-Mail-Adressen Ihrer IT-Administratoren (keine Sammelverteiler).
- **Statusanzeige:** Jede Adresse zeigt ihren Status an:
  - **Verifiziert:** Die E-Mail-Adresse wurde über den Bestätigungslink bestätigt. Der Inhaber besitzt automatisch die Rolle `CUSTOMER_ADMIN`.
  - **Bestätigung ausstehend:** An die Adresse wurde eine Bestätigungs-E-Mail versandt. Der Bestätigungslink muss vom Empfänger geöffnet werden.
- **Bestätigung erneut senden:** Über die Schaltfläche **„Bestätigung erneut senden“** können Sie Einladungs-/Bestätigungs-E-Mails an alle noch unbestätigten Adressen erneut auslösen.
- **Adressen hinzufügen / entfernen:** Über **„Kontakt hinzufügen“** bzw. das Papierkorb-Symbol verwalten Sie die Liste der Notfalladressen.

> **Step-Up-Re-Authentifizierung**
>
> Änderungen an den Wiederherstellungs-Adressen berühren kritische Sicherheitsfunktionen. Beim Speichern modifizierter Adressen fordert ConnectCLOUD Sie daher zu einer erneuten Bestätigung (**Step-Up-Authentifizierung**) auf.


---

### Einmal-Wiederherstellungscodes (Recovery Codes)

Einmal-Wiederherstellungscodes dienen als zweiter Faktor (Besitzfaktor) bei der Notfall-Wiederherstellung (`/recovery`), falls die reguläre OIDC-Anmeldung fehlschlägt.

- **Verbleibende Codes:** Sie sehen auf einen Blick, wie viele der 8 generierten Codes noch ungenutzt sind (z. B. `8 von 8 Codes verfügbar`).
- **Codes neu generieren:** Über die Schaltfläche **„Neue Codes generieren“** können Sie jederzeit einen neuen Satz aus 8 Einmalcodes erzeugen.
  - Das Generieren erfordert eine Step-Up-Authentifizierung.
  - Bereits bestehende alte Codes werden dadurch sofort ungültig.
  - Die neuen Codes werden im Anschluss **einmalig** im Dialog angezeigt. Laden Sie diese als Textdatei herunter oder übertragen Sie sie umgehend in Ihren Passwortmanager.

---

### Kunden-Administrator-Gruppen (`CUSTOMER_ADMIN`)

Hier legen Sie fest, welche Sicherheitsgruppen aus Ihrem Identity Provider (z. B. Microsoft Entra ID) vollen kundenweiten Administrationszugriff erhalten.

- **Gruppen-ID (Object ID):** Die 36-stellige GUID der Sicherheitsgruppe aus Microsoft Entra ID (z. B. `11111111-2222-3333-4444-555555555555`).
- **Bezeichnung:** Ein sprechender Anzeigename für Ihre interne Dokumentation (z. B. `ConnectCLOUD IT-Admins`).

```mermaid
flowchart TD
    A[Benutzer meldet sich an] --> B{E-Mail ist verifizierter Recovery-Kontakt?}
    B -- Ja --> C[Rolle: CUSTOMER_ADMIN gewährt]
    B -- Nein --> D{Kundenweite Gruppen-Zuordnung vorhanden?}
    D -- Ja --> E{Mitglied in CUSTOMER_ADMIN-Gruppe?}
    E -- Ja --> C
    E -- Nein --> F[Keine CUSTOMER_ADMIN-Rolle]
    D -- Nein (Fallback) --> G{TENANT_ADMIN auf einem Mandanten?}
    G -- Ja --> C
    G -- Nein --> F
```

#### Fallback-Hinweis in der Oberfläche
- **Keine Gruppen hinterlegt:** Das Portal zeigt einen Hinweiskasten an: *„Fallback aktiv: Da keine kundenweite Zuordnung hinterlegt ist, besitzen alle Mandanten-Administratoren (TENANT_ADMIN) Kunden-Administrator-Rechte.“*
- **Mindestens eine Gruppe hinterlegt:** Der Fallback wird automatisch deaktiviert. Nur noch Mitglieder der explizit hinterlegten Gruppen sowie bestätigte Notfall-Kontakte haben Zugriff auf die Kunden-Administration.

---

## 3. microtech-Verbindung

Die microtech-Anbindung wird nicht mehr in der Kunden-Administration verwaltet. Jeder Mandant hinterlegt seine eigene Verbindung (Basis-URL, Mandant, Client-ID und Client-Secret, bei NetBird das Zertifikat) im Portal unter **Einstellungen › Integrationen › microtech**; dort läuft auch die [NetBird-Einrichtung](/knowledge/docs/base/microtech-netbird-setup.md). Siehe [microtech-Verbindung im Portal](/knowledge/docs/base/microtech-portal-config.md).

---

## 4. Unterschied zwischen Kunden- und Mandanten-Administration

Zur Orientierung fasst die folgende Tabelle die beiden Administrationsbereiche zusammen:

| Bereich | Menüpunkt | Erforderliche Rolle | Typische Aufgaben |
| :--- | :--- | :--- | :--- |
| **Kunden-Administration** | `Kunden-Administration` (`/customer-admin`) | `CUSTOMER_ADMIN` | • Kundenstammdaten einsehen<br>• Zentrale Benachrichtigungsadresse (Verteiler)<br>• Notfall-Recovery-Kontakte & Verifizierung<br>• Notfall-Recovery-Codes erneuern<br>• Kundenweite Admin-Gruppen verwalten |
| **Mandanten-Administration** | `Administration` (`/admin`) | `TENANT_ADMIN` | • Mandantenname & Design/Farbe anpassen<br>• JWT-Token für Schnittstellen abrufen<br>• Mandantenspezifische Rollen-Mappings<br>• E-Mail-Filterregeln pro Mandant<br>• Rechnungsvergleich & Modul-Einstellungen<br>• Mandantenspezifische Modul-Aktivierung |

---

## Verwandte Themen

- [**Automatische NetBird-Anbindung & Server-Enrollment**](/knowledge/docs/base/microtech-netbird-setup.md) — Schritt-für-Schritt-Anleitung zur On-Premises-Anbindung via NetBird.
- [**microtech Basis-Konfiguration**](/knowledge/docs/base/microtech-connection.md) — Allgemeine Anforderungen und Konfiguration in microtech büro+.
- [**microtech Mandantenkonfiguration**](/knowledge/docs/base/microtech-portal-config.md) — Die microtech-Verbindung des Mandanten im Portal (Einstellungen › Integrationen › microtech).
- [**Berechtigungskonzept**](/knowledge/docs/base/permission-concept.md) — Rollen, Berechtigungen und Zugriffssteuerung im Detail.

---

> **Nächster Schritt in der Basiskonfiguration**
>
> Richten Sie als Nächstes die Identitäts- und Authentifizierungskonfiguration ein:
> [**Zugriff & Authentifizierung**](/knowledge/docs/base/access-authentication.md)
>
> Zurück zur Übersicht: [**Basiskonfiguration Übersicht**](/knowledge/docs/base.md)
