KlarKonform Docs

Berechtigungen und Rollen

Benutzerrollen und Zugriffsrechte uber M365 Security Groups

Das Berechtigungssystem in KlarKonform basiert auf Microsoft 365 Security Groups. Rollen werden in Entra ID (Azure AD) verwaltet und automatisch mit KlarKonform synchronisiert.

Rollenkonzept

Rollen-Hierarchie

┌─────────────────────────────────────────────────────────────────┐
│                    ROLLENUBERSICHT                              │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  Admin ──────────────────────────────────────────────────────▶  │
│    │     Volle Administratorrechte                              │
│    │                                                            │
│    ├── HR ──────────────────────────────────────────────────▶   │
│    │      Personalverwaltung, Mitarbeitervereinbarungen         │
│    │                                                            │
│    ├── Accounting ──────────────────────────────────────────▶   │
│    │      Buchhaltung, Finanzrelevante Module                   │
│    │                                                            │
│    └── User ────────────────────────────────────────────────▶   │
│           Basis-Zugriff, eigene Daten                           │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Verfugbare Rollen

RolleBeschreibungTypische Verwendung
AdminVollzugriff auf alle ModuleIT-Leitung, Geschaftsfuhrung
HRPersonalverwaltungPersonalabteilung
AccountingBuchhaltungFinanzen, Controlling
UserStandard-BenutzerAlle Mitarbeiter

M365 Security Groups

Gruppenstruktur

Fur jeden Tenant werden Security Groups in folgendem Format erwartet:

KlarKonform-[TenantName]-[Role]

Beispiele:

  • KlarKonform-MeineFirma-Admin
  • KlarKonform-MeineFirma-HR
  • KlarKonform-MeineFirma-Accounting
  • KlarKonform-MeineFirma-User

Mapping

┌─────────────────────────────────────────────────────────────────┐
│              SECURITY GROUP → ROLLE MAPPING                     │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  M365 Security Group                  KlarKonform Rolle         │
│  ─────────────────────────────────────────────────────────────  │
│                                                                 │
│  KlarKonform-Acme-Admin         →     Admin                     │
│       │                                 │                       │
│       └── Mitglied: alice@acme.com      └── Admin-Rechte        │
│                                                                 │
│  KlarKonform-Acme-HR            →     HR                        │
│       │                                 │                       │
│       └── Mitglied: bob@acme.com        └── HR-Rechte           │
│                                                                 │
│  KlarKonform-Acme-User          →     User                      │
│       │                                 │                       │
│       └── Mitglieder: alle              └── Basis-Rechte        │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Rollenzuweisung

Uber Entra ID (empfohlen)

  1. Offnen Sie Entra ID (Azure Portal)
  2. Navigieren Sie zu "Gruppen"
  3. Suchen Sie die entsprechende KlarKonform-Gruppe
  4. Fugen Sie den Benutzer als Mitglied hinzu
  5. Synchronisieren Sie KlarKonform

Uber KlarKonform UI

  1. Mitarbeiter offnen > Bearbeiten
  2. Im Abschnitt "Rollen" gewunschte Rollen anhaken
  3. Speichern

Hintergrund-Ablauf:

┌─────────────────────────────────────────────────────────────────┐
│              ROLLENANDERUNG UBER UI                             │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  1. Benutzer andert Rollen-Checkboxen                           │
│       │                                                         │
│       ▼                                                         │
│  2. Aktuelle Rollen aus M365 abrufen                            │
│       │                                                         │
│       ▼                                                         │
│  3. Differenz berechnen                                         │
│       │                                                         │
│       ├── Neue Rollen → Benutzer zu Security Group hinzufugen   │
│       │                                                         │
│       └── Entfernte Rollen → Benutzer aus Group entfernen       │
│       │                                                         │
│       ▼                                                         │
│  4. Lokale Rollen aktualisieren                                 │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Berechtigungsprufung

Wie Berechtigungen geprueft werden

Bei jedem Zugriff auf geschuetzte Bereiche prueft das System:

  1. Welche Rollen hat der Benutzer?
  2. Gehoert der Benutzer zum richtigen Mandanten?
  3. Ist die angeforderte Aktion fuer diese Rolle erlaubt?

Verfuegbare Aktionen

AktionBeschreibungErforderliche Rolle
viewAnyMitarbeiterliste anzeigenAdmin, HR
viewEinzelnen Mitarbeiter anzeigenAdmin, HR, eigener Datensatz
createNeuen Mitarbeiter anlegenAdmin
updateMitarbeiter bearbeitenAdmin, HR (eingeschrankt)
deleteMitarbeiter loschenAdmin

Mandanten-Isolation

Jeder Benutzer kann nur Daten seines eigenen Mandanten sehen. Diese Einschraenkung wird automatisch bei allen Zugriffen angewendet.

Berechtigungsmatrix

Mitarbeiter-Modul

AktionAdminHRAccountingUser
Mitarbeiterliste anzeigenXX--
Mitarbeiter-Details anzeigenXX-Eigene
Mitarbeiter anlegenX---
Mitarbeiter bearbeitenXX*--
Mitarbeiter loschenX---
Von M365 synchronisierenX---
M365-Benutzer importierenX---

*HR kann eingeschrankte Felder bearbeiten

DSGVO-Module

AktionAdminHRAccountingUser
VerarbeitungstatigkeitenX---
Anwendungen/AVVX---
TOMsX---
LoschkonzeptX---
MitarbeitervereinbarungenXX-Eigene
WebsitesX---

Aktualisierung von Berechtigungen

Automatische Aktualisierung

Benutzerrollen werden zwischengespeichert fuer schnellere Zugriffe. Bei Profilaenderungen werden die gespeicherten Berechtigungen automatisch aktualisiert.

Hinweis: Nach Rollenaenderungen kann es einen Moment dauern, bis die neuen Berechtigungen wirksam sind. Bei Problemen hilft eine erneute Anmeldung.

Fehlerbehandlung

Fehlende Security Groups

Wenn eine Security Group nicht existiert:

SituationVerhalten
Rolle zuweisenFehler bei Speichern
Rolle entfernenIgnoriert (keine Aktion)
SyncBenutzer erhalt Rolle "User"

M365-Berechtigungsfehler

FehlerUrsacheLosung
"Access denied"Fehlender Admin-ConsentGraph-Berechtigungen prufen
"Group not found"Gruppe existiert nichtGruppe in Entra ID erstellen
"Insufficient privileges"Token hat keine RechteAdmin-Token erneuern

Setup-Anleitung

1. Security Groups erstellen

In Entra ID folgende Gruppen erstellen:

KlarKonform-`[IhrTenantName]`-Admin
KlarKonform-`[IhrTenantName]`-User
KlarKonform-`[IhrTenantName]`-HR        (optional)
KlarKonform-`[IhrTenantName]`-Accounting (optional)

2. Initiale Mitglieder zuweisen

  • Mindestens einen Admin-Benutzer zur Admin-Gruppe hinzufugen
  • Alle Benutzer zur User-Gruppe hinzufugen

3. KlarKonform synchronisieren

  1. Als Admin anmelden
  2. Mitarbeiter > "Von M365 synchronisieren"
  3. Rollen werden automatisch aus Gruppenmitgliedschaft abgeleitet

4. Berechtigungen testen

  1. Als verschiedene Benutzer anmelden
  2. Zugriff auf Module prufen
  3. Bei Problemen Rollen in Entra ID prufen

Best Practices

Rollenvergabe

EmpfehlungBegrundung
Minimal-PrinzipNur erforderliche Rechte vergeben
Admin sparsamWenige Admin-Benutzer
User als StandardAlle Mitarbeiter in User-Gruppe
DokumentierenRollenzuweisungen nachvollziehbar machen

Regelmassige Prufung

IntervallAktion
WochentlichAdmin-Rollenzuweisungen prufen
MonatlichInaktive Benutzer mit Rollen prufen
QuartalsweiseVollstandige Rollen-Revision

Audit-Trail

Alle Rollenanderungen werden protokolliert:

  • Wer hat die Anderung vorgenommen?
  • Welche Rollen wurden geandert?
  • Wann wurde die Anderung vorgenommen?