> [← open.SERVICE](<open.SERVICE Plugin Overview.md>) # Einrichtung und Berechtigungen Der Server richtet beim Start selbst ein, was sich automatisch einrichten lässt: die Konfiguration je Mandant mit Vorgabewerten, die Alarm-Secrets, die Alarm-Aktionen samt Webhook und die Berechtigungs-Keys des Moduls. Drei Dinge bleiben für einen Administrator. ## 1 · Das Alarm-Secret in open.WARE eintragen Unter **`/setup`** steht ein Abschnitt „open.SERVICE" mit einer Prüfliste: was eingerichtet ist, was fehlt, und was nur ein Mensch liefern kann. Dort lesen Sie das erzeugte Secret ab und tragen es in open.WARE ein. Ohne diesen Schritt können Alarme keine Wartungstermine erzeugen; der Endpunkt antwortet dann mit `unknown tenant or invalid secret`. ## 2 · Berechtigungen an Rollen vergeben Die Keys sind registriert, aber noch keiner Rolle zugewiesen. | Key | Erlaubt | | ------------------------------------------------- | -------------------------------------------------------------- | | `openservice-schedule:can-access-schedule-plugin` | **Zugang zum Wartungsmodul** — ohne diesen Key nichts davon | | `openservice-schedule:can-create-schedule` | Wartungspläne anlegen | | `openservice-schedule:can-delete-schedule` | Wartungspläne archivieren | | `openservice-schedule:can-perform-execution` | Wartung durchführen und protokollieren | | `openservice-schedule:can-manage-template` | Wartungsvorlagen pflegen | | `service:can-read-ticket` | Tickets sehen | | `service:can-create-ticket` | Tickets anlegen | | `service:can-edit-ticket` | Tickets bearbeiten | | `service:can-delete-ticket` | Tickets löschen | | `service:can-assign-ticket` | Tickets zuweisen | | `service:can-manage-masterdata` | Stammdaten pflegen (Maschinen, Kontakte, Unternehmen, Artikel) | | `service:can-manage-formconfig` | Ticketformulare konfigurieren | | `service:can-create-tag` | Tags direkt aus einem Tag-Feld anlegen | | `service:can-view-analytics` | Auswertungen | > [!info] Für einzelne Wartungspläne gibt es kein Lese- und kein Bearbeitungsrecht > Wer einen bestimmten Plan sehen und ändern darf, entscheidet nicht eine > Berechtigung, sondern der Plan selbst — über seinen Ersteller und seine > Zuweisungen. Siehe > [[End-User/Modules/open.SERVICE/features/Schedules|Wartungspläne]]. Eine mögliche Aufteilung als Ausgangspunkt: | Rolle | Zugang | Plan anlegen / archivieren | Durchführen | Vorlagen | Stammdaten | Auswertungen | | ----------------------- | :----: | :------------------------: | :---------: | :------: | :--------: | :----------: | | Wartungsleitung | ✓ | ✓ / ✓ | ✓ | ✓ | ✓ | ✓ | | Techniker | ✓ | – / – | ✓ | – | lesend | – | | Dienstleister (extern) | ✓ | – / – | ✓ | – | – | – | | Betrachter / Management | ✓ | – / – | – | – | lesend | ✓ | ## 3 · Dienstleister-Rolle bestücken (falls benötigt) Beim ersten Dienstleister-Zugang entsteht die Rolle `od-service-provider-<mandant>` ohne Rechte. Welche ein Dienstleister bekommen soll, ist Ihre Entscheidung — siehe [[End-User/Modules/open.SERVICE/features/Dienstleister|Dienstleister]]. ## Beim Update aus einer älteren Version > [!warning] Alarm-Secrets erneuern > In älteren Versionen war die Modulkonfiguration für alle Benutzer des Mandanten > lesbar. Wenn Ihre Installation von einem solchen Stand aktualisiert wurde, > erneuern Sie bitte die Alarm-Secrets unter `/setup` und tragen Sie die neuen > Werte in open.WARE ein. ## Nicht automatisch Die **Outlook-Zugangsdaten** lassen sich nicht vorbelegen, weil dafür das `client_secret` Ihres Mandanten nötig ist. ## Verwandt - [[End-User/Modules/open.SERVICE/Seiten und Routen|Seiten und Routen]] - [[Developer/open.SERVICE/Berechtigungen|Berechtigungen (Developer)]]