Skip to Content
Neue Version 12 verfügbar 🎉
LicensingWebanwendungLokale Ausführung

Lokale Ausführung Data Center

Ab Version 12.0 wird die Webanwendung verschlüsselt im Paket des Dienstes ausgeliefert und nur von einem Babel Licensing Service mit Data-Center-Lizenz bereitgestellt. Sie lässt sich nicht von einem separaten statischen Webserver hosten. Um einen Dienst der Edition Server zu verwalten, verwenden Sie die Management API oder Babel Desktop auf dem Rechner des Dienstes.

Der Babel Licensing Service entschlüsselt die Skripte der Webanwendung zur Laufzeit im Arbeitsspeicher, und zwar nur, wenn seine Lizenz die Funktion für die Webanwendung enthält. Wenn Sie die Dateien aus dem Ordner wwwroot des Dienstes auf einen anderen Webserver kopieren, etwa in einen nginx-Container, entsteht daraus keine funktionsfähige Webanwendung.

Einen entfernten Dienst verwalten

Um einen entfernten Babel Licensing Service von Ihrem lokalen Rechner aus einzusehen, installieren Sie Babel Desktop und fügen Sie eine Verbindung zur Lizenzverwaltung mit der Adresse des Dienstes und einem API-Schlüssel hinzu. Babel Desktop arbeitet mit den Editionen Server und Data Center, Profile entfernter Dienste sind jedoch schreibgeschützt: Um Datensätze anzulegen, zu bearbeiten und zu löschen, brauchen Sie ein Profil der Umgebung Lokaler Test mit dem Zugriffsmodus Lokale Verwaltung, das heißt, Babel Desktop läuft auf dem Rechner des Dienstes. Um die Daten eines entfernten Dienstes zu ändern, verwenden Sie die Management API.

Wenn der entfernte Dienst mit der Data-Center-Edition läuft, können Sie die Webanwendung auch direkt im Browser unter der Adresse des Dienstes öffnen.

Den Dienst nur als API ausführen

Um den Dienst nur als API auszuführen, ohne die Webanwendung bereitzustellen, setzen Sie EnableWebUI in der Datei appsettings.json auf false:

"Application": { "EnableWebApi": true, "EnableWebUI": false }

Ist EnableWebUI auf false gesetzt, stellt der Dienst die Dateien der Webanwendung nicht bereit. Die REST-API, gRPC und, sofern eingeschaltet, Swagger und der Endpunkt der Zustandsprüfung bleiben verfügbar, sodass Babel Desktop und andere API-Clients weiter funktionieren.

API-Schlüssel erzeugen

Der API-Schlüssel muss auf dem entfernten Babel Licensing Service erzeugt werden. So erzeugen Sie einen API-Schlüssel:

  1. Öffnen Sie die Webanwendung oder Babel Desktop
  2. Wechseln Sie zum Abschnitt „API Keys“ (API-Schlüssel)
  3. Erstellen Sie einen neuen API-Schlüssel mit den passenden Berechtigungen
  4. Kopieren Sie den erzeugten Schlüssel für die Konfiguration Ihres Clients

Achten Sie darauf, dass der API-Schlüssel ausreichende Berechtigungen für die Vorgänge hat, die Sie ausführen möchten.

Fehlerbehebung

Wenn bei der Verbindung mit dem entfernten Dienst Probleme auftreten:

  1. Netzwerkverbindung prüfen: Stellen Sie sicher, dass Ihr lokaler Rechner den entfernten Server erreicht (zum Beispiel mit ping oder ähnlichen Tools)
  2. API-Schlüssel validieren: Stellen Sie sicher, dass der API-Schlüssel gültig ist und die nötigen Berechtigungen hat
  3. SSL/TLS prüfen: Wenn Sie HTTPS verwenden, prüfen Sie, ob das SSL-Zertifikat gültig und vertrauenswürdig ist
  4. Firewall-Einstellungen: Stellen Sie sicher, dass Ihre Firewall ausgehende Verbindungen zum Port des entfernten Dienstes zulässt
  5. Zustand des Dienstes prüfen: Prüfen Sie über den Endpunkt der Zustandsprüfung (/health) des entfernten Dienstes, ob er betriebsbereit ist
  6. Edition prüfen: Zeigt der Browser die Upgrade-Seite statt der Webanwendung, enthält die Lizenz des Dienstes die Funktion für die Webanwendung nicht. Ersetzen Sie babel.licenses durch eine Data-Center-Lizenz und starten Sie den Dienst neu.

Sicherheitshinweise

Beachten Sie bei der Verbindung mit einem entfernten Lizenzdienst diese bewährten Vorgehensweisen für die Sicherheit:

  1. Verwenden Sie HTTPS für eine sichere Kommunikation
  2. Tauschen Sie API-Schlüssel regelmäßig aus
  3. Wenden Sie das Prinzip der geringsten Rechte an, wenn Sie API-Schlüsseln Berechtigungen zuweisen
  4. Checken Sie keine Konfigurationsdateien mit API-Schlüsseln in die Quellcodeverwaltung ein

Vor Version 12.0 konnten die Dateien der Webanwendung auf einen separaten Webserver kopiert werden, zum Beispiel in einen nginx-Docker-Container, und über eine Datei config.js auf einen entfernten Dienst verweisen. Dieses Verfahren gilt nicht für das Dienstpaket der Version 12.0.

Last updated on