Zum Inhalt springen

Zugriffssteuerung

Letzte Aktualisierung: 16.11.2026

Handbuch für das Zugriffsstudio in OpenBiz

Modul: clx_access_control, Version 18.0.0.14.0

Für: Verwalterinnen und Verwalter von Benutzerrechten

Stand: 16.11.2026

Inhalt

  1. Wozu die Zugriffssteuerung dient
  2. Voraussetzungen und Menü
  3. Das Grundprinzip einer Regel
  4. Eine Regel anlegen
  5. Domain-Filter: nur bestimmte Datensätze
  6. Profile: Regeln zu Rollen bündeln
  7. Feld-Restriktionen
  8. Globale Schalter am Benutzer
  9. Teams: nur Datensätze des eigenen Teams
  10. Grenzen und Sicherheit
  11. Beispiel: Rolle «Externe Partner-Organisation»
  12. Fehlersuche

1. Wozu die Zugriffssteuerung dient

Mit der Zugriffssteuerung legst du fest, was einzelne Benutzer oder ganze Gruppen in OpenBiz sehen und tun dürfen. Sie ergänzt die Rollen, die jede App mitbringt (zum Beispiel «Verkauf: Benutzer» oder «Buchhaltung: Administrator»), und macht sie feiner:

  • ganze Bereiche sperren, etwa «darf keine Rechnungen sehen»
  • nur bestimmte Datensätze ausblenden oder vor Änderungen schützen
  • Menüs, Knöpfe, Reiter, Filter und einzelne Felder ausblenden
  • einen Benutzer auf «nur lesen» stellen oder seine Anmeldung sperren

Du klickst die Regeln zusammen, programmieren musst du nichts. Jede Änderung wirkt sofort, auch für Benutzer, die gerade angemeldet sind. Sie sehen sie nach dem nächsten Neuladen der Seite.

2. Voraussetzungen und Menü

Die Zugriffssteuerung bedienen kann nur, wer die Gruppe Zugriffssteuerung — Verwalter hat. Der Administrator hat sie automatisch. Du findest die App im Hauptmenü unter Zugriffssteuerung mit drei Menüpunkten:

MenüpunktWofür
RegelnDie einzelnen Sperren und Einschränkungen. Das Herzstück.
ProfileBündeln mehrere Regeln zu einer Rolle, z. B. «Externe Partner-Organisation». Ein Profil gibst du dann Benutzern oder Gruppen.
TeamsBenutzer, die auf bestimmten Listen nur die Datensätze ihres eigenen Teams sehen sollen.

Abbildung 1: Die App Zugriffssteuerung mit (1) Regeln, (2) Profile, (3) Teams und (4) dem Knopf «Neu».

Abbildung 1: Die App Zugriffssteuerung mit (1) Regeln, (2) Profile, (3) Teams und (4) dem Knopf «Neu».

Am Benutzer selbst (Einstellungen › Benutzer, Reiter Zugriffssteuerung) gibt es zusätzlich drei globale Schalter und die Zuweisung der Profile, siehe Kapitel 8.

3. Das Grundprinzip einer Regel

Jede Regel beantwortet drei Fragen:

FrageWo in der RegelBeispiel
Wen betrifft sie?Kopf der Regel: Benutzer, Gruppen, FirmenBenutzerin «Petra Muster» oder alle Mitglieder der Gruppe «Veranstaltungen»
Worauf wirkt sie?Reiter Wirkungsbereich: Module, Modelle, Domain-FilterModell «Rechnung», optional nur Rechnungen einer bestimmten Firma
Was wird eingeschränkt?Alle übrigen ReiterLesen verbieten, Menü ausblenden, Feld unsichtbar machen

Wichtig: Regeln verbieten, sie erlauben nie etwas.

Eine Regel kann nur wegnehmen. Was ein Benutzer nach den App-Rollen nicht darf, kann ihm keine Regel geben.

Gelten für einen Benutzer mehrere Regeln, wirken alle zusammen. Die strengste Sperre gewinnt.

Wer keiner Regel und keinem Profil zugeordnet ist, ist von der Zugriffssteuerung nicht betroffen.

4. Eine Regel anlegen

4.1 Schritt für Schritt

  1. Öffne Zugriffssteuerung › Regeln und klicke Neu (Abbildung 1, Punkt 4).
  2. Gib der Regel einen sprechenden Namen (1), z. B. «Event-Manager: keine Rechnungen».
  3. Wähle unter Benutzer (2) die betroffenen Personen oder unter Gruppen (3) eine ganze Gruppe. Alle Mitglieder der Gruppe bekommen die Regel automatisch, auch spätere.
  4. Lass Companies leer, wenn die Regel in allen Firmen gelten soll.
  5. Lege im Reiter Wirkungsbereich (4) fest, worauf die Regel wirkt (Kapitel 4.2).
  6. Setze in den übrigen Reitern die gewünschten Einschränkungen (Kapitel 4.3).
  7. Speichere. Die Regel wirkt sofort.

Abbildung 2: Neue Regel: (1) Name, (2) Benutzer, (3) Gruppen, (4) Reiter Wirkungsbereich.

Abbildung 2: Neue Regel: (1) Name, (2) Benutzer, (3) Gruppen, (4) Reiter Wirkungsbereich.

Statt Benutzer direkt in jede Regel einzutragen, ist es meist übersichtlicher, Regeln in einem Profil zu bündeln (Kapitel 6).

4.2 Reiter «Wirkungsbereich»

EbeneBedeutung
1. ModuleWählst du nur ein Modul (z. B. Rechnungsstellung) und keine Modelle, gilt die Regel für alle Modelle dieses Moduls. Das ist grob, aber schnell.
2. ModelleGenaue Auswahl, z. B. nur «Rechnung» (account.move). Ist ein Modul gewählt, zeigt die Auswahl nur dessen Modelle.
3. Domain-FilterOptional: Die Regel betrifft nur Datensätze, die dem Filter entsprechen. Leer heisst, sie betrifft alle Datensätze der gewählten Modelle. Siehe Kapitel 5.

Abbildung 3: Reiter Wirkungsbereich: (1) Module, (2) Modelle, (3) Domain-Filter, hier «Name enthält XX-Geheim».

Abbildung 3: Reiter Wirkungsbereich: (1) Module, (2) Modelle, (3) Domain-Filter, hier «Name enthält XX-Geheim».

Unter Effektive Ziele siehst du, wie viele Modelle die Regel tatsächlich betrifft. Mindestens ein Modul oder ein Modell muss gewählt sein.

4.3 Die Einschränkungen in den Reitern

ReiterWas du einstellen kannst
Modell-RestriktionenErstellen, Lesen, Bearbeiten, Löschen verbieten oder alles auf einmal mit Nur-Lesen. Ohne Domain-Filter gilt die Sperre für das ganze Modell, mit Filter nur für die passenden Datensätze.
View-ElementeEinzelne Knöpfe, Reiter, Filter, Gruppierungen oder Kanban-Links ausblenden. Du gibst den technischen Namen des Elements an, z. B. action_confirm für «Bestätigen».
UI-VerhaltenSuchleiste: Seitenleiste ausblenden, eigene Filter oder Gruppierungen verbieten, Favoriten nicht löschen. Aktionen: Import, Export, Archivieren, Duplizieren und die Knöpfe Neu/Bearbeiten/Löschen ausblenden.
Berichte & ActionsBestimmte Druckberichte und Server-Aktionen im Menü «Aktion» bzw. «Drucken» ausblenden.
ChatterDen ganzen Chatter ausblenden oder nur die Knöpfe «Nachricht senden», «Notiz» bzw. «Aktivität».
Menü-RestriktionenMit einem Klick Einstellungen und Apps ausblenden, dazu beliebige weitere Menüpunkte. Untermenüs verschwinden mit.
View-TypenAnsichten wie Liste, Kanban, Kalender, Pivot, Grafik, Karte usw. für die gewählten Modelle ausblenden.
Feld-RestriktionenEinzelne Felder steuern, siehe Kapitel 7. Nur möglich, wenn die Regel genau ein Modell hat.
BeschreibungFreier Text: Wozu ist die Regel da, wer hat sie verlangt? Hilft beim späteren Aufräumen.

Abbildung 4: Reiter (1) Modell-Restriktionen, hier (2) «Lesen verbieten».

Abbildung 4: Reiter (1) Modell-Restriktionen, hier (2) «Lesen verbieten».

Abbildung 5: Reiter (1) Menü-Restriktionen: (2) Einstellungen und (3) Apps ausblenden, (4) weitere Menüpunkte.

Abbildung 5: Reiter (1) Menü-Restriktionen: (2) Einstellungen und (3) Apps ausblenden, (4) weitere Menüpunkte.

Abbildung 6: Reiter (1) UI-Verhalten mit Suchleiste und Aktionen.

Abbildung 6: Reiter (1) UI-Verhalten mit Suchleiste und Aktionen.

5. Domain-Filter: nur bestimmte Datensätze

Mit einem Domain-Filter wirkt eine Regel nicht auf alle Datensätze eines Modells, sondern nur auf die, die zum Filter passen. Den Filter klickst du im Editor zusammen oder schreibst ihn als Ausdruck.

So wirkt der Filter: Er beschreibt, was GESPERRT wird.

Die Zugriffssteuerung arbeitet mit einer Sperrliste: Datensätze, die zum Filter passen, sind betroffen. Willst du «nur die eigenen» erlauben, formulierst du es umgekehrt: «sperre alle, die NICHT meine sind».

Beispiel: [('user_id', '!=', uid)] sperrt alle Datensätze, bei denen jemand anderes verantwortlich ist.

5.1 Was passiert je Sperre

Sperre mit FilterWirkung für den Benutzer
Lesen verbietenPassende Datensätze verschwinden aus Listen, Kanban, Suche und Auswahlfeldern.
Bearbeiten verbietenSpeichern eines passenden Datensatzes bricht mit einer Meldung ab, die die Regel nennt.
Löschen verbietenLöschen eines passenden Datensatzes bricht mit einer Meldung ab.
Erstellen verbietenEin neuer Datensatz, der zum Filter passen würde, wird nicht gespeichert.

5.2 Platzhalter im Filter

PlatzhalterBedeutung
uiddie ID des angemeldeten Benutzers
userder angemeldete Benutzer, z. B. user.partner_id.commercial_partner_id.id = seine Firma
company_iddie aktuell gewählte Firma
datetime, timeDatum und Zeit, z. B. für «älter als 30 Tage»

5.3 Beispiele

FilterWirkung zusammen mit der Sperre
[('name', 'ilike', 'Geheim')]Mit «Lesen verbieten»: alle Datensätze mit «Geheim» im Namen sind unsichtbar.
[('user_id', '!=', uid)]Mit «Bearbeiten verbieten»: nur eigene Datensätze sind bearbeitbar.
[('commercial_partner_id', '!=', user.partner_id.commercial_partner_id.id)]Mit «Bearbeiten/Löschen verbieten» auf Kontakten: nur Kontakte der eigenen Firma sind änderbar.
[('create_date', '<', (datetime.datetime.now() - datetime.timedelta(days=30)).strftime('%Y-%m-%d'))]Mit «Löschen verbieten»: Datensätze, die älter als 30 Tage sind, lassen sich nicht mehr löschen.

Ein fehlerhafter Filter lässt sich nicht speichern. OpenBiz zeigt dann eine Meldung mit dem Fehler.

6. Profile: Regeln zu Rollen bündeln

Ein Profil ist eine Sammlung von Regeln. Statt fünf Regeln einzeln an zehn Personen zu hängen, legst du ein Profil an und weist es den Personen oder einer Gruppe zu.

  1. Öffne Zugriffssteuerung › Profile und klicke Neu.
  2. Name (1), z. B. «Externe Partner-Organisation», optional Beschreibung und Farbe.
  3. Im Reiter Regeln (2) die gewünschten Regeln wählen (3).
  4. Im Reiter Benutzer (4) Personen bzw. Gruppen zuweisen. Alternativ am Benutzer im Reiter Zugriffssteuerung unter Zugewiesene Profile (Abbildung 9).

Abbildung 7: Profil: (1) Name, (2) Reiter Regeln mit (3) den vier Regeln, (4) Reiter Benutzer.

Abbildung 7: Profil: (1) Name, (2) Reiter Regeln mit (3) den vier Regeln, (4) Reiter Benutzer.

Die Regeln eines Profils gelten so, als wären sie dem Benutzer direkt zugewiesen. Profile erben nicht voneinander, jedes ist eine flache Sammlung.

7. Feld-Restriktionen

Im Reiter Feld-Restriktionen steuerst du einzelne Felder. Die Regel muss dafür genau ein Modell haben.

  1. Regel mit genau einem Modell öffnen, Reiter Feld-Restriktionen (1) wählen.
  2. Zeile hinzufügen, Feld wählen und den gewünschten Effekt einschalten (2), hier «Telefon» auf Nur-Lesen.
  3. Speichern.

Abbildung 8: (1) Reiter Feld-Restriktionen, (2) Feld «Telefon» auf Nur-Lesen.

Abbildung 8: (1) Reiter Feld-Restriktionen, (2) Feld «Telefon» auf Nur-Lesen.

EinstellungWirkung
UnsichtbarDas Feld erscheint im Formular und in Listen nicht.
Nur-LesenDas Feld ist sichtbar, aber nicht änderbar.
PflichtDas Feld muss ausgefüllt werden.
Server-BlockDas Feld wird auch über Schnittstellen nicht herausgegeben. Das ist die einzige Feldsperre, die nicht nur die Oberfläche betrifft. Für heikle Felder wie Lohn oder Bankverbindung.
Kein Öffnen / Kein Neu / Kein Bearb.Bei Auswahlfeldern: den Link zum verknüpften Datensatz bzw. «Neu anlegen» und «Bearbeiten» im Auswahlfeld ausblenden.
Bedingter EffektUnsichtbar, Nur-Lesen oder Pflicht nur dann, wenn eine Bedingung erfüllt ist, z. B. nur wenn der Status «bestätigt» ist.
Zusätzliches DomainBei Auswahlfeldern: die angebotenen Einträge einschränken.

8. Globale Schalter am Benutzer

Unter Einstellungen › Benutzer, Reiter Zugriffssteuerung (1):

SchalterWirkung
Nur-Lesen-Modus (global)Der Benutzer kann nirgends etwas erstellen, ändern oder löschen. Gut für Revisoren oder Praktikanten in der ersten Woche.
Login gesperrtDer Benutzer kann sich nicht mehr anmelden. Achtung: Eine schon laufende Sitzung bleibt offen, bis sie abläuft oder er sich abmeldet.
Developer-Modus verhindernDer Benutzer kann den Entwicklermodus nicht einschalten.

Abbildung 9: Benutzer, Reiter (1) Zugriffssteuerung: (2) Nur-Lesen, (3) Login gesperrt, (4) Developer-Modus verhindern, (5) zugewiesene Profile.

Abbildung 9: Benutzer, Reiter (1) Zugriffssteuerung: (2) Nur-Lesen, (3) Login gesperrt, (4) Developer-Modus verhindern, (5) zugewiesene Profile.

9. Teams: nur Datensätze des eigenen Teams

Ein Team sorgt dafür, dass seine Mitglieder auf bestimmten Modellen nur Datensätze sehen, die einem Teammitglied gehören.

FeldBedeutung
MitgliederDie Benutzer des Teams.
Isolierte ModelleAuf diesen Modellen wirkt die Trennung, z. B. Verkaufschancen.
Besitzer-FeldWelches Feld bestimmt, wem ein Datensatz gehört. Standard ist «erstellt von» (create_uid), bei Verkaufschancen meist user_id (Verkäufer). Das Feld muss auf allen gewählten Modellen auf einen Benutzer zeigen.
  1. Zugriffssteuerung › Teams › Neu, Name eingeben (1).
  2. Im Reiter Mitglieder (2) die Benutzer wählen.
  3. Im Reiter Isolierte Modelle (3) die Modelle wählen, z. B. Verkaufschancen.
  4. Besitzer-Feld (4) prüfen, bei Verkaufschancen user_id eintragen. Speichern.

Abbildung 10: Neues Team: (1) Name, (2) Mitglieder, (3) Isolierte Modelle, (4) Besitzer-Feld.

Abbildung 10: Neues Team: (1) Name, (2) Mitglieder, (3) Isolierte Modelle, (4) Besitzer-Feld.

Wer in keinem Team ist, sieht weiterhin alles. Ist jemand in mehreren Teams, sieht er die Datensätze aller seiner Teams.

10. Grenzen und Sicherheit

Die Zugriffssteuerung ist stark beim Aufräumen der Oberfläche und beim Sperren ganzer Modelle. Bei der Trennung einzelner Datensätze gibt es Grenzen, die du kennen musst:

ThemaWas gilt
Sperre ganzer Modelle (ohne Filter)Echte Sperre: Liste, Lesen und Schnittstellen sind blockiert.
Lesen verbieten mit Filter und TeamsDas ist ein Ansichtsfilter: Die Datensätze verschwinden aus Listen und Suche. Wer die Nummer eines Datensatzes kennt (Direktlink), kann ihn trotzdem öffnen. Auch Berichte und Verknüpfungen zeigen ihn.
Ausgeblendete Knöpfe und MenüsBequemlichkeit, kein Schutz. Wer die Funktion kennt, kann sie technisch weiterhin aufrufen.
Nur-Lesen-Modus und AnhängeAnhänge bleiben auch im Nur-Lesen-Modus hochladbar.
Grosse DatenmengenLesen verbieten mit Filter rechnet bei jeder Suche alle gesperrten Datensätze aus. Auf sehr grossen Tabellen (z. B. Buchungen) kann das bremsen.

Für besonders schützenswerte Daten: feste Regeln

Bewerbungen, Lohn- und Gesundheitsdaten trennen wir nicht mit einem Ansichtsfilter, sondern mit festen Regeln im System. Die halten auch einem Direktlink, einem Export und einem Bericht stand.

Beispiel: Das Modul clx_zfv_personalbeschaffung_zugriff trennt Bewerbungen nach Auftraggeber genau so. Die Zugriffssteuerung bleibt dort für Menüs, Knöpfe und Felder zuständig.

11. Beispiel: Rolle «Externe Partner-Organisation»

So ist es in der Test-Datenbank eingerichtet und kann als Vorlage dienen:

RegelEinstellung
Einstellungen und Apps ausblendenModell Kontakt, Menü-Restriktionen: Einstellungen und Apps ausblenden.
Geheime Kontakte ausblendenModell Kontakt, Lesen verbieten, Filter [('name', 'ilike', 'Geheim')].
Fremde Firmenkontakte nicht bearbeitenModell Kontakt, Bearbeiten und Löschen verbieten, Filter [('commercial_partner_id', '!=', user.partner_id.commercial_partner_id.id)].

Die Regeln stecken im Profil «Externe Partner-Organisation», das den externen Benutzern zugewiesen ist. Dazu kommt die Feldregel «Telefon nur lesen» aus Kapitel 7.

So sieht es der Benutzer

Angemeldet als «XX-HR Firma A»: Der Kontakt «XX-Geheim Kunde AG» fehlt in der Liste, Einstellungen und Apps sind aus dem Menü verschwunden.

Abbildung 11: Kontaktliste aus Sicht des externen Benutzers, ohne «XX-Geheim Kunde AG».

Abbildung 11: Kontaktliste aus Sicht des externen Benutzers, ohne «XX-Geheim Kunde AG».

Versucht derselbe Benutzer, den Kontakt einer anderen Firma zu ändern, bricht das Speichern mit dieser Meldung ab. Die Meldung nennt die Regel.

Abbildung 12: Meldung beim Speichern eines fremden Firmenkontakts.

Abbildung 12: Meldung beim Speichern eines fremden Firmenkontakts.

12. Fehlersuche

BeobachtungUrsache und Lösung
Regel wirkt nichtIst sie aktiv? Ist der Benutzer direkt, über eine Gruppe oder ein Profil zugeordnet? Stimmt die Firma? Hat der Benutzer die Seite neu geladen?
Menü ist trotz Regel sichtbarBrowser hält die Menüs im Zwischenspeicher: Seite mit Ctrl+Shift+R neu laden.
Meldung «Zugriffssteuerung: Regel … verbietet …»Die Regel greift wie gewollt. Die Meldung nennt die Regel, so findest du sie schnell.
Filter lässt sich nicht speichernAusdruck prüfen: Klammern, Anführungszeichen, Feldnamen. Die Meldung zeigt den Fehler.
Benutzer sieht trotz Filter einen Datensatz über einen LinkErwartet, siehe Kapitel 10. Für solche Fälle eine feste Regel verwenden.