Documentation
Webmin et Virtualmin
Webmin est l’intégration de panneau de contrôle pour les serveurs qui exécutent Virtualmin. Elle crée et gère des comptes d’hébergement web sur une machine déjà en marche. Il n’y a aucun système d’exploitation à installer ni aucune machine à démarrer. Un compte est créé, reçoit un forfait, puis est suspendu, changé de forfait ou supprimé.
Webmin est le panneau, Virtualmin fait l’hébergement
Vous connaissez le produit sous le nom de Webmin, et c’est ainsi que s’appelle cette page. Ce que Provibr pilote réellement, c’est Virtualmin : le module qui connaît les domaines, les forfaits et les quotas. Webmin seul administre une machine Linux et ignore complètement la notion de compte d’hébergement.
Ce dont vous avez besoin
L’API distante de Webmin parle HTTP Basic, le secret est donc ici un mot de passe et non un jeton. C’est une propriété de Webmin et non un choix de notre part, et c’est la raison pour laquelle les deux règles ci-dessous sont plus strictes que pour les autres panneaux.
- Hôte : l’adresse du panneau. Elle doit être en https, et le port 10000 est complété si vous l’omettez.
- Utilisateur Webmin : root fonctionne, mais un utilisateur qui n’a que le module Virtualmin vaut mieux.
- Mot de passe : celui de cet utilisateur. Il n’y a rien à restreindre, choisissez donc l’utilisateur avec soin.
- Empreinte TLS : obligatoire, car l’installateur de Webmin laisse un certificat auto-signé.
https et l’empreinte sont tous deux obligatoires
Les autres intégrations de panneau acceptent une adresse http en clair et vous disent ce que cela coûte. Celle-ci non, et la différence tient au secret : une clé de connexion DirectAdmin se limite à une poignée de commandes, un mot de passe Webmin ne se limite pas du tout.
Relevez l’empreinte depuis n’importe quelle machine qui atteint le panneau, et collez-la telle que vous l’avez obtenue, avec ou sans deux-points, et le préfixe imprimé par votre outil peut rester.
openssl s_client -connect <host>:10000 </dev/null 2>/dev/null | \
openssl x509 -noout -fingerprint -sha256L’API distante
Provibr n’utilise pas l’interface web de Webmin. Il appelle l’API distante du module Virtualmin, qui renvoie des réponses lisibles par une machine plutôt que des pages. Sur certaines installations, cette voie est désactivée ; elle se réactive sous Webmin, Webmin Configuration, Advanced Options.
Réglages
Il n’y en a aucun. Un serveur Webmin décide lui-même où vit un compte et quelle adresse il reçoit, il ne vous reste donc rien à choisir. L’onglet Réglages existe malgré tout, car c’est aussi de là que l’on renvoie les identifiants.
Forfaits
Un forfait Virtualmin est la description qu’a le panneau d’un compte : quota de disque, trafic mensuel, nombre de domaines et de boîtes aux lettres, fonctions activées. Ce n’est ni un plan Provibr ni un système d’exploitation. C’est un nom auquel nous renvoyons, et son contenu peut changer sur votre serveur sans que nous le remarquions.
La page de l’intégration sait lire la liste des forfaits avec leur contenu, de sorte que vous voyez ce que vous choisissez au lieu de taper un nom de mémoire.
Un plan web fixe un forfait Virtualmin sur une intégration et lui donne un nom à vous. Commander avec un plan l’emporte sur un choix isolé, et ce choix isolé reste disponible pour les cas qu’un plan ne couvre pas.
À quoi ressemble un compte dans Provibr
Un compte d’hébergement est une ligne de serveur ordinaire, de type serveur web. Son identifiant est le numéro interne que Virtualmin attribue au domaine, et son domaine, son utilisateur, son forfait et ses fonctions arrivent à chaque relevé.
- Créer un compte demande un domaine, une adresse e-mail, un forfait et un mot de passe.
- L’utilisateur unix est dérivé du domaine, les tirets y sont donc normaux, contrairement à DirectAdmin, qui a sa propre règle de nommage.
- Le mot de passe n’est consigné nulle part. Seul le fait que vous en avez fourni un l’est ; la valeur voyage séparément.
- Ensuite, vous pouvez suspendre, reprendre, changer de forfait et supprimer. Il n’y a pas de console, car un compte d’hébergement n’en a pas.
Quotas et utilisation
Le quota de disque et le trafic voyagent avec le relevé habituel : un compte obtient donc un graphique d’utilisation sans rien activer de plus, à condition que le serveur sache les mesurer.
Reprendre des comptes existants
L’onglet Import liste les comptes présents sur le panneau et vous laisse reprendre ceux que vous voulez dans Provibr. Les comptes déjà connus apparaissent mais ne sont plus sélectionnables, de sorte que vous voyez l’ensemble et non une vue filtrée.