Référence du fichier de configuration
Les paramètres de réseau de both FlowForce Server et de FlowForce Web Server peuvent tous deux être configurés soit depuis la page de configuration (voir Définir les paramètres de réseau) soit en éditant les fichiers de configuration .ini, comme décrit ci-dessous.
Il existe deux fichiers .ini, un pour FlowForce Server (flowforce.ini), et un autre pour FlowForce Web Server (flowforceweb.ini). Les fichiers de configuration .ini peuvent être trouvés sous les chemins d'accès suivants :
Linux | /var/opt/Altova/FlowForceServer2023/data/flowforce.ini /var/opt/Altova/FlowForceServer2023/data/flowforceweb.ini |
macOS | /var/Altova/FlowForceServer2023/data/flowforce.ini /var/Altova/FlowForceServer2023/data/flowforceweb.ini |
Windows | C:\ProgramData\Altova\FlowForceServer2023\data\flowforce.ini C:\ProgramData\Altova\FlowForceServer2023\data\flowforceweb.ini |
Dans le répertoire ci-dessus, vous pouvez aussi trouver deux fichiers d'exemple .ini qui contiennent des commentaires et peuvent être utilisés en tant que modèles :
•flowforce.ini.template
•flowforceweb.ini.template
Après avoir édité les fichiers .ini, ne pas oublier de redémarrer le service correspondant (FlowForce Server ou FlowForce Web Server). Pour plus d'informations, voir :
•Lancer et arrêter les services (Linux) |
Un fichier d'exemple flowforce.ini ressemble à l'échantillon ci-dessous :
[Listen] active=1 hostname= hostname= certificate_chain=/path/to/certificate_chain |
Un fichier d'exemple flowforceweb.ini ressemble à l'échantillon ci-dessous :
[Listen] active=1 hostname=example.domain.org certificate_chain=/path/to/certificate_chain hostname= |
Les fichiers .ini sont organisés en sections, comme décrit ci-dessous. Vous pourrez constater les différences entre les deux fichiers dans le tableau ci-dessous.
[Listen]
Une section [Listen] définit les paramètres de connexion HTTP. Il est possible de définir plusieurs sections [Listen]. Chaque section [Listen] doit commencer avec "Listen", par exemple [ListenSSL].
active | (en option) Active ou désactive cette section [Listen]. Valeurs valides :
Par exemple, active=1 signifie que les connexions HTTP sont activées. | ||||
ssl | (en option) Active la prise en charge SSL pour cette section [Listen]. Valeurs valides :
Pour activer la prise en charge SSL, définir ssl=1 et créer une section [SSL], comme indiqué ci-dessous. | ||||
host | Spécifie l'adresse de liaison de réseau de FlowForce (Web) Server, par exemple, 127.0.0.1. Il peut s'agir d'une adresse IPv4 ou IPv6. Utiliser 0.0.0.0 pour écouter toutes les interfaces. Pour se limiter à un accès local uniquement, utiliser 127.0.0.1. | ||||
port | Spécifie le port sur lequel FlowForce (Web) Server écoutera. Veuillez vous assurer que ce port n'est pas déjà utilisé.
| ||||
hostname | Le champ Nom d’hôte, s’il est non-vide, définit un nom d’hôte fixe qui est utilisé pour la liaison. Il définit le nom de la machine qui exécute FlowForce Web Server et que d’autres machines dans le réseau utiliserait pour s’y connecter.
Normalement, FlowForce détecte automatiquement le nom d’hôte approprié à utiliser. Si vous définissez ce champ de manière explicite, la détection automatique sera contournée. Vous devrez éventuellement utiliser une valeur de type somehost ou somehost.example.org, selon la configuration du réseau dans votre organisation.
Le nom d’hôte associé avec une liaison est utilisée pour SSL (voir Activer SSL pour FlowForce Web Server) et par le Altova Service Controller sur Windows. Si SSL est activé, le nom d’hôte doit correspondre à la propriété Common Name du certificat. | ||||
max_request_body_size | Cette option vous permet de spécifier la taille maximum, en bytes, des requêtes HTTP soit à FlowForce Server soit à FlowForce Web Server, par exemple :
max_request_body_size=500000000
La limite implicite par défaut se situe autour de 100 MO (100,000,000 bytes). Dans les situations suivantes, vous devrez définir cette option explicitement :
1.Si vous appelez des services FlowForce Web exposés en tant que tâches et que le corps de requête HTTP est plus grand que la limite par défaut. 2.Si vous déployez des mappages de MapForce vers FlowForce Server et que les fichiers d'entrée sont plus grands que la limite par défaut.
Dans le premier cas, l'option doit uniquement être définie dans le fichier flowforce.ini. Dans le deuxième cas, l'option doit être définie dans les deux fichiers flowforce.ini et flowforceweb.ini. |
[SSL]
Cette section définit les paramètres de connexion SSL/HTTPS.
certificate | Spécifie le chemin absolu vers le fichier de certificat dans le format PEM. |
private_key | Spécifie le chemin absolu vers le fichier de clé privée. |
certificate_chain | (en option) Le chemin vers le fichier de chaîne de certificat. |
[FlowForce]
Cette section s'applique uniquement à FlowForce Web Server (le fichier flowforceweb.ini). Elle définit les détails de connexion entre FlowForce Web Server et FlowForce Server.
ssl | (en option) Active la prise en charge SSL pour la connexion entre FlowForce Web Server et FlowForce Server. Valeurs valides :
| ||||
host | Spécifie l'adresse IP ou le nom d'hôte de FlowForce Server.
Si FlowForce Server n'est pas lié à toutes les interfaces, cette valeur doit être la même que celle dans la section “[Listen]” de flowforce.ini, sinon elle sera 127.0.0.1.
Si SSL est activé, cette valeur doit correspondre à la propriété "Common Name" du certificat configuré dans la section “[SSL]” du flowforce.ini. | ||||
port | Spécifie le port TCP sur lequel FlowForce Server devra se connecter à FlowForce Server.
Cette valeur doit être la même que celle dans la section correspondante “[Listen]” ou “[ListenSSL]” de flowforce.ini qui a le même numéro de port.
Si SSL est activé sur ce port, host et hostname (ou juste host si hostname n'est pas présent) doit correspondre à la propriété "Common Name" du certificat configuré dans la section “[SSL]” de flowforce.ini. | ||||
hostname | S'il est non-vide, ce champ défini un nom d'hôte fixé qui est utilisé par d'autres machines sur le réseau pour se connecter aux tâches FlowForce exposées en tant que services Web (voir Exposer des tâches en tant que services Web).
Vous devrez éventuellement utiliser une valeur de type somehost ou somehost.example.org, selon la configuration de réseau de votre organisation.
Si SSL est activé sur ce port et que cette valeur est présente, cette valeur doit correspondre à la propriété "Common Name" du certificat configuré dans la section “[SSL]” de flowforce.ini.
Le nom d’hôte est aussi utilisé par Altova Service Controller. Si vous ne définissez pas le nom d'hôte, FlowForce détectera automatiquement le premier nom d'hôte approprié à utiliser par Altova Service Controller.
Si hostname est configuré, l'interface web FlowForce peut présenter des liens cliquables pour naviguer vers les tâches exposées en tant que services Web, y compris les liens dans la section Déclencheurs et Services actifs de la page d'accueil. De même, une touche Appeler Service Web | ||||
certificate | (en option) Définit quel certificat de serveur sera accepté par FlowForce Server. Si aucun certificat n'est attribué, les certificats CA racine du système seront utilisés pour vérifier le certificat de serveur. Si présent, cette valeur correspondra au certificat que FlowForce Server utilise (celui dans le fichier flowforce.ini). |
[FlowForceWeb]
Cette section s'applique uniquement à FlowForce Web Server (le fichier flowforceweb.ini).
timezone | Spécifie le fuseau horaire de FlowForce Web Server, par exemple timezone=Europe/Berlin |