Manuelles Bearbeiten der Konfiguration der RAD Server Engine
Nach oben zu Einrichten der RAD Server Engine
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.
Inhaltsverzeichnis
- 1 Konfiguration der EMS-Datenbank
- 2 EMS-Serverbeschränkungen
- 3 Konfiguration der EMS-Server-Authentifizierung
- 4 Plattformübergreifende Domäne für EMS-Server-API
- 5 EMS-Serververbindung
- 6 EMS Google Cloud Messaging
- 7 EMS-Server-Mandaten
- 8 Unterstützung für die Weiterleitung von EMS-Server-Dateien
- 9 Siehe auch
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).
- EMS-Client-Eigenschaft: TEMSProvider.MasterSecret.
- AppSecret. Schlüssel, mit dem beliebige Anforderungen an die autorisierten Endpunkte vorgenommen werden können.
- EMS-Client-Eigenschaft: TEMSProvider.AppSecret.
- 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.
- EMS-Client-Eigenschaft: TCustomEMSConnectionInfo.ApplicationId.
[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]:
- APIKey. Der API-Key, den Sie beim Einrichten des Messaging-Dienstes erhalten.
[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. BeiMultiTenantMode=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"]}