Documentation

CyberPanel

CyberPanel est un panneau de contrôle libre pour l’hébergement web. Provibr dialogue avec son API au moyen des identifiants de votre administrateur principal et gère les sites qui s’y trouvent : les créer, les suspendre et les réactiver, les déplacer vers un autre paquet et les supprimer.

Activer l’accès à l’API

Sur un CyberPanel neuf, l’API est désactivée, et cela vaut aussi pour votre administrateur principal. Vous l’activez dans le panneau, sous Users, API Access, pour l’utilisateur admin. Rien d’autre n’est nécessaire : Provibr se connecte avec les identifiants que vous avez déjà.

Si vous la laissez désactivée, chaque appel revient en API Access Disabled, quoi que vous ayez saisi. CyberPanel vérifie cet interrupteur avant le mot de passe : un mot de passe correct donne donc exactement la même réponse qu’un mot de passe erroné. Tout désigne vos identifiants alors que le problème se trouve une case plus loin.

L’administrateur principal doit s’appeler admin

Une partie de l’API de CyberPanel refuse tout nom autre qu’admin, et c’est précisément la partie qui énumère les sites du panneau et indique où en est un site en cours de création. Provibr a besoin des deux : le compte que vous saisissez ci-dessous est donc celui qui se nomme admin.

Ce n’est pas un réglage mais une condition, et elle vient de CyberPanel et non de nous : un administrateur renommé ne peut pas servir à cette intégration. Le test de connexion vous le dit, afin que vous l’appreniez avant votre première commande.

Ce que Provibr demande

Quatre champs. L’agent les conserve dans son propre coffre sur votre hôte ; Provibr ne peut pas les relire.

L’adresse du panneau avec le port, par exemple https://panel.example.com:8090. Sans port, Provibr ajoute le 8090. Le http simple est refusé : ce port ne parle que TLS.
Le nom de l’administrateur principal, c’est-à-dire admin.
Le mot de passe de cet administrateur.
L’empreinte SHA-256 du certificat, tant que le panneau utilise celui qu’il a signé lui-même.

CyberPanel n’a aucun jeton d’API qui couvre ces commandes : dans sa propre API, la voie du jeton est ouverte ou fermée selon le point d’accès, et ce sont justement les quatre commandes qui créent, suspendent, changent de paquet et suppriment un site qui exigent le mot de passe. Il s’agit donc bien du mot de passe complet de votre administrateur principal, la même situation qu’avec Webmin.

Le certificat

Tout CyberPanel neuf présente le même certificat auto-signé, établi au nom de www.example.com et signé par CyberPanel lui-même. Un navigateur le qualifie donc d’incorrect plutôt que d’auto-signé, et la chaîne n’est jamais validée. Renseignez l’empreinte et l’agent fait confiance à ce seul certificat au lieu de désactiver la vérification. Vous la lisez depuis n’importe quelle machine qui atteint le panneau :

shell

openssl s_client -connect <host>:8090 </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.

Posez votre propre certificat sur le nom d’hôte du panneau et la chaîne se valide d’elle-même ; laissez alors le champ vide. C’est le meilleur choix dans ce cas, car un tel certificat est remplacé de temps à autre et un certificat épinglé devrait être ressaisi ici à chaque fois.

Paquets

CyberPanel décrit dans un paquet ce qu’un site a le droit d’utiliser. Provibr lit cette liste et désigne un paquet par son nom ; les paquets eux-mêmes se créent et se modifient dans CyberPanel, pas ici.

Un forfait d’hébergement web dans Provibr pointe vers un paquet d’une intégration. C’est ce que votre client commande, et vous en fixez le prix vous-même.

Déplacer un site vers un autre paquet change l’écriture et rien d’autre. Mesuré depuis l’intérieur du serveur avec un paquet portant d’autres limites : le quota de disque est resté tel quel et la configuration du serveur web a gardé les anciennes valeurs. Le panneau affiche le nouveau nom : lisez ce nom comme une écriture et non comme une limite qui aurait suivi.

Ce qu’une commande transmet

Un site sur CyberPanel se désigne par son domaine, et c’est aussi son identité dans Provibr. Une commande transporte quatre choses :

Le domaine. Il doit être libre sur le panneau, et tout ce que Provibr fera ensuite avec ce serveur le désigne.
Une adresse de contact pour le site.
Le paquet dans lequel le site est placé.
Un mot de passe pour l’accès au panneau que CyberPanel crée sous le site.

La création prend environ cinquante secondes sur CyberPanel, dont une vingtaine passent dans une tentative SSL que le panneau engage de toute façon. Provibr attend le résultat réel au lieu de croire la première réponse : celle-ci arrive au bout de trois secondes environ et ne dit rien, pas même si le domaine était encore libre.

Suspendre et réactiver

Les deux prennent effet immédiatement : le panneau renvoie le nouvel état et sa propre liste l’affiche aussitôt. Provibr suspend un site lorsque vous le demandez et lorsque votre capacité est dépassée.

Sur CyberPanel, la suspension est une astuce du serveur web et non un blocage du compte. Le site devient injoignable, mais le FTP, le courrier et les bases de données continuent de fonctionner et l’utilisateur unix n’est pas bloqué. Cela diffère de DirectAdmin, et cela compte dès que vous utilisez la suspension pour faire respecter quelque chose.

Espace disque et trafic

CyberPanel est le seul panneau de contrôle de Provibr sans courbes de consommation, et ce n’est pas l’intégration qui les omet : le panneau ne les mesure pas. Le trafic est calculé puis jeté, et la consommation de disque sort d’un cache resté vide sur un site neuf, et le zéro obtenu ne se distingue donc pas d’une absence totale d’usage.

Une courbe qui reste à zéro pour toujours ressemble à une mesure : il n’y en a donc aucune. Ce qu’un site a le droit d’utiliser figure dans son paquet, et ce que CyberPanel sait malgré tout reste dans le panneau lui-même.

Les sites qui existent déjà

Les sites créés en dehors de Provibr peuvent être importés depuis la page de l’intégration : l’agent énumère ce qui se trouve sur le panneau, et vous choisissez lesquels deviennent un serveur dans Provibr.

Un site importé compte dans votre capacité à partir de ce moment, comme tout autre serveur web.

Ce que cela ne fait pas

Provibr gère des sites, pas le panneau : il n’installe pas CyberPanel, ne le met pas à jour et ne modifie aucun réglage serveur. Il n’y a pas de console, et le DNS, les boîtes aux lettres et les bases de données restent intacts. CyberPanel sait tout faire lui-même, et Provibr ne le pilote pas.

PrécédentHestiaCP SuivantCloudPanel