Modification manuelle de la configuration du moteur RAD Server

De RAD Studio
Aller à : navigation, rechercher

Remonter à Installation du moteur RAD Server


Le serveur EMS est configuré avec les paramètres par défaut, après la première configuration de l'environnement EMS.

Vous pouvez changer la configuration de votre serveur EMS en modifiant le fichier EMSServer.ini situé dans C:\Users\Public\Documents\Embarcadero\EMS. Si vous modifiez ce fichier, vous devez interrompre et redémarrer le serveur EMS pour recharger le fichier emsserver.ini.

Configuration de la base de données EMS

Vous pouvez modifier les informations par défaut de la base de données EMS utilisée par le serveur EMS. Dans le fichier EMSServer.ini, accédez à la section [Data] :

  • InstanceName. Spécifie l'instance d'InterBase qui héberge la base de données EMS.
  • Database. Répertoire local du fichier de la base de données EMS.
  • UserName. Nom d'utilisateur d'accès à la base de données EMS.
  • Password. Mot de passe d'accès à la base de données EMS.
  • SEPassword. Mot de passe pour la connexion à une base de données InterBase encryptée.
  • Pooled. Active le pooling de connexion FireDAC sur la base de données EMS pour réduire la latence.
  • PooledMax. Nombre maximal de connexions en pool autorisées sur la base de données EMS.
[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.

Limites du serveur EMS

Vous pouvez modifier les informations par défaut du nombre de connexions simultanées à la base de données EMS ou le nombre maximal d'utilisateurs EMS. Dans le fichier EMSServer.ini, accédez à la section [Server.Limits] :

  • MaxConnections. Nombre maximal de requêtes HTTP simultanées au serveur EMS.
  • MaxUsers. Nombre maximal d'utilisateurs EMS autorisés dans la base de données EMS. Cette valeur dépend de la licence EMS utilisée.
[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.

Configuration de l'authentification du serveur EMS

Vous pouvez modifier les informations par défaut d'authentification de votre serveur EMS. Dans le fichier EMSServer.ini, accédez à la section [Server.Keys] :

  • MasterSecret. Clé autorisant toute opération indépendamment de la propriété (mise à jour d'un utilisateur dans la base de données EMS, par exemple).
  • AppSecret. Clé autorisant toute requête vers les points de terminaison autorisés.
  • ApplicationID. Identificateur du serveur EMS L'identificateur différencie les serveurs EMS. Les requêtes à partir des clients EMS sont rejetées si l'ApplicationID dans la requête ne correspond pas à l'ApplicationID défini pour le serveur EMS.
[Server.Keys]
MasterSecret=MasterSecretKey
AppSecret=AppSecretKey
ApplicationID=ApplicationIDKey

Vous pouvez également définir des règles d'accès pour autoriser ou refuser l'accès à une ressource EMS ou un point de terminaison EMS. Dans le fichier EMSServer.ini, accédez à la section [Server.Authorization] et ajoutez vos règles d'accès personnalisées.

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

Domaines croisés de l'API du serveur EMS

Vous pouvez modifier la permission pour permettre à différents domaines (en dehors du domaine du serveur EMS) d'effectuer des requêtes HTTP à l'API du serveur EMS public. Dans le fichier EMSServer.ini, allez à la section [Server.APICrossDomain] :

  • CrossDomain. Liste de domaines qui sont autorisés à effectuer des requêtes HTTP de domaines croisés à l'API du serveur EMS. Pour autoriser un domaine, utilisez la valeur de caractère générique *.
[Server.APICrossDomain]
;# Write here the domains allowed to call the API. Used for Cross-Domains
CrossDomain = *

Connexion au serveur EMS

Vous pouvez modifier les informations par défaut pour la connexion à votre serveur EMS. Dans le fichier EMSServer.ini, accédez à la section [Server.Connection.Dev] :

  • Port. Définit le port de connexion pour la requête HTTP au serveur EMS.
  • HTTPS. Active le support HTTPS pour le serveur EMS. Si ce paramètre est activé, vous devez installer OpenSSL et configurer les informations du fichier de certification.
  • CertFile. Chemin d'accès absolu au fichier de certification auto-signé (fichier .pem).
  • RootCertFile. Chemin d'accès absolu au fichier de certification CA (fichier .pem). Si vous utilisez un certificat auto-signé, laissez ce paramètre vide.
  • KeyFile. Chemin d'accès absolu au fichier clé auto-signé (fichier .pem).
  • KeyFilePassword. Mot de passe défini pour utiliser le fichier de certification.
[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

Vous pouvez configurer les paramètres Google Cloud Messaging (GCM) de votre serveur EMS. Dans le fichier EMSServer.ini, accédez à la section [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

Clients du serveur EMS

Dans cette section, vous pouvez modifier les configurations du client pour RAD Server. Vous pouvez sélectionner l'un des modes client suivants :

  • Mode client unique
  • Mode multi-client

Pour plus d'informations sur le mode multi-client, voir la rubrique Prise en charge multi-client de RAD Server.

Dans le fichier EMSServer.ini, accédez à la section [Server.Tenants] :

  • MultiTenantMode : spécifie le mode pour RAD Server. Pour basculer en mode multi-client, retirez les marques de commentaire de la ligne suivante : Si MultiTenantMode=1, le mode multi-client est activé. Si MultiTenantMode=0, RAD Server fonctionne en mode client unique.
  • DefaultTenantId : remplace la valeur par défaut TenantId par la valeur personnalisée dans le mode client unique.
  • TenantIdCookieName : spécifie le nom du cookie personnalisé qui stocke la valeur TenantId dans la console EMS.
[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

Prise en charge de la répartition de fichiers sur EMS Server

Vous pouvez configurer EMS pour identifier les répertoires où sont situés les fichiers statiques et les URL sur lesquelles ils sont mappés. Chaque entrée est définie par un objet JSON et le nombre d'entrées est illimité. Dans le fichier EMSServer.ini, accédez à la section [Server.PublicPaths] : Les propriétés de l'objet incluent :

  • path : L'URL relative.
  • directory : L'emplacement physique des fichiers statiques.
  • default: Définit le fichier par défaut qui sera réparti lors de la navigation dans la racine du répertoire virtuel (facultatif).
  • mimes : Masques de types de fichiers du tableau de types MIME (facultatif).
  • extensions : Tableau des extensions de fichier (facultatif).
[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"]}

Voir aussi