Access Key Manager

Dieses Kapitel stellt mit dem Access Key Manager eine Oberfläche zur Verwaltung von Zugriffsschlüsseln vor.

Allgemeines

Für die Verwaltung von Zugriffsschlüsseln steht mit dem Access Key Manager eine Web Component in deutscher und englischer Sprache bereit. Damit lassen sich Zugriffsschlüssel betrachten, hinzufügen, aktualisieren und löschen. Die Web Componente unterstützt das Format vollständig mit allen Eigenschaften. Zusätzlich sind Information wie der Ersteller, das Erstelldatum, der letzte Änderer und das Datum der letzten Änderung sichtbar. Die Zugriffsschlüssel werden initial sortiert anhand der letzten Änderung absteigend sortiert ausgegeben. Für die Einbindung sind dennoch diverse Voraussetzungen notwendig. Die Web Component besitzt keinen Shadow DOM, somit werden übergeordnete Styles übernommen. Abbildung 1 zeigt einen Screenshot der eingebundenen Web Component.

Voraussetzungen

Voraussetzungen für die Nutzung sind die Einbindungen von accessKeyManager.js, Vue.js V2 und Bootstrap V4. Kurzerhand kann die Web Component anschließend über <access-key-manager /> im HTML eingebunden werden, ein nutzbares Template steht bereit.

Konfiguration

Die Verwaltung geschieht über die REST-API V2, die Autorisierung geschieht über JWT. Dafür ist die Web Component auf die WebApplicationBaseURL angewiesen, die im Javascript Global Namespace respektive window Objekt unter webApplicationBaseURL verfügbar sein muss:

1
2
3

<script>
  const webApplicationBaseURL = <!--WebApplicationBaseURL-->;
</script>

Die Id eines zu verwaltenden Objekts sollte grundsätzlich im Query-String der Seite, die die Component einbindet, mit objectID verfügbar sein, beispielsweise <WebApplicationBaseURL>/accesskeys/manager.xml?objectID=<Id>.
Achtung: Die Id muss eine achtstellige Zahl sein, sonst können möglicherweise Probleme auftreten. Alternativ kann die Id dennoch im window Objekt unter objectID gesetzt werden:

1
2
3

<script>
  const objectID = <!--Id-->;
</script>

Achtung: Bei einem Derivat muss analog zu einem Objekt zusätzlich die Id des Parent Objekts angegeben werden mit parentID im Query-String oder window Objekt: <WebApplicationBaseURL>/accesskeys/manager.xml?objectID=<Id>&parentID=<Parent>.

Optional kann die Sprache explizit über currentLang im window Objekt eingestellt werden, ansonsten wird die Sprache als Fallback auf dem HTML oder der Browser-Umgebung abgeleitet. Der Manager steht in de (Deutsch) und en (Englisch) zur Verfügung:

1
2
3

<script>
  const currentLang = <!--{de, en}-->;
</script>

Standardmäßig nimmt der Manager an, dass der temporärer Zugriff möglich ist und zeigt bei der Erstellung eines Zugriffsschlüssel die URL für den direkt Zugriff an. Um dies zu deaktivieren, kann muss im window Objekt accessKeySession auf "false" gesetzt werden:

1
2
3

<script>
  const accessKeySession= "false";
</script>