Wie aktiviere oder deaktiviere ich Module?

Ab Tarif Basic

Kurzantwort

Unter Verwaltung → Kategorien ein-/ausblenden blendest du Module aus, die ihr nicht nutzt: Sie verschwinden dann aus der Navigation. Der Schalter Geltungsbereich wählt zwischen „Dieser Mandant” und „Gesamte Instanz” (Letzteres nur als Super-Admin). Wichtig: Das ist reine Sichtbarkeit. Module, die dein Tarif nicht enthält, sind gesperrt („ab Pro” / „ab Elite”) und lassen sich nicht durch Einblenden freischalten: Dafür braucht es eine Lizenz.

Voraussetzungen

Ausblendbar sind alle Module außer dem Kern: Assets, Netzwerk, Software, Lizenzverwaltung, Zertifikate, Compliance, Betrieb, Flexible Daten (Freifelder), Netzwerk-Discovery, Provisionierung, Webhooks, Single Sign-on, Infrastruktur & Mandanten.

Modul-Verwaltung öffnen. Verwaltung → Kategorien ein-/ausblenden („Module, die du nicht nutzt, kannst du ausblenden. Ausgeblendete verschwinden aus der Navigation. Nicht im Tarif enthaltene Module sind gesperrt.”).

Screenshot ausstehend admin-module-lizenz-01 Modul-Verwaltung 'Kategorien ein-/ausblenden' mit Schaltern je Modul und Geltungsbereich-Auswahl

Je Modul ein Schalter; tarifgesperrte Module zeigen 'ab Pro' bzw. 'ab Elite'.
Geltungsbereich wählen. „Dieser Mandant” wirkt nur auf die Benutzer deines Mandanten; „Gesamte Instanz” (Super-Admin) blendet das Modul für alle Mandanten aus.
Module umschalten. Deaktiviere z. B. Zertifikate und Compliance, wenn ihr sie nicht einsetzt: Die Navigation wird sofort schlanker. Gesperrte Module tragen den Hinweis „ab <Tarif>” und lassen sich nicht aktivieren.

Die Sichtbarkeit steuert /api/v1/admin/modules mit dem Query-Parameter scope=tenant|instance:

curl -H "Authorization: Bearer inv_dein_token" \
  "https://demo.notory.io/api/v1/admin/modules?scope=tenant"

{
  "scope": "tenant",
  "hidden": ["certificates"],
  "modules": [
    { "key": "assets",       "entitled": true,  "hidden": false },
    { "key": "certificates", "entitled": true,  "hidden": true },
    { "key": "webhooks",     "entitled": false, "hidden": false }
  ]
}

curl -X PUT "https://demo.notory.io/api/v1/admin/modules?scope=tenant" \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{ "hidden": ["certificates", "compliance"] }'

Instanzweit analog mit scope=instance (nur Super-Admin).

Mögliche Fehler: 403 („Only a super-admin can change instance-wide module visibility”), 422 (ungültiger scope). Unbekannte Modul-Schlüssel in hidden werden bereinigt.

Was passiert dabei?

Drei Bedingungen für die Sichtbarkeit. Ein Modul erscheint in der Navigation, wenn es (1) im Tarif enthalten ist (entitled), (2) nicht instanzweit versteckt und (3) nicht im Mandanten versteckt wurde. Tarifgesperrte Module bleiben unabhängig von den Schaltern verborgen bzw. gesperrt markiert.
Sichtbarkeit ≠ Berechtigung. Das Ausblenden räumt die Oberfläche auf, ist aber keine Sicherheitsmaßnahme: Die API-Endpunkte des Moduls bleiben für Berechtigte nutzbar. Zugriff steuerst du über Rollen & Berechtigungen; den Funktionsumfang über die Lizenz.
Frontend liest Entitlements. Die Oberfläche fragt einmalig GET /api/v1/entitlements ab und sperrt Navigation und Buttons im Voraus, statt Benutzer in 403-Fehler laufen zu lassen. Gesperrte Module zeigen den Upgrade-Hinweis („Das Modul … ist in Ihrem aktuellen Tarif … nicht enthalten”).
Zwei Ebenen, klare Vorfahrt. Die instanzweite Liste (Super-Admin) schlägt die Mandanten-Liste: Was die Instanz versteckt, kann ein Mandant nicht wieder einblenden.
Kern bleibt immer an. Dashboard/Kernfunktionen sind nicht abschaltbar.