Documentation

ISPConfig

Provibr gère les comptes d’hébergement ISPConfig au moyen de l’API distante du panneau. L’agent se connecte en sortie vers votre installation ISPConfig, il n’y a donc aucun port entrant ni VPN. Cette page décrit ce qui distingue ISPConfig et ce que fait l’intégration.

Un compte, c’est un site

ISPConfig sépare le client (le client final, avec un identifiant et un ensemble de limites) du web_domain (le site). Un compte d’hébergement Provibr, c’est un site, identifié par son domaine. Créer un site suppose un propriétaire : Provibr crée donc un client neuf et un site en dessous, et supprime les deux à nouveau lorsque vous supprimez le compte. L’agent déduit l’identifiant du client à partir du domaine, de sorte qu’il retrouve toujours le propriétaire.

Ce dont l’agent a besoin

Quatre champs, saisis une seule fois lorsque vous connectez l’intégration :

L’adresse du panneau : l’URL https complète, port compris (8080 par défaut).
Un utilisateur distant : créé sous System → Remote Users, limité aux fonctions client et sites.
Le mot de passe de cet utilisateur distant.
L’empreinte TLS du panneau : recommandée, car une installation neuve est auto-signée.

L’utilisateur distant est un compte distinct, pas votre administrateur du panneau. ISPConfig vous permet de le limiter exactement aux fonctions que Provibr utilise, de sorte que l’identifiant dans le coffre de l’agent peut se borner aux appels client et sites, et à rien d’autre.

Le certificat

ISPConfig écoute sur le port 8080 en TLS, et une installation neuve présente un certificat auto-signé. Épinglez son empreinte pour que l’agent soit sûr d’atteindre votre panneau. Lisez-la avec une commande shell depuis n’importe quelle machine qui atteint le panneau :

shell

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

Si vous posez votre propre certificat sur le nom d’hôte du panneau, par exemple avec Let's Encrypt, sa chaîne se valide et vous pouvez laisser l’empreinte vide. C’est le meilleur choix dans ce cas, car un tel certificat se renouvelle régulièrement et un certificat épinglé devrait être remplacé à chaque fois.

Paquets

Un paquet ISPConfig est un modèle de client, la même chose à laquelle renvoie un forfait Provibr. Il fixe les limites qu’obtient un client : combien de sites, combien de disque et de trafic, quels services.

Vous choisissez un paquet par son nom dans le formulaire de commande, et le changez ensuite sans interruption. Le changer déplace les limites du client d’un seul coup.

L’API distante ne peut pas créer de modèle de client, vous construisez donc les paquets vous-même dans le panneau ISPConfig. Provibr ne fait qu’y renvoyer par leur nom ; un nom qu’il ne reconnaît pas est refusé avant que rien ne soit créé.

Le cycle de vie d’un compte

Créer un compte, c’est deux étapes derrière une seule commande : un client et un site en dessous. À partir de là, le compte se comporte comme tout autre compte d’hébergement :

Créer : un client avec le paquet choisi, et un site avec son domaine et son quota.
Suspendre et réactiver : le site passe hors ligne et revient, de façon réversible.
Changer de paquet : attribuer un autre modèle de client.
Supprimer : le client et son site, nettoyés ensemble.

La suspension

Suspendre bascule l’indicateur actif du site. Le site passe hors ligne ; l’identifiant du client reste. Provibr lit le même indicateur qu’il écrit, si bien que le panneau et ce que vous voyez ne divergent jamais.

L’indicateur en base bascule aussitôt, mais la configuration du serveur web est réécrite par la tâche à la minute du panneau. Ce que Provibr affiche est l’indicateur actif, et c’est cohérent immédiatement.

Utilisation

ISPConfig indique l’utilisation : le disque par site face à son quota, et le trafic du mois en cours. Les deux apparaissent dans les graphiques comme pour une machine virtuelle.

L’utilisation du disque n’est renseignée qu’une fois la tâche de surveillance du panneau exécutée, si bien que sur un site neuf il n’y a pas encore de relevé, ce qui n’est pas la même chose que zéro. Le trafic vient d’un seul appel pour tous les sites ; le disque, d’un appel par client.

L’importation

Les comptes que vous avez créés dans ISPConfig en dehors de Provibr peuvent être importés : l’intégration liste les sites que le panneau connaît, et vous choisissez ceux à reprendre. Les comptes que vous n’avez pas créés via Provibr sont laissés tels quels jusqu’à ce que vous le fassiez.

PrécédentCloudPanel SuivantPterodactyl