Configurer le composant Administration Web

Le composant interne WebAdmin a été inclus dans 4D v18 R6. Ce composant est la base de nombreux modules d’administration futurs. Il est basé sur le web afin que vous puissiez l’utiliser avec des environnements sans tête. Le premier module d’administration basé sur le Web publié est l’explorateur de données, que nous avons expliqué en détail dans cet article de blog.

Voyons maintenant comment le configurer.

Un serveur Web dédié

Comme vous l’avez certainement appris en lisant ce billet de blog, 4D permet à chaque composant de disposer de son propre serveur Web. C’est particulièrement efficace pour diviser le code d’une application en plusieurs unités opérationnelles. Ainsi, lorsque nous avons eu besoin de créer un nouvel environnement d’administration basé sur le Web, nous avons décidé d’utiliser notre propre technologie !

Le Data Explorer utilise le serveur web du composant WebAdmin, de sorte que les paramètres expliqués dans cet article de blog s’appliquent également à lui.

Sécurisé par défaut

Il n’y a pas lieu de s’inquiéter lorsque vous utilisez 4D, vos paramètres et vos données ne sont pas exposés à des regards malveillants !

L’accès aux composants est protégé par une clé d’accès. Si la clé d’accès n’est pas définie, il n’y a aucun moyen d’accéder au serveur WebAdmin (ou au Data Explorer) à l’aide d’un navigateur.

Ainsi, par défaut, la seule façon d’utiliser l’explorateur de données est de démarrer le serveur web et d’ouvrir son interface en cliquant sur l’élément de menu Explorateur de données. De cette façon, il n’est pas nécessaire de définir une clé d’accès car le principal problème de sécurité, dans ce cas, se situe entre l’ordinateur et la chaise !

Autoriser les accès à l’aide de l’interface

A partir de 4D v18 R6, vous verrez une nouvelle entrée dans le menu Fichier de 4D et 4D Server : Administration Web. Son premier élément de sous-menu est Paramètres, ce qui vous permet d’afficher la boîte de dialogue des paramètres ci-dessous :

Comme vous pouvez le constater, le serveur web WebAdmin n’est pas automatiquement lancé par défaut. Si vous souhaitez qu’il soit lancé automatiquement au démarrage de 4D, il suffit d’activer la première case à cocher.

Vous pouvez également configurer les protocoles disponibles et leurs ports de publication. Gardez à l’esprit que les connexions HTTP au WebAdmin ne sont disponibles que pour le localhost. Si vous souhaitez vous connecter depuis un autre ordinateur, vous devez utiliser le protocole HTTPS.

Le composant WebAdmin intègre son propre certificat, mais comme il n’est pas défini pour votre propre domaine, vous pouvez utiliser votre propre certificat et définir le dossier contenant les fichiers correspondants.

Enfin, vous pouvez définir la clé d’accès qui protège votre accès à WebAdmin contre les navigateurs.

Notez que tous les paramètres ne sont effectifs qu’après le redémarrage du serveur Web de WebAdmin.

Autoriser les accès à l’aide de l’interface CLI

La CLI (Command Line Interface) est utilisée lorsque vous lancez 4D ou 4D Server en mode sans affichage. Comme il n’y a aucun moyen d’afficher l’interface des paramètres en mode sans tête, plusieurs nouveaux paramètres concernant le composant WebAdmin ont été ajoutés à l’interface CLI :

–webadmin-settings-file
Ce paramètre vous permet d’utiliser un autre fichier de paramètres. Tous les paramètres établis dans ce fichier remplaceront les paramètres actuels de WebAdmin.

Dans l’exemple suivant, le composant WebAdmin utilisera les paramètres définis dans le fichier « customWA.4DSettings » au démarrage de 4D :

./4D –webadmin-settings-file « /Users/John Doe/Documents/customWA.4DSettings »

–webadmin-access-key
Ce paramètre vous permet de définir la clé d’accès.

Dans l’exemple suivant, le composant WebAdmin utilisera la clé d’accès « MicKey » au démarrage de 4D :

./4D –webadmin-access-key « MicKey »

–webadmin-auto-start
Ce paramètre vous permet de démarrer le serveur Web de WebAdmin au démarrage de 4D.

Dans l’exemple suivant, le composant WebAdmin démarrera automatiquement son serveur Web au démarrage de 4D :

./4D –webadmin-auto-start true

–webadmin-store-settings
Ce paramètre vous permet de stocker les deux paramètres précédents dans le fichier de paramètres (le fichier de paramètres personnalisés si le paramètre correspondant est utilisé, sinon le fichier de paramètres du composant WebAdmin). Si vous n’utilisez pas ce paramètre, les deux paramètres précédents sont utilisés uniquement pour l’exécution actuelle de 4D.

Dans l’exemple suivant, au démarrage de 4D, le composant WebAdmin utilisera automatiquement la clé d’accès « MicKey » et stockera ces paramètres dans son propre fichier de paramètres :

./4D –webadmin-access-key « MicKey » –webadmin-auto-start true –webadmin-store-settings

Vous pouvez obtenir plus de détails sur ces paramètres dans la documentation de 4D.

Exécution de plusieurs instances 4D

Les paramètres sont partagés par toutes les instances de 4D ou de 4D Server. Sinon, le démarrage automatique du serveur web de WebAdmin aurait généré des problèmes. Ne vous inquiétez pas si un port de publication n’est pas disponible lorsque 4D démarre le serveur web de WebAdmin, il essaiera avec les ports suivants.

Rappel :

Comme mentionné dans l’introduction, le composant WebAdmin est la base de nombreuses fonctionnalités à venir. N’hésitez donc pas à nous dire ce que vous pensez dans le forum et à décrire tout type de composant que vous pouvez imaginer !