Gäste reden. Berater moderieren. Admins konfigurieren.

1. Zielbild: Produkt-Rollen bleiben führend

Matrix speichert Rechte im Raumzustand. Für ein Produkt mit Beratern, Admins und Gästen sollte Matrix deshalb nicht die einzige Quelle der Wahrheit sein. Das Produkt entscheidet, wer Berater/Admin/Gast ist; ein Provisioning-Service übersetzt das in Matrix-Accounts, Raum-Mitgliedschaften und Power Levels.

2. Empfohlenes Rollenmodell

Ich würde vier Produktrollen unterscheiden. Damit bleibt der normale Berater arbeitsfähig, ohne strukturelle oder sicherheitsrelevante Einstellungen zu besitzen.

3. Was Matrix wirklich kann

4. Raumtypen und Defaults

5. Matrix Spaces: sinnvoll, aber nicht als Permission-Ersatz

Spaces sind in Matrix selbst wieder Räume: ein Space ist ein Raum mit m.room.create.content.type = "m.space". Er dient primär zur Organisation und Entdeckung von Unterräumen, nicht als globale Rollen-/Rechteverwaltung. Trotzdem sind Spaces für euer Produkt sehr nützlich, wenn ihr sie bewusst als Struktur- und Membership-Layer einsetzt.

Solltet ihr Spaces verwenden?

Beispiel: Berater-Space als Gruppe

{
  "creation_content": {"type": "m.space"},
  "preset": "private_chat",
  "visibility": "private",
  "name": "Berater-Team",
  "initial_state": [
    {"type":"m.room.join_rules","state_key":"","content":{"join_rule":"invite"}},
    {"type":"m.room.history_visibility","state_key":"","content":{"history_visibility":"joined"}},
    {"type":"m.room.guest_access","state_key":"","content":{"guest_access":"forbidden"}}
  ],
  "power_level_content_override": {
    "events_default": 100,
    "state_default": 100,
    "invite": 100,
    "kick": 100,
    "ban": 100,
    "redact": 100
  }
}

Beispiel: Raum in Space aufnehmen

{
  "type": "m.space.child",
  "state_key": "!fallraum:example.com",
  "content": {
    "via": ["example.com"],
    "order": "010-fallraum",
    "suggested": true
  }
}

6. Konkretes Power-Level-Profil

Dieses Profil ist restriktiv genug für Gäste, aber lässt Berater echte Moderation machen. Wenn Berater keine Gäste entfernen dürfen, setze kick und redact auf 75 statt 50.

7. Provisioning-Templates

Die Räume sollten nicht von beliebigen Clients erstellt werden, sondern über euren Backend-Service. Der Service ruft /_matrix/client/v3/createRoom mit festen Defaults auf.

Kunden-/Fallraum

{
  "preset": "private_chat",
  "visibility": "private",
  "name": "Fall: ACME / onboarding",
  "topic": "Beratungskanal zwischen ACME und dem zugewiesenen Team",
  "invite": ["@kunde:example.com", "@berater:example.com"],
  "initial_state": [
    {"type":"m.room.join_rules","state_key":"","content":{"join_rule":"invite"}},
    {"type":"m.room.history_visibility","state_key":"","content":{"history_visibility":"joined"}},
    {"type":"m.room.guest_access","state_key":"","content":{"guest_access":"forbidden"}}
  ],
  "power_level_content_override": {
    "users_default": 0,
    "events_default": 0,
    "state_default": 100,
    "invite": 50,
    "kick": 50,
    "ban": 75,
    "redact": 50,
    "notifications": {"room": 50},
    "events": {
      "m.room.name": 50,
      "m.room.topic": 50,
      "m.room.avatar": 50,
      "m.room.power_levels": 100,
      "m.room.join_rules": 100,
      "m.room.history_visibility": 100,
      "m.room.guest_access": 100,
      "m.room.server_acl": 100,
      "m.room.tombstone": 150
    },
    "users": {
      "@berater:example.com": 50,
      "@lead:example.com": 100
    }
  }
}

Interner Beraterraum über Space-Gating

{
  "preset": "private_chat",
  "visibility": "private",
  "initial_state": [
    {"type":"m.room.join_rules","state_key":"","content":{
      "join_rule":"restricted",
      "allow":[{"type":"m.room_membership","room_id":"!berater-space:example.com"}]
    }},
    {"type":"m.room.history_visibility","state_key":"","content":{"history_visibility":"shared"}},
    {"type":"m.room.guest_access","state_key":"","content":{"guest_access":"forbidden"}}
  ]
}

8. Umsetzungsschritte

Decision Matrix

9. Quellen & Spec-Bezug

Die Ausarbeitung basiert auf Matrix Client-Server API und Room-Version-Spezifikation. Relevante Punkte:

• Matrix Client-Server API: Permissions — Power Levels sind raumlokal; empfohlene Nutzer/Moderator/Admin/Creator-Abstufung.
• Matrix Client-Server API: m.room.power_levels — Defaults für users_default, events_default, state_default, invite/kick/ban/redact.
• Matrix Client-Server API: Room Creation — preset, initial_state, power_level_content_override, Reihenfolge der Initialevents.
• Matrix Client-Server API: Room Membership — Membership-Zustände und Join Rules.
• Matrix Client-Server API: Published Room Directory — Directory-Sichtbarkeit ist nicht gleich Join Rule oder History Visibility.
• Matrix Client-Server API: Spaces — Spaces sind Räume mit type: m.space; normale Nachrichten in Space-Räumen sind discouraged.
• Matrix Client-Server API: m.space.child und m.space.parent — Beziehungen zwischen Spaces und Child-Räumen.
• Room Version 12 — Room Creators haben unendlich hohes, unveränderliches Power Level.

Stand: 2026-07-01 · Erstellt als statische HTML-Ausarbeitung für Tobias Wutz.