Aller au contenu

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.

Sur un serveur sans ce module, l’API distante n’existe tout simplement pas. Elle répond exactement comme un module inexistant. Provibr ne peut donc pas se rabattre sur Webmin seul, et ne fait pas semblant : la connexion est refusée avec un motif au lieu d’être créée à moitié.

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é.
Attribuez le module Virtualmin à un utilisateur Webmin créé pour cela. Il peut tout ce que Virtualmin peut, ce qui est déjà beaucoup, mais pas tout ce que Webmin peut.

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.

Envoyer ce mot de passe en clair, ou vers un certificat que personne n’a vérifié, n’est pas un arbitrage que nous rendons à votre place. Le http est donc refusé et le champ d’empreinte ne peut pas rester vide.

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.

shell
openssl s_client -connect <host>:10000 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256
Les commandes et les sorties de terminal sont en anglais partout, dans le panneau comme dans ces pages. Un seul texte, une seule vérité : ce que vous lisez ici est littéralement ce que votre hôte affichera.

L’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.

Lorsque le panneau répond par une page de connexion au lieu de l’API, l’agent le dit explicitement. Cela signifie en général que l’adresse pointe vers une page et non vers le panneau, ou que l’API distante est désactivée.

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.
L’identifiant est le numéro et non le nom, car Virtualmin sait renommer un domaine. Une clé fondée sur le nom se détacherait de sa ligne dès la première fois que quelqu’un le ferait.

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.

Virtualmin ne remonte les quotas et la consommation que si les quotas du système de fichiers sont activés, et une installation neuve les a désactivés. Tant que personne ne les active, ces champs ne sont tout simplement pas là. Provibr n’affiche alors rien plutôt qu’un zéro : absence de mesure et absence de consommation ne sont pas la même chose.

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.

Les comptes importés comptent dans votre capacité exactement comme les comptes commandés. Importez-en plus que vous n’avez de place et un dépassement s’ouvre, avec le délai de grâce habituel.