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

Siehe auch

Abgerufen von „http://docwiki.embarcadero.com/RADStudio/Berlin/d/index.php?title=Manuelles_Bearbeiten_der_Konfiguration_des_EMS-Servers&oldid=201351“