Manuelles Bearbeiten der Konfiguration des EMS-Servers

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu Einrichten des EMS-Servers


Der EMS-Server ist nach der ersten Konfiguration Ihrer EMS-Umgebung mit Standardparametern konfiguriert.

Sie können die EMS-Serverkonfiguration ändern, indem Sie die Datei EMSServer.ini in C:\Benutzer\Öffentlich\Öffentliche Dokumente\Embarcadero\EMS bearbeiten. Wenn Sie diese Datei ändern, müssen Sie den EMS-Server beenden und neu starten, um die Datei emsserver.ini neu zu laden.

Konfiguration der EMS-Datenbank

Sie können die Standardinformationen der EMS-Datenbank, die der EMS-Server verwendet, ändern. Suchen Sie in der Datei EMSServer.ini den Abschnitt [Data]:

  • InstanceName. Gibt die InterBase-Instanz an, die die EMS-Datenbank hostet.
  • Database. EMS-Datenbankdatei im lokalen Verzeichnis.
  • UserName. Benutzername für den Zugriff auf die EMS-Datenbank.
  • Password. Passwort für den Zugriff auf die EMS-Datenbank.
  • SEPassword. Passwort für die Verbindung mit einer verschlüsselten InterBase-Datenbank.
  • Pooled. Aktiviert das [[Multithreading (FireDAC)# Verbindungs-Pooling|FireDAC-Verbindungs-Pooling]] mit der EMS-Datenbank, um die Wartezeit zu reduzieren.
  • PooledMax. Maximal zulässige Anzahl der in den Pool gestellten Verbindungen zur EMS-Datenbank.
[Data]
; Interbase connection parameters
InstanceName=EMS
Database=C:\Users\Public\Documents\Embarcadero\EMS\emsserver.ib
UserName=sysdba
Password=masterkey
SEPassword=
;# SEPassword connects to an encrypted database
Pooled=
;# Set Pooled=0 to disable connection pooled, Pooled=1 to enable. Default value is 1.
PooledMax=
;# Set PooledMax=10 to limit maximum pooled connection.  Default value is 50.

EMS-Serverbeschränkungen

Sie können die Standardinformation der Anzahl der simultanen Verbindungen zur EMS-Datenbank oder die maximale Anzahl der EMS-Benutzer ändern. Suchen Sie in der Datei EMSServer.ini den Abschnitt [Server.Limits]:

  • MaxConnections. Maximale Anzahl gleichzeitiger HTTP-Anforderungen an den EMS-Server.
  • MaxUsers. Maximal zulässige Anzahl der EMS-Benutzer in der EMS-Datenbank. Dieser Wert hängt von der verwendeten EMS-Lizenz ab.
[Server.Limits]
MaxConnections=
;# Set MaxConnections=10 to limit maximum concurrent HTTP requests.  Default is 32.
MaxUsers=
;# Set MaxUsers=3 to limit the number of users in the EMS database.  This value is only used 
;# when less than the maximum users permitted by the EMS runtime license.

Konfiguration der EMS-Server-Authentifizierung

Sie können die Standardinformationen für die Authentifizierung bei Ihrem EMS-Server ändern. Suchen Sie in der Datei EMSServer.ini den Abschnitt [Server.Keys]:

  • MasterSecret. Schlüssel, mit dem alle Vorgänge ohne Berücksichtigung des Eigentümers durchgeführt werden können (z. B. einen beliebigen Benutzer in der EMS-Datenbank aktualisieren).
  • AppSecret. Schlüssel, mit dem beliebige Anforderungen an die autorisierten Endpunkte vorgenommen werden können.
  • ApplicationID. Bezeichner für den EMS-Server. Dieser Bezeichner unterscheidet EMS-Server. Anforderungen von den EMS-Clients werden zurückgewiesen, wenn die ApplicationID in der Anforderung nicht mit der für den EMS-Server definierten ApplicationID übereinstimmt.
[Server.Keys]
MasterSecret=MasterSecretKey
AppSecret=AppSecretKey
ApplicationID=ApplicationIDKey

Sie können auch Zugriffsregeln festlegen, um den Zugriff auf eine EMS-Ressource oder einen EMS-Endpunkt zuzulassen oder zu verweigern. Suchen Sie in der Datei EMSServer.ini den Abschnitt [Server.Authorization], und fügen Sie Ihre benutzerdefinierten Zugriffsregeln hinzu.

[Server.Authorization]
Users={"public": false}
Users.LoginUser={"public": true}
Users.SignupUser={"public": true}

Plattformübergreifende Domäne für EMS-Server-API

Sie können die Berechtigung bearbeiten, um verschiedenen Domänen (außerhalb der EMS-Server-Domäne) die HTTP-Anforderungen an den als public deklarierten EMS-Server-API zu erlauben. Gehen Sie in der EMSServer.ini-Datei zum [Server.APICrossDomain]-Abschnitt:

  • CrossDomain. Liste der Domänen, mit denen domänenübergreifende HTTP-Anforderungen an die EMS-Server-API gestellt werden können. Um jede Domäne zuzulassen, verwenden Sie den Wert mit dem Platzhalterzeichen *.
[Server.APICrossDomain]
;# Write here the domains allowed to call the API. Used for Cross-Domains
CrossDomain = *

EMS-Serververbindung

Sie können die Standardinformationen für die Verbindung mit Ihrem EMS-Server ändern. Suchen Sie in der Datei EMSServer.ini den Abschnitt [Server.Connection.Dev]:

  • Port. Legt den Verbindungs-Port für die HTTP-Anforderung an den EMS-Server fest.
  • HTTPS. Aktiviert die HTTPS-Unterstützung für den EMS-Server. Falls aktiviert, müssen Sie OpenSSL installieren und die Zertifizierungsdateiinformationen konfigurieren.
  • CertFile. Absoluter Pfad zu der selbstsignierten Zertifizierungsdatei (.pem-Datei).
  • RootCertFile. Absoluter Pfad zu der von einer CA signierten Zertifizierungsdatei (.pem-Datei). Wenn Sie ein selbstsigniertes Zertifikat verwenden, lassen Sie diese Angabe frei.
  • KeyFile. Absoluter Pfad zu der selbstsignierten Schlüsseldatei (.pem-Datei).
  • KeyFilePassword. Passwort, das für die Verwendung der Zertifizierungsdatei festgelegt wurde.
[Server.Connection.Dev]
Port=8080
;# The following options enable HTTPS support.
HTTPS=1
;# Set HTTPS=1 to enable HTTPS, HTTPS=0 to disable.
 CertFile=C:\Users\Public\Documents\Embarcadero\EMS\cacert.pem
; RootCertFile=
;# When using a self-signed certificate, RootCertFile is left blank.
 KeyFile=C:\Users\Public\Documents\Embarcadero\EMS\cakey.pem
 KeyFilePassword=certpassword

EMS Google Cloud Messaging

Sie können die GCM-Einstellungen (Google Cloud Messaging) für den EMS-Server konfigurieren. Suchen Sie in der Datei EMSServer.ini den Abschnitt [Server.Push.GCM]:

[Server.Push.GCM]
;# This section is for Google Cloud Messaging (GCM) settings.
;# These settings are needed to send push notificatons to an Android device.
ApiKey=XXXXXXXXXXXX

EMS-Server-Mandaten

In diesem Abschnitt können Sie die Mandantenkonfigurationen für Ihren RAD Server ändern. Sie können einen der folgenden Mandantenmodi auswählen:

  • Modus "Einzelner Mandant"
  • Modus "Mehrere Mandanten"

Weitere Informationen zum Modus "Mehrere Mandanten" finden Sie im Thema Unterstützung mehrerer Mandanten für RAD Server.

Suchen Sie in der Datei EMSServer.ini den Abschnitt [Server.Tenants]:

  • MultiTenantMode: Legt den Modus für Ihren RAD Server fest. Um in den Modus für mehrere Mandanten umzuschalten, entfernen Sie die Kommentarzeichen aus dieser Zeile. Bei MultiTenantMode=1 ist der Modus für mehrere Mandanten aktiviert. Bei MultiTenantMode=0 arbeitet RAD Server im Modus "Einzelner Mandant".
  • DefaultTenantId: Ändert im Modus "Einzelner Mandant" die Standard-TenantId in die benutzerdefinierte ID.
  • TenantIdCookieName: Legt den benutzerdefinierten Cookie-Namen zum Speichern der TenantId in der EMS-Konsole fest.
[Server.Tenants]
;# This section defines settings for Single or Multi-Tenant modes.
;#
;# The MultiTenantMode option is used to turn on the Multi-Tenant mode. 
;# If the Multi-Tenant mode is turned on, then TenantId and TenantSecret is required to access EMS Server.
;MultiTenantMode=1
;#
;# Default Tenant is used only in the Single Tenant mode.
;DefaultTenantId=00000000-0000-0000-0000-000000000001
;#
;# Define custom cookie name to store TenantId in EMS Console.
;TenantIDCookieName=TenantID

Unterstützung für die Weiterleitung von EMS-Server-Dateien

Sie können EMS so konfigurieren, dass Verzeichnisse mit statischen Dateien und die zugeordneten URLs erkannt werden. Jeder Eintrag wird mit einem JSON-Objekt definiert und die Anzahl der Einträge ist unbegrenzt. Suchen Sie in der Datei EMS Server.ini file den Abschnitt [Server.PublicPaths]. Das Objekt besitzt folgende Eigenschaften:

  • path: Der relative URL.
  • directory: Physischer Speicherort der statischen Dateien.
  • default: Legt die Standarddatei fest, die beim Anzeigen des Stammverzeichnisses des virtuellen Verzeichnisses weitergeleitet wird (optional).
  • mimes: Array mit MIME-Dateitypmasken (optional).
  • extensions: Array mit Dateierweiterungen (optional).
[Server.PublicPaths]
Path1={"path": "images", "directory": "C:\\web\\images\\", "default": "index.html", "mimes": ["image/*"]}
Path2={"path": "content", "directory": "C:\\web\\content\\", "default": "index.html", "extensions": ["js", "html", "css"]}

Siehe auch