cPanel et WHM

Un jeton d’API WHM, ni un mot de passe ni un identifiant cPanel. Vous le créez dans WHM même, et il circule comme un en-tête ordinaire à chaque appel de l’agent.

• Hôte : l’adresse de WHM, https compris. Omettez le port et Provibr complète avec 2087.
• Utilisateur WHM : le compte auquel appartient le jeton, en général root.
• Jeton d’API : créé dans Manage API Tokens au sein de WHM, et affiché une seule fois.
• Empreinte TLS : facultative, et sur un serveur cPanel vous la laissez normalement vide. La section ci-dessous explique pourquoi.

openssl s_client -connect <host>:2087 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256

Le jeton se crée dans WHM, par l’utilisateur auquel il appartiendra. Provibr ne le revoit jamais ensuite : il est transmis une fois à votre agent et scellé dans le coffre de cet agent, et la plateforme ne conserve que les noms des champs.

1. 01Connectez-vous à WHM en tant que l’utilisateur auquel le jeton doit appartenir, en général root.
2. 02Ouvrez Development puis Manage API Tokens.
3. 03Créez un jeton et donnez-lui un nom qui indique qu’il appartient à Provibr, afin de le retrouver plus tard si vous voulez le révoquer.
4. 04Copiez le jeton avant de quitter la page. WHM l’affiche une fois et ne peut plus l’afficher ensuite ; le perdre oblige à en créer un autre.

Le port 2087 est celui qui est chiffré, et un serveur cPanel porte généralement un certificat d’une autorité publique que le panneau renouvelle lui-même, environ tous les quatre-vingt-dix jours. Dans ce cas ordinaire, le champ de l’empreinte reste vide et l’agent vérifie le certificat comme le ferait un navigateur.

Ne le remplissez que lorsque le serveur présente un certificat dont aucune autorité publique ne se porte garante, ce qui signifie en pratique votre propre autorité de certification interne. Relevez l’empreinte depuis l’hôte de l’agent, afin de fixer exactement ce que l’agent verra, et relevez-la de nouveau dès que ce certificat est remplacé.

Il n’y en a pas. Un WHM décide lui-même sur quelle machine un compte atterrit et quelle adresse il reçoit, il ne vous reste donc rien à choisir. L’onglet des réglages existe malgré tout, car c’est aussi là que vous renvoyez les identifiants.

Un forfait WHM est la description qu’un compte reçoit du panneau lui-même : quota de disque, bande passante mensuelle, combien de sous-domaines et de boîtes aux lettres, quelle liste de fonctions. 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 peut lire la liste des forfaits avec leur contenu, de sorte que vous choisissez parmi ce que votre serveur possède vraiment au lieu de taper un nom de mémoire. Les forfaits se créent dans WHM ; Provibr ne les crée pas.

Un plan web fixe un forfait sur une intégration et lui donne un nom à vous. Commander avec un plan l’emporte sur le choix d’un forfait isolé, et ce choix isolé reste disponible pour les cas qu’un plan ne couvre pas.

Un serveur cPanel n’applique les quotas de disque que si le système de fichiers où résident les comptes prend les quotas en charge. Sans cela, WHM accepte le forfait, accepte le chiffre, et n’applique rien.

Le test de connexion le signale. Il lit les comptes du serveur et indique si leurs quotas sont réellement appliqués, à côté de la version de WHM et des décomptes. Sur un serveur sans comptes il n’y a rien à mesurer, et il le dit au lieu de deviner.

C’est aussi pourquoi Provibr lit la limite de disque sur le compte et non sur le forfait. Ce que le compte annonce est ce qui s’applique ; le chiffre du forfait est ce que quelqu’un avait prévu.

Activer les quotas est un travail sur le serveur et non dans Provibr : le système de fichiers doit être monté avec les quotas utilisateur et les comptes doivent être réanalysés. Ce que cela exige dépend du système de fichiers et de la façon dont la machine a été installée ; votre hébergeur ou la documentation de cPanel est l’endroit indiqué.

Un compte d’hébergement est une ligne de serveur ordinaire de type serveur web. Son identifiant est le nom d’utilisateur cPanel, et son domaine principal, son forfait, son occupation disque et sa bande passante arrivent à chaque relevé.

• Créer un compte demande un nom d’utilisateur, un domaine principal, une adresse de contact, un forfait et un mot de passe.
• Les noms d’utilisateur suivent la règle propre à WHM : commencer par une lettre, puis des lettres et des chiffres, seize caractères au plus. Ni tirets ni traits de soulignement.
• Le mot de passe n’est consigné nulle part. Seul le fait que vous en avez fourni un l’est ; la valeur circule séparément.
• Ensuite vous pouvez suspendre, réactiver, changer de forfait et supprimer. Il n’y a pas de console, car un compte d’hébergement n’en a pas.
• Aucun résultat n’est cru sur parole. WHM confirme un changement par une page de sortie de processus plutôt que par le nouvel état : chaque changement se termine donc en relisant le compte.

L’onglet d’import liste les comptes du panneau et vous laisse reprendre dans Provibr ceux que vous voulez. Les comptes déjà connus sont affichés mais ne peuvent pas être sélectionnés de nouveau, de sorte que vous voyez le tableau entier plutôt qu’un tableau filtré.

L’occupation disque et la bande passante voyagent avec le relevé ordinaire : un compte obtient donc un graphique de consommation sans rien activer de plus. La bande passante est un total mensuel que le serveur remet lui-même à zéro, elle figure donc comme un nombre sur le compte et non comme une courbe sur le graphique.

• Administrer le serveur lui-même n’existe pas. Provibr crée, modifie et supprime des comptes sur un WHM que vous exploitez ; les services, les zones DNS, le routage du courrier et les réglages du panneau lui-même restent où ils sont.
• Il n’y a pas de console. Un compte d’hébergement n’est pas une machine : il n’y a donc rien à quoi rattacher un terminal.
• Les boîtes aux lettres, les bases de données et le DNS à l’intérieur d’un compte appartiennent à cPanel. Provibr crée le compte et le remet ; ce qui s’y passe ensuite regarde votre client et le panneau.
• Les comptes revendeurs ne sont pas modélisés. Provibr parle à WHM comme un opérateur unique, et un jeton appartenant à un revendeur voit un monde plus petit que root, et ce cas n’a pas été mesuré et n’est pas décrit ici.