Die empower® Web App einrichten

Benötigte Berechtigungen: IT-Admin

Dieser Artikel beschreibt die Einrichtung der empower® Web App und des empower® Web Sync sowie wichtige Voraussetzungen.

Anmerkung

Um die empower® Web-Komponenten in den Office-Online-Anwendungen nutzen zu können, müssen nach der initialen Einrichtung die Manifest-Dateien verteilt werden.

Für weitere Informationen zur Einrichtung der Web-Komponenten in Office Online siehe Die empower® Web-Komponenten für Office Online einrichten.

Voraussetzungen

Um die empower® Web App und Web-Komponenten einrichten zu können, muss das empower® Backend einer Version 9.2 oder höher bereits installiert sein.

Für Versionen vor Version 9.7 installiert der empower® Backend Installer die empower® Web-Komponenten nicht mit.

Eine manuelle Installation ist notwendig.

Anmerkung

Für weitere Informationen zur Installation des empower® Backends ab Version 9.7 siehe Das empower® Backend installieren (Version >= 9.7).

Diese Installation beinhaltet die Web-Komponenten. Wenn Sie ein empower® Backend der Version 9.7 oder höher installiert haben, müssen Sie den Anweisungen in diesem Artikel nicht folgen.

Den Web Sync installieren

Für die Installation des empower® Web Sync – die Grundlage für die Verwendung der empower® Web App und Web-Komponenten – stellt Ihnen der empower® Support ein separates Installationspaket zur Verfügung, das die folgenden Dateien enthält:

  • WebLibrary_Installer.exe

    Das ist die Installationsdatei für den empower® Web Sync.

  • installer-config.json

    Das ist eine Konfigurationsdatei, die Informationen zu den notwendigen Änderungen an der Backend-Konfiguration enthält.

  • IdentityServiceConfig_Updater.exe (optional)

    Diese Datei wird nur benötigt, wenn Sie empower® Mails Online verwenden möchten.

Wichtig

Wenn Sie empower® in der empower® Cloud hosten, nimmt der empower® Support die benötigten Änderungen vor und führt die Installation aus.

In diesem Fall müssen Sie den Anweisungen in diesem Abschnitt nicht folgen.

Um den empower® Web Sync zu installieren, gehen Sie wie folgt vor:

  1. Legen Sie die Dateien WebLibrary_Installer.exe und installer-config.json im aktuellen Installationsverzeichnis des Backends ab.

    Wenn Sie empower® Mails Online verwenden möchten, legen Sie auch die Datei IdentityServiceConfig_Updater.exe ab.

    Der jeweilige Pfad sollte dem folgenden entsprechen:

    C:\Program Files (x86)\empower\backend\ServiceHost\Services

  2. Wenn der Speicherort für das Installationsverzeichnis des Backends nicht dem Standard entspricht, muss diese Information in der Datei installer-config.json angepasst werden.

    Der folgende Wert ist standardmäßig voreingestellt:

    {
"programDataLocation":"C:\\ProgramData\\empower\\backend\\empower"
}

  3. Wenn Sie empower® Mails Online (die Web-Komponente für Outlook) verwenden möchten, passen Sie die Datei installer-config.json entsprechend an.

    Wenn Sie empower® Mails Online nicht verwenden möchten, sind keine weiteren Anpassungen an der Datei notwendig.

    1. Um Single Sign-On zu aktivieren, geben Sie die Werte für ApplicationId und ApplicationIdUri in der .json-Datei ein:

      {
  ...
  "Sso" : {
    "ApplicationId": "[APPLICATION ID]",
    "ApplicationIdUri": "[APPLICATION ID URI]",
  }
  ...
}

      Die Werte finden Sie in der App-Registrierung, die Sie für die Verwendung mit empower® Mails Online angepasst haben.

      Für weitere Informationen siehe App-Registrierung für empower® Mails Online anpassen.

    2. Um die Authentifizierungsmethode korrekt einzurichten, geben Sie die Werte für AzureTenantId und AllowedAudiences in der .json-Datei ein:

      {
  ... 
  "ForeignIdToken": {
    "AzureTenantId": "[TENANT ID]",
    "AllowedAudiences": [ "[CLIENT ID]" ]
  } 
  ...
}

      Geben Sie für die Platzhalter [TENANT ID] und [CLIENT ID] die Tenant-ID und die Client-ID aus der App-Registrierung ein, die Sie für empower® erstellt haben.

  4. Um den Installer auszuführen, klicken Sie mit einem Doppelklick auf die Datei WebLibrary_Installer.exe.

    Nach der Installation bleiben der Installer, die Konfigurationsdatei und ein neuer Ordner namens WebLibrary_Installer im Installationsverzeichnis zurück.

  5. Wenn Sie empower® Mails Online verwenden möchten und die Datei installer-config.json entsprechend konfiguriert haben, führen Sie die Datei IdentityServiceConfig_Updater.exe aus.

    Wenn Sie empower® Mails Online nicht verwenden möchten, können Sie diesen Schritt überspringen.

  6. Entfernen Sie die verbleibenden Dateien WebLibrary_Installer.exe, installer-config.json und den neuen Ordner WebLibrary_Installer/.
image.webp

In der Standardkonfiguration kann die empower® Web App nun über den folgenden Link abgerufen werden:

https://[BASE URL]/empower/websync/app

Anmerkung

Ersetzen Sie den Platzhalter für die Basis-URL mit der Basis-URL Ihres Unternehmens.

Den Web Sync updaten

Ein Update des Web Syncs funktioniert wie die Neuinstallation.

Der Installer erkennt, wenn es bereits eine Instanz des empower® Web Syncs gibt, nimmt diesen offline und tauscht die jeweiligen Dateien aus.

Sie können daher den Anweisungen zur Installation des empower® Web Syncs folgen.

Wenn Sie empower® Mails Online verwenden, stellen Sie sicher, dass Sie die Datei IdentityServiceConfig_Updater.exe jedes Mal ausführen, wenn Sie das empower® Backend updaten.

Wichtig

Da die empower® Web App und Web-Komponenten zusammen mit dem empower® Release veröffentlicht werden, updaten Sie immer zuerst das Backend und dann den Web Sync.

Andernfalls überschreibt die Installation des Backends die Einstellungen.

War dieser Beitrag hilfreich?

/

Kommentare

0 Kommentare

Zu diesem Beitrag können keine Kommentare hinterlassen werden.