Skip to main content

Rollenzuordnungen übertragen

Diese Funktion übernimmt die Rollenzuordnungen der gewählten Konfiguration in die appsettings.json einer UAM-Installation. Diese Zuordnungen sind von den App-Rollen der Entra-Registrierungen zu unterscheiden. Die Zieldatei muss vorhanden sein; für die Übertragung sind Lese- und Schreibzugriff auf die Datei sowie Schreibzugriff auf den Zielordner erforderlich.

1. Rollen auswählen und prüfen

  1. Über UAM configuration ist zunächst die gewünschte Konfiguration auszuwählen.
  2. In der Rollenansicht werden die Bereiche UAM, Application, Configuration, Translation und Scheduler angezeigt. Die Spalten Read, Create, Modify und Delete bezeichnen Lesen, Erstellen, Ändern und Löschen. Nicht gesetzte Werte erscheinen als Bindestrich.
  3. Über Apply lässt sich die Übertragung vorbereiten. Der Eintrag wird nur angeboten, wenn mindestens ein Rollenwert weder leer ist noch ausschließlich aus Leerzeichen besteht. Back führt zur Konfigurationsauswahl zurück.

2. Zielordner eingeben

Bei Folder containing appsettings.json: ist der Ordner ohne Dateinamen anzugeben. Als Beispiel kann folgender Pfad dienen:

C:\UAM\Installation

In diesem Beispiel muss C:\UAM\Installation\appsettings.json vorhanden sein. Relative Pfade beziehen sich auf das aktuelle Arbeitsverzeichnis. Ein vollständiger Pfad vermeidet diese Abhängigkeit. Die Rollen bleiben während der Eingabe sichtbar.

Enter bestätigt die Eingabe. Bei einem ungültigen Pfad wird eine Korrektur verlangt. Escape bricht die Eingabe ab und führt zur Rollenansicht zurück.

3. Pfad kontrollieren und Backup auswählen

Anschließend wird der vollständige Zielordner unter den Rollen angezeigt. Vor der Übertragung ist dieser Pfad zu kontrollieren. Die Backup-Auswahl bietet folgende Möglichkeiten:

Auswahl Auswirkung
Yes Zuerst wird eine Sicherung der bestehenden Datei im selben Ordner erstellt; anschließend werden die Rollen übertragen.
No Die Rollen werden ohne vorherige Sicherung übertragen.
Back oder Escape Die Anwendung kehrt zur Pfadeingabe zurück. Der bisherige Pfad ist vorbelegt und bearbeitbar.

Wichtig

Mit der Auswahl von Yes oder No wird die Übertragung unmittelbar gestartet. Eine weitere Bestätigungsfrage erfolgt nicht.

4. Ergebnis prüfen

Der gesamte oberste Abschnitt Roles wird durch die Rollen der gewählten Konfiguration ersetzt. Ein fehlender Abschnitt wird hinzugefügt. Der Rollenblock wird mehrzeilig eingerückt; nicht gesetzte Werte werden nicht als null ausgegeben. Andere Eigenschaften, verschachtelte Roles-Abschnitte und Kommentare außerhalb des ersetzten Blocks bleiben erhalten.

Die Zieldatei muss ein JSON-Objekt enthalten. Kommentare und abschließende Kommas werden unterstützt. Ungültiges JSON und mehrere oberste Roles-Abschnitte werden vor dem Schreiben abgelehnt.

Bei Erfolg erscheint Roles applied to appsettings.json.. Bei gewähltem Backup wird außerdem dessen Pfad angezeigt. Der Sicherungsname enthält appsettings.json, einen Zeitstempel, eine eindeutige Kennung und die Endung .bak.

Falls das gewünschte Backup nicht erstellt werden kann, wird die Übertragung abgebrochen. Fehler erscheinen unter Apply failed. Nach der Ergebnis- oder Fehlermeldung führt Enter zur Rollenansicht zurück.

Ob eine laufende UAM-Installation die geänderte Datei automatisch einliest oder einen Neustart erfordert, ist mit der zuständigen Betreuung zu klären.

Weiterführende Seiten