Plesk

N’utilisez pas le mot de passe administrateur. Plesk propose des clés d’API, et une clé a exactement la bonne forme pour cet usage : elle est liée au compte qui l’a créée, elle peut être limitée à un ensemble d’adresses, et vous pouvez la révoquer sans changer le mot de passe de qui que ce soit.

• Hôte : l’adresse du panneau. Le port 8443 est renseigné pour vous si vous l’omettez, et l’adresse doit être en https.
• Clé d’API : créée sous Tools & Settings, avec un compte administrateur.
• Empreinte TLS : facultative, et nécessaire tant que le panneau conserve son certificat auto-signé.

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

Plesk dispose d’une API REST et d’une API XML/RPC plus ancienne, et aucune des deux n’est complète à elle seule : REST ignore les abonnements et les offres de service, XML a tout mais répond en XML. Provibr utilise les deux : création et suppression via REST, lecture, suspension et changement d’offre via XML. La même clé ouvre les deux, si bien que vous ne renseignez qu’une seule valeur.

Contrairement à DirectAdmin, il n’y a pas ici d’option en clair : Plesk redirige le http vers le https aussi bien sur 8880 que sur 8443, si bien que Provibr refuse une adresse http au lieu de faire croire qu’elle pourrait fonctionner.

Ce qu’une installation neuve possède bel et bien, c’est un certificat auto-signé. Renseignez son empreinte et l’agent fait confiance à ce certificat précis au lieu de désactiver la vérification ; remplacez le certificat plus tard et l’empreinte doit suivre.

Une offre de service Plesk est la description qu’a le panneau d’un abonnement : quota de disque, trafic mensuel, nombre de domaines et de boîtes mail, services activés. 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 offres de service depuis le panneau, pour que vous voyiez ce que vous choisissez au lieu de saisir un nom de mémoire.

Un plan web fixe une offre de service sur une intégration et lui donne un nom de votre choix. Commander avec un plan vaut mieux que choisir une offre isolée, et le sélecteur d’offres isolées reste disponible pour les cas qu’un plan ne couvre pas.

Un abonnement est une ligne de serveur ordinaire, de type serveur web. Son identifiant est le nom de l’abonnement, qui dans Plesk est le domaine principal, et son offre de service, son quota et son trafic remontent à chaque interrogation.

• La création d’un abonnement demande un domaine principal, une adresse e-mail, une offre de service et un mot de passe. Il n’y a pas de nom de compte distinct à inventer.
• Le domaine est l’identité : c’est ce que le panneau affiche, ce sur quoi son API filtre, et ce que Provibr conserve. Il ne peut plus être modifié par la suite.
• Le mot de passe n’est consigné nulle part. Seul le fait que vous en ayez fourni un l’est ; la valeur circule séparément et devient à la fois le mot de passe du client et le mot de passe FTP.
• Ensuite, vous pouvez suspendre, réactiver, changer d’offre de service et supprimer. Il n’y a pas de console, car un compte d’hébergement n’en a pas.

L’onglet d’import liste les abonnements présents sur le panneau et vous laisse reprendre ceux que vous voulez dans Provibr. Les abonnements déjà connus sont affichés mais ne peuvent pas être sélectionnés de nouveau : vous voyez ainsi l’ensemble et non une vue filtrée.

Le quota et le trafic remontent avec l’interrogation habituelle : un abonnement obtient donc un graphique d’utilisation sans qu’il faille activer quoi que ce soit de plus. Le trafic mensuel est une propriété de l’abonnement et non un débit : il est donc affiché comme un nombre sur le compte, et non comme une courbe sur le graphique.