Altova FlowForce Server 2024 Advanced Edition

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/FlowForceServer2024/data/flowforce.ini

/var/opt/Altova/FlowForceServer2024/data/flowforceweb.ini

macOS

/var/Altova/FlowForceServer2024/data/flowforce.ini

/var/Altova/FlowForceServer2024/data/flowforceweb.ini

Windows

C:\ProgramData\Altova\FlowForceServer2024\data\flowforce.ini

C:\ProgramData\Altova\FlowForceServer2024\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)

Lancer et arrêter les services (macOS)

Lancer et arrêter les services (Windows)

 

Un fichier d'exemple flowforce.ini ressemble à l'échantillon ci-dessous :

 

[Listen]

active=1
host=127.0.0.1
port=4646

hostname=
 
[ListenSSL]
active=1
SSL=1
host=0.0.0.0
port=4647

hostname=
 
[SSL]
certificate=/path/to/certificate.crt
private_key=/path/to/private_key.key

certificate_chain=/path/to/certificate_chain

 

[Master]

host=0.0.0.0

port=4645

active=1

 

Un fichier d'exemple flowforceweb.ini ressemble à l'échantillon ci-dessous :

 

[Listen]

active=1
host=0.0.0.0
port=8082
hostname=example.domain.org
 
[ListenSSL]
active=1
SSL=1
host=0.0.0.0
port=8083

hostname=example.domain.org
 
[SSL]
certificate=path/to/certificate.crt
private_key=path/to/private_key.key

certificate_chain=/path/to/certificate_chain
 
[FlowForce]
host=127.0.0.1
port=4646

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 :

 

0

désactivé

1

activé

 

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 :

 

0

désactivé

1

activé

 

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é.

 

Si l'adresse de liaison (interface) est non-locale, vous devrez éventuellement configurer le pare-feu du système d'exploitation afin d'activer l'accès par le biais du port désigné.

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 :

 

0

désactivé

1

activé

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 fs_ic_call_ws devient disponible dans la section "Service" de la page de configuration de la tâche qui vous permet d'appeler le Service Web dans une nouvelle fenêtre de navigateur.

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

© 2017-2023 Altova GmbH