Explorer: Rechte und Sicherheit

• Nicht definierter Typ

Dieses Dokument erklärt, wie man die Baumbearbeitung im Immersive Explorer aktiviert und verwendet. Es richtet sich an Integratoren, immersive Administratoren und autorisierte Benutzer.

Es befasst sich nur mit der Nutzung der Benutzeroberfläche: Aktivieren von Befehlen, Zuweisung von Rechten, Erstellen, Ändern und Löschen eines Immersiv-Ordners.

1. Allgemeines Prinzip

Der Bearbeitungsmodus basiert auf zwei zusätzlichen Bedingungen:

1. Der Integrator fordert die Darstellung der Bearbeitungsfunktionen mit EnableEditing: true ;
2. der eingeloggte Nutzer hat das notwendige Recht auf den betreffenden Immersiv-Ordner.

Die Kommandoleiste kann bieten:

• Neuer Ordner ;
• Bearbeitung ;
• Löschen ;
• Aktualisieren.

Unautorisierte Befehle werden nicht angezeigt. Prüfungen werden auch beim Öffnen des Panels und beim Speichern durchgeführt.

2. Bearbeiten mit EnableEditing

Der Bearbeitungsmodus ist in der JavaScript-Bibliothek standardmäßig deaktiviert.

const explorer = new MediaExplorer(
    document.getElementById("MediaExplorerHost"),
    {
        RootFolderIdentifier: 15,
        EnableEditing: true
    }
);

await explorer.initialize();

Die von RestFrontage bereitgestellte Explorer-Seite aktiviert diesen Modus bereits. Eine Client-Anwendung muss diesen Modus explizit aktivieren, wenn sie die Komponente selbst erstellt.

EnableEditing	Benutzerrechte	Ergebnis in der Schnittstelle
false oder abwesend	Jede	Die Bearbeitungssteuerung ist versteckt. Aktualisieren bleibt verfügbar.
true	Kein Änderungsrecht	Unautorisierte Befehle bleiben verborgen.
true	ein oder mehrere Rechte	Es werden nur Befehle angezeigt, die diesen Rechten entsprechen.

3. Vom Explorer genutzte Rechte

Die Rechte beziehen sich auf den aktuellen Immersiv-Ordner.

Recht	Flagge	Wirkung im Explorer
Folder See	1	Ermöglicht es, den Ordner anzuzeigen.
Folder Read	3	Ermöglicht die Ansicht des Inhalts des Ordners.
Folder Modify	5	Plakat Bearbeitung und autorisiert die Änderung von Namen und Beschreibung.
Folder Write	11	Plakat Neuer Ordner und autorisiert die Erschaffung eines Kindes. Dieses Recht wird auch genutzt, um Medien hinzuzufügen, sobald sie verfügbar sind.
Folder FullControl	15	Plakat Löschen und enthält alle vorherigen Rechte.

Rechte Modify und Write Erfüllen unterschiedliche Bedürfnisse: Ein Nutzer, der die Berechtigung hat, ein Kind zu erstellen, hat möglicherweise keine Berechtigung, den Elternordner umzubenennen.

3.1 Immer autorisierte Benutzer

Die folgenden Profile enthalten alle Steuerungen zur Verwaltung von Immersiver-Ordnern:

• Cerebrates;
• Globale Gruppenmitglieder Administrators die tägliche Organisation;
• Globale Gruppenmitglieder DomainAdministrators auf dem aktuellen Server.

Diese Regel ist unabhängig von EnableEditing. Um die Befehle zu sehen, muss die Option in der Komponente noch aktiv sein.

3.2 Blob-Ordner

Ein immersiver Ordner mit einem Blob-Virtueller Pfad wird zu einem schreibgeschützten Bearbeitungspunkt.

In diesem Ordner und seinem Blob-Baum:

• Neuer Ordner, Bearbeitung und Löschen werden nicht angeboten;
• Aktualisieren und die Navigation bleibt verfügbar;
• Immersive Folder-Bearbeitungsrechte erlauben es nicht, den Inhalt des Blobs aus dem Explorer zu bearbeiten.

4. Bereite die Rechte einer Organisation vor

Rechte werden organisationsweit vergeben. Die empfohlene Methode ist, Berechtigungsgruppen zu verwenden und Benutzer dann in die Gruppen einzuordnen, die ihrer Rolle entsprechen.

4.1 Überprüfung der Sicherheitsstruktur

In RestFrontage:

1. Offen Sicherheit ;
2. Offen Sicherheitstools ;
3. in Sicherheitsstruktur von Organisationen, auswählen Starte die Prüfung ;
4. die betreffende Organisation überwachen;
5. wenn seine Bedingung ist Unvollständig, verwenden Regularize.

Die Regularisierung schafft nur die fehlenden Standardelemente. Sie bewahrt bestehende Nutzer, Gruppen, Mitgliedschaften und Berechtigungen.

Die Organisation muss:

• Eine Einheit Gruppen ;
• Eine Einheit Nutzer ;
• Gruppen Administrators und Users ;
• Ein Organisationsadministrator, der Mitglied ist von Administrators.

4.2 Auswahl einer Berechtigungsgruppe

Anerkannte Berechtigungsgruppen für Unterlagen folgen folgender Konvention:

Organisationsgruppe	Beratende Rolle
Folder SeeFolder	Sehen Sie sich die Ordner an, ohne deren Inhalt zu konsultieren.
Folder ReadFolder	Konsultieren Sie die Baumstruktur und die Medien.
Folder ModifyFolder	Ändere den Namen und die Beschreibung der Ordner.
Folder WriteFolder	Erstelle Unterordner.
Folder FullControlFolder	Verwalten Sie die Unterlagen vollständig, einschließlich ihrer Löschung.

Diese Gruppen müssen in die Einheit eingeteilt werden Gruppen der betreffenden Organisation. Wenn sie nicht existieren, kann ein Sicherheitsadministrator sie aus Security Explorer erstellen, indem er ihren genauen Namen respektiert.

4.3 Hinzufügen eines Benutzers zu einer Gruppe

In der Schnittstelle sind zwei Pfade möglich.

Vom Nutzer

1. Offen Sicherheit, dann Nutzer und Gruppen ;
2. Wählen Sie den Benutzer aus.
3. In der Gegend Gruppen, wähle Gruppen verwalten ;
4. Fügen Sie die notwendigen Berechtigungsgruppen hinzu.
5. Validiere das Panel.

Aus der Gruppe

1. Offen Sicherheit, dann Nutzer und Gruppen ;
2. Wählen Sie die Berechtigungsgruppe.
3. In der Gegend Mitglieder, wähle Mitglieder verwalten ;
4. Auswahl Mitglied hinzufügen ;
5. Wähle aus, welche Nutzer oder Gruppen du hinzufügen möchtest.
6. Validieren mit In den Warenkorb legen.

Gruppen können als Mitglieder verwendet werden, um dieselbe Rolle mehreren Nutzern zuzuweisen.

4.4 Rechte auf bestehende Ordner anwenden

Das Hinzufügen eines Benutzers zu einer Gruppe reicht nur aus, wenn die Gruppe bereits ein Recht auf die betreffenden Ordner hat.

Um automatische Rechte zu überprüfen und abzuschließen:

1. Offen Sicherheit, dann Sicherheitstools ;
2. in Automatische Rechte bestehender Objekte, auswählen Starte die Prüfung ;
3. Wählen Sie den Objekttyp Ordner ;
4. Wählen Sie die Organisation aus.
5. Wähle Aktualisieren ;
6. den Status jeder Datei überprüfen;
7. Verwendung Regularize auf einem Ordner oder Regularisieren Sie die Auswahl für mehrere Fälle.

Status	Bedeutung	Empfohlene Maßnahme
Ausverkauft	Alle erwarteten automatischen Rechte sind vorhanden.	Keine.
Unvollständig	Ein oder mehrere automatische Rechte fehlen.	Verwendung Regularize.
Konfiguration	Die Rechtepolitik oder -organisation kann nicht gelöst werden.	Korrigiere die Konfiguration vor der erneuten Prüfung.

Die Anpassung fügt nur die fehlenden automatischen Rechte hinzu. Sie entfernt nicht die anderen bestehenden Rechte.

4.5 Neue Aktengebühren

Wenn ein Ordner erstellt wird, werden die automatischen Rechte der Organisation sofort darauf angewendet.

Die empfohlene Richtlinie lautet:

Begünstigter	Empfohlen rechts
Gruppe Users Der Organisation	Folder Read
Gruppe Administrators Der Organisation	Folder FullControl
Spezialisierte Erlaubnisgruppe	rechts, das dem Namen der Gruppe entspricht

Die Definition dieser Richtlinie ist eine Serveroperation. Die HMI Automatische Rechte bestehender Objekte erlaubt, dass sie kontrolliert und durchgesetzt wird, dient aber nicht dazu, die Politik selbst zu erfinden oder zu verändern.

5. Explorer-Kommandoleiste

Die Befehlsleiste befindet sich über dem Baum und dem Inhalt.

Bestellung	Anzeigezustand	Aktion
Neuer Ordner	EnableEditing: true und Recht Folder Write in der aktuellen Akte.	Öffnen Sie das Panel Einen Ordner erstellen.
Bearbeitung	EnableEditing: true und Recht Folder Modify in der aktuellen Akte.	Öffnen Sie das Panel Ordner bearbeiten.
Löschen	EnableEditing: true und Recht Folder FullControl in der aktuellen Akte.	Öffnen Sie das Panel Ordner löschen.
Aktualisieren	Immer verfügbar	Lädt die Baumansicht und den aktuellen Inhalt neu.

Nur im allgemeinen Ursprung des Explorers Neuer Ordner und Aktualisieren kann vorgeschlagen werden. Der allgemeine Root ist kein Immersiver-Ordner, daher kann er nicht geändert oder gelöscht werden.

Ein Nicht-Admin-Benutzer kann in diesem Root erstellen, falls er dies hat Folder Write auf mindestens einem Root-Ordner in der Organisation. Der neue Ordner wird in der aktuellen Organisation erstellt.

6. Panel "Ordner erstellen"

Die Neuer Ordner öffnet ein Panel, ohne die Seite neu zu laden.

Der Untertitel gibt an, wo du erstellen möchtest:

• im aktuellen Immersiver-Ordner.
• oder an der Wurzel der aktuellen Organisation.

Spielfeld	Erforderlich	Beschreibung
Name	Ja	Der Name des neuen Immersiv-Ordners.
Beschreibung	Nein	Text, der die Nutzung der Datei beschreibt.
Blob-Virtueller Pfad	Nein	Die Root-URL eines Blob-Containers. Wenn er befüllt wird, wird der Ordner zu einem schreibgeschützten Mount-Punkt.

Verfügbare Aktionen:

• Erstellen Sie Speichert den Ordner und aktualisiert dann den Explorer.
• Stornieren Schließt das Panel ohne Modifikation.

Wenn ein Fehler auftritt, bleibt das Panel offen und zeigt die Nachricht an. Der bereits eingegebene Inhalt wird behalten, um Korrekturen zu ermöglichen.

7. Panel "Ordner bearbeiten"

Die Bearbeitung handelt auf dem derzeit geöffneten Immersiver-Ordner.

Das Panel präsentiert zunächst zwei nicht bearbeitbare Quellen:

Referenz	Verwendung
Immersive Ordner-ID	Wert, der verwendet werden soll in RootFolderIdentifier.
Relativer Pfad von der Wurzel	Wert, der verwendet werden soll in RelativePath. Ein Root-Ordner zeigt einen leeren Wert an.

Jede Referenz hat ein Kopiersymbol. So können Sie den Wert direkt kopieren, ohne den Eindruck zu erwecken, dass er bearbeitbar ist.

Die bearbeitbaren Felder sind:

• Name ;
• Beschreibung.

Verfügbare Aktionen:

• Speichern Die Änderungen werden angewendet und dann der Baum, die Breadcrumbs und der Inhalt aktualisiert.
• Stornieren Schließt das Panel ohne Modifikation.

Der angezeigte relative Pfad wird aus der Wurzel des Explorers berechnet. Er kann daher je nach der RootFolderIdentifier wird von der Integration verwendet.

8. "Ordner löschen"-Panel

Die Löschen Öffnet ein Bestätigungspanel.

8.1 Leerer Ordner

Das Schild zeigt an, dass die Operation endgültig ist.

• Löschen bestätigt die Operation;
• Stornieren Schließt das Panel ohne Modifikation.

Nach der Löschung kehrt der Explorer zum Elternteil des Ordners zurück und aktualisiert den Baum.

8.2 Nicht-leerer Ordner

Die Löschung wird verweigert, wenn der Ordner noch enthält:

• Ein immersiver Unterordner.
• ein immersives Medium.

Das Panel zeigt dann eine Warnung an und bietet nur noch ein Angebot Schließen. Die Datei muss geleert werden, bevor man wieder beginnt.

9. Aktualisieren nach einer Änderung der Rechte

Nach einer Gruppenänderung oder Regularisierung der Rechte:

1. zur Explorer zurückkehren;
2. Verwendung Aktualisieren ;
3. Falls nötig, öffnen Sie die betreffende Akte erneut.

Eine Wiederanbindung kann erforderlich sein, wenn die Gruppenmitgliedschaft in der aktuellen Sitzung beibehalten wird.

10. Fehlerbehebung

Kein Bearbeiten-Button erscheint

Überprüfen Sie nacheinander:

• dass EnableEditing ist es wert true ;
• dass der Benutzer authentifiziert ist;
• dass er zur richtigen Gruppe bei der Organisation der Akte gehört;
• dass die Überprüfung der Rechte der Akte anzeigt Ausverkauft ;
• Der aktuelle Ordner ist kein Blob-Mount-Punkt.
• dass die Client-Integration die erwartete Panel-Infrastruktur lädt.

"Neuer Ordner" erscheint, aber "Bearbeiten" nicht

Nutzerbesitz Folder Write, aber nicht Folder Modify. Füge die Changegroup hinzu, falls eine Umbenennung erlaubt sein sollte.

"Bearbeiten" erscheint, aber "Löschen" nicht

Nutzerbesitz Folder Modify, aber nicht Folder FullControl. Freiwillige Entfernung erfordert die höchste Stufe.

Das Entfernungspanel verweigert die Operation

Der Ordner enthält weiterhin einen Unterordner oder immersive Medien. Löschen oder verschieben Sie den Inhalt, bevor Sie von vorne beginnen.

Buttons entwickeln sich nach einer Änderung der Rechte nicht weiter

• Verwendung Aktualisieren ;
• öffne die Datei erneut;
• Melden Sie sich ab und melden Sie sich dann wieder an, wenn sich die Gruppenzugehörigkeit geändert hat.
• Starten Sie die automatische Rechteprüfung erneut.

11. Checkliste für die Indienststellung

• EnableEditing ist nur in Integrationen aktiviert, die die Ausgabe anbieten müssen.
• Die Organisation verfügt über eine umfassende Sicherheitsstruktur.
• Die notwendigen Ordnerberechtigungsgruppen existieren in der Einheit Gruppen der Organisation.
• Nutzer sind Mitglieder der Gruppen, die ihrer Rolle entsprechen.
• Die Standardrichtlinie weist das Lesen an Benutzer und die volle Kontrolle an Organisationsadministratoren zu.
• Die Prüfung Automatische Rechte bestehender Objekte für den Typ vollständig ist Ordner.
• Blob-Ordner werden weiterhin als schreibgeschützte Ordner verwendet.
• Das Erstellen, Bearbeiten, Löschen eines leeren Ordners und das Ablehnen eines nicht leeren Ordners wurden getestet.
• Die Anzeige wurde von einem Computer und mit einer kleinen Auflösung gesteuert.