Dokumentation › Administration › Berechtigungskonzept
Mandantenbezogene Zugriffskontrolle und rollenbasierte Berechtigungssteuerung (RBAC) in ConnectCLOUD.
Zuletzt geändert am 17.11.2026
Auf dieser Seite
Zielgruppe & Rolle
Rolle: IT-Administrator / Kunden-Admin | Voraussetzung: OIDC / Microsoft Entra ID Anbindung eingerichtet
Das Berechtigungskonzept der ConnectCLOUD basiert auf einer mandantenbezogenen Zugriffskontrolle und einer rollenbasierten Berechtigungssteuerung (RBAC).
Architektur-Übersicht
Das folgende Diagramm illustriert den Autorisierungsprozess:
graph TD
User[Benutzer] -->|Login| Provider[Microsoft Entra ID / Passkey]
Provider -->|Anmeldung| HR[HR Service]
HR -->|Login-Domains| Tenants[Erlaubte Mandanten]
HR -->|Mitgliedschaften| Roles[Rollen & Berechtigungen]
Roles -->|New JWT| User
User -->|API Request| Services[Microservices]
Services -->|Validate| Principal[Principal Context]
Mandanten-basierte Zugriffskontrolle
Der Zugriff auf einen Mandanten wird über E-Mail-Regex-Regeln gesteuert. Jeder Mandant kann eine Liste von regulären Ausdrücken definieren (allowedEmailRegex). Wenn die E-Mail-Adresse eines angemeldeten Benutzers auf einen dieser Ausdrücke passt, erhält der Benutzer Zugriff auf diesen Mandanten.
Konfiguration
Die Konfiguration erfolgt im Portal unter Administration > Berechtigungen. Hier können pro Zeile reguläre Ausdrücke hinterlegt werden.
- Beispiel:
(?i)^.*@mbcom\.de$erlaubt allen Benutzern mit einer mbcom.de E-Mail-Adresse den Zugriff.
Login-Domains
Die Anmeldung und die Zuordnung einer E-Mail-Adresse zu einem Mandanten übernimmt der Dienst HR. Jeder Mandant hat eine Anmelderichtlinie und eine Liste von Login-Domains (Einstellungen › Anmeldung & Berechtigungen › Anmeldung); die Domain einer E-Mail-Adresse wird exakt und ohne Beachtung der Groß-/Kleinschreibung abgeglichen. Eine Domain gehört zu genau einem Kunden; ein Konflikt wird beim Speichern abgelehnt. Details: AUTH.md, Abschnitt 3.
Rollen und Berechtigungen
Berechtigungen werden in ConnectCLOUD differenziert auf zwei Ebenen gesteuert:
- Kunden-Ebene (
CUSTOMER_ADMIN): Übergreifende Administration für das gesamte Kundenkonto (Stammdaten, Benachrichtigungseinstellungen, Notfall-Wiederherstellung, Einmalcodes und kundenweite Administrator-Gruppen). - Mandanten-Ebene (
TENANT_*): Spezifische Berechtigungen und Zugriffsrollen für einzelne Mandanten.
Verfügbare Rollen
| Rolle | Ebene | Beschreibung | Wichtigste Berechtigungen |
|---|---|---|---|
CUSTOMER_ADMIN |
Kunde | Kundenweiter Administrator mit Vollzugriff auf übergreifende Einstellungen und Notfallwiederherstellung. | customer:settings:read, customer:settings:write |
TENANT_ADMIN |
Mandant | Mandanten-Administrator mit vollem Schreibzugriff auf Mandanten-Einstellungen, Token-Generierung, Rechnungsvergleich sowie administrativer Steuerung von Workflow-Instanzen. | settings:read, settings:write, invoice:compare:run, invoice:compare:read, workflow:admin, desk:admin, desk:confidential |
TENANT_ADMIN_VIEWER |
Mandant | Lesender Zugriff auf Mandanten-Einstellungen. | settings:read, desk:read, desk:write |
TENANT_DATA_VIEWER |
Mandant | Standardzugriff plus Lesezugriff auf microtech-Daten. | tenant:access, dataview:read |
TENANT_VIEWER |
Mandant | Basis-Zugriff auf den Mandanten, die Beleg-/Workflow-Bearbeitung und den Service Desk. | tenant:access, desk:read, desk:write |
PORTAL_ADMIN |
System | Globaler System-Administrator von MBCOM mit uneingeschränktem Zugriff auf alle Mandanten und Systemeinstellungen. Erhält, wer im Betreiber-Mandanten 10639/MBCOM eine Rolle mit portal:admin hat (Rolle Portal-Administration); nur dort vergebbar. |
* (Volle Systemrechte) |
Wie wird die Rolle CUSTOMER_ADMIN ermittelt?
Die Rolle CUSTOMER_ADMIN wird dynamisch vom System nach folgenden Kriterien vergeben:
flowchart TD
Start[Benutzer meldet sich an] --> CheckRecovery{E-Mail ist verifizierter Recovery-Kontakt?}
CheckRecovery -- Ja --> GrantAdmin[Rolle CUSTOMER_ADMIN vergeben]
CheckRecovery -- Nein --> CheckGroupMapping{Kundenweite Gruppen-Zuordnung konfiguriert?}
CheckGroupMapping -- Ja --> CheckUserGroup{Gehört Benutzer zu CUSTOMER_ADMIN-Gruppe?}
CheckUserGroup -- Ja --> GrantAdmin
CheckUserGroup -- Nein --> DenyAdmin[Keine CUSTOMER_ADMIN-Berechtigung]
CheckGroupMapping -- Nein (Fallback) --> CheckTenantAdmin{Besitzt Benutzer TENANT_ADMIN auf einem Mandanten?}
CheckTenantAdmin -- Ja --> GrantAdmin
CheckTenantAdmin -- Nein --> DenyAdmin
- Verifizierter Recovery-Kontakt: Benutzer, deren E-Mail-Adresse im Reiter Sicherheit der Kunden-Administration als bestätigte Notfalladresse hinterlegt ist, erhalten bedingungslos
CUSTOMER_ADMIN. - Kundenweites Gruppen-Mapping: Wenn Sicherheitsgruppen der Rolle
CUSTOMER_ADMINzugewiesen sind, erhalten alle Gruppenmitglieder die Rolle. - Automatischer Fallback: Ist keine kundenweite Gruppen-Zuordnung hinterlegt, greift zur Gewährleistung der Abwärtskompatibilität ein automatischer Fallback: Alle Benutzer mit der Rolle
TENANT_ADMINauf mindestens einem Mandanten erhalten ebenfalls Zugriff auf die Kunden-Administration.
Mandantenspezifisches Gruppen-Mapping
In den Mandanten-Einstellungen (Administration > Berechtigungen) legen Sie fest, welche OIDC-Gruppe (Object ID aus Entra ID) welcher internen Rolle für den gewählten Mandanten zugeordnet wird. Dies ermöglicht eine flexible Steuerung basierend auf bestehenden Berechtigungsgruppen Ihrer Organisation.
Mandantenweite Workflow-Administration (workflow:admin)
Um betriebliche Prozesse abzusichern und die Vertraulichkeit von Prüfpfaden zu gewährleisten, wird die administrative Steuerung von Workflow-Instanzen über eine dedizierte Berechtigung gesteuert:
- Exklusive Rollenzuordnung: Die Berechtigung
workflow:administ strikt und ausschließlich der RolleTENANT_ADMINzugewiesen. - Ausschluss für System- und Portal-Administratoren: Die Rolle
PORTAL_ADMINerhältworkflow:adminstandardmäßig nicht. Portal-Administratoren können Workflow-Instanzen eines Kunden nur dann einsehen oder verwalten, wenn ihnen explizit die RolleTENANT_ADMINfür den jeweiligen Mandanten zugewiesen wurde. Dadurch bleibt die Trennung zwischen System-Hosting und Mandantendaten gewahrt. - Enthaltene Verwaltungsfunktionen:
- Zentraler Instanzenüberblick: Einsicht in sämtliche aktiven, abgeschlossenen, genehmigten, abgelehnten und abgebrochenen Workflow-Instanzen des Mandanten über den Tab Alle Workflow-Instanzen in der Aufgabenübersicht – unabhängig von der persönlichen Entra-Gruppenzugehörigkeit.
- Administrativer Workflow-Abbruch: Berechtigung zur außerordentlichen Beendigung verwaister oder blockierter Workflows (
POST /api/workflow/v1/tasks/:id/cancel) inklusive automatischer Entsperrung des Vorgangs in microtech ERP und revisionssicherem Audit-Protokoll.
Service Desk (desk:*)
| Berechtigung | Erlaubt | Rollen |
|---|---|---|
desk:read |
Tickets in allen für den Mandanten sichtbaren Bereichen lesen (Bereichsrolle Lesen) | TENANT_VIEWER, TENANT_ADMIN_VIEWER, TENANT_ADMIN, PORTAL_ADMIN, Servicekonten |
desk:write |
Tickets anlegen, bearbeiten, Status wechseln, kommentieren, Zeit erfassen (Bereichsrolle Bearbeiten) | wie desk:read |
desk:admin |
Konfiguration: Bereiche, Arten, Abläufe, Felder, Prioritäten, Labels, Teams; Verwalten in jedem Bereich | TENANT_ADMIN |
desk:confidential |
Vertrauliche Tickets (z. B. Sicherheitsvorfälle) sehen | TENANT_ADMIN |
Innerhalb des Service Desk verfeinern Bereichsrollen den Zugriff: Lesen < Melden (anlegen und
kommentieren) < Bearbeiten < Verwalten (Bereich, Labels). Bereiche mit der
Sichtbarkeit „Nur Mitglieder“ sind ausschließlich für ihre Mitglieder sichtbar. Vertrauliche Tickets
sehen zusätzlich ihr Ersteller und die eingetragenen Beteiligten. Wie bei workflow:admin erhält
PORTAL_ADMIN weder desk:admin noch desk:confidential.
Entwicklung (tenant:forge:*)
| Berechtigung | Erlaubt | Rollen |
|---|---|---|
tenant:forge:read |
Entwicklungsprojekte, ihre Vorgänge, Abschnitte und Kommentare ansehen | TENANT_VIEWER, TENANT_ADMIN_VIEWER, TENANT_ADMIN, PORTAL_ADMIN |
tenant:forge:write |
Vorgänge anlegen, bearbeiten, kommentieren, verknüpfen, übergeben und umwandeln | TENANT_VIEWER, TENANT_ADMIN, PORTAL_ADMIN |
tenant:forge:admin |
Projekte anlegen, Mitglieder, Repositories und Konfiguration jedes Projekts pflegen | TENANT_ADMIN, PORTAL_ADMIN |
tenant:forge:intake |
Übergaben aus dem Service Desk in Projekte, die sie annehmen – ohne weiteren Zugriff | TENANT_VIEWER, TENANT_ADMIN, PORTAL_ADMIN |
In der Entwicklung verfeinern Projektrollen den Zugriff: Meldend < Entwicklung < Pflege < Verwaltung. Private Projekte sehen nur ihre Mitglieder und die Administration der Entwicklung. Vertrauliche Vorgänge – auch die aus vertraulichen Tickets übergebenen – sehen nur die Administration der Entwicklung, Mitglieder ab Pflege, die meldende Person und die Zuständigen. Wer ein Ticket an die Entwicklung übergibt, braucht dort selbst eine dieser Berechtigungen; siehe Übergabe und Umwandlung.
Mandantenwechsel
Ein Benutzer kann zwischen den Mandanten wechseln, auf die er Zugriff hat.
- Mandantenauswahl: Links oben im Portal befindet sich der Mandantenumschalter.
- URL-Parameter: Über den Query-Parameter
?tenant=<mandantename>kann ein Wechsel direkt beim Aufruf einer Seite ausgelöst werden. - Session-Aktualisierung: Beim Wechsel eines Mandanten wird ein neues Session-Token (JWT) ausgestellt, das die spezifischen Rollen und Berechtigungen für den Zielmandanten enthält.
Nächster Schritt in der Basiskonfiguration
Nachdem das Berechtigungskonzept definiert ist, richten Sie die Schnittstelle zu microtech büro+ ein: microtech Basis-Konfiguration
Zurück zur Übersicht: Basiskonfiguration Übersicht
Hat das geholfen?
https://app.mbcom.cloud/knowledge/docs/base/permission-concept