Cet article présente l’approche recommandée pour intégrer les services WEDOS.protection à votre propre interface d’administration. Pour plus d’informations, ainsi que pour les autres options de revente proposées aux clients B2B, voir l’article Global – Options revendeur B2B.
Dans cet article, vous découvrirez :
- Quelles fonctionnalités WEDOS.protection sont disponibles via l’API
- Comment gérer les services
- Foire aux questions
WEDOS.protection Fonctionnalités de l’API
Pour une expérience utilisateur plus fluide, nous recommandons à nos partenaires B2B d’utiliser l’API WEDOS (WAPI en abrégé) et d’intégrer les services WEDOS dans leurs propres panneaux d’administration, que les clients finaux connaissent déjà.
Avant de poursuivre votre lecture, familiarisez-vous avec l’API WEDOS en lisant Manuel WAPI.
WAPI prend actuellement en charge les fonctionnalités WEDOS.protection suivantes :
- Obtention des informations sur le service (domaine) depuis le système. Vous pouvez récupérer la liste de tous les services de votre compte avec la
wgp-services-listcommande, ou toutes les informations disponibles sur un seul service avecwgp-domain-info. - Ajout d’un service au système. Cela comprend
wgp-domain-create(tente d'ajouter un domaine au système) etwgp-domain-retry(réessaie d'ajouter le domaine en cas d'erreur) commandes. - Gestion du domaine. Vous pouvez utiliser WAPI pour prolonger un domaine qui n’a pas encore été supprimé (
wgp-domain-renew), remove a domain from the system (wgp-domain-delete) or change the subscription plan (wgp-domain-update-subscription). - Application des modèles de domaine. Modèles de domaine sera le moyen le plus simple de répliquer les paramètres sur les domaines de vos utilisateurs. Vous pouvez utiliser les commandes WAPI
wgp-domain-templates-listpour vérifier quels modèles sont disponibles, etwgp-domain-template-replicatepour appliquer un modèle à un domaine cible. - Vidage du cache du domaine. Actuellement, la seule commande permettant d’agir directement sur les paramètres de domaine WEDOS.protection est
wgp-domain-cache-purge(efface tous les fichiers statiques mis en cache pour le domaine).
Pour des informations complètes sur ces commandes, consultez l’article WAPI – WEDOS.protection (WGP).
Gestion des services
Les conseils suivants reposent sur les hypothèses suivantes :
- Vous disposez d’un compte client et d’un compte de crédit B2B WEDOS. Ce compte client servira à créer tous les services que vous revendez, et ces services seront également facturés à ce compte (via un crédit négatif – pour plus d’informations, voir l’article WEDOS – Compte de crédit ou consultez votre représentant commercial WEDOS). La manière dont vous gérez la facturation de votre côté vous appartient entièrement.
- Vos clients accéderont aux services WEDOS.protection uniquement via votre panneau d’administration. Cette approche nécessite de configurer l’accès WAPI et de l’utiliser pour permettre à vos clients d’acheter des produits WEDOS via votre compte (voir ci-dessus). Pour plus d’informations, voir l’article Global – Options revendeur B2B.
Compte tenu des fonctionnalités de WEDOS.protection actuellement disponibles via WAPI, nous vous suggérons une approche hybride pour gérer les domaines, les vôtres et ceux de vos clients :
- Vous : panneau d’administration WEDOS.global. Le panneau d’administration WEDOS.global ⧉ vous donne actuellement accès à tous les paramètres disponibles, y compris ceux qui n’ont pas encore été intégrés à WAPI. Comme toutes les interactions de vos clients avec les services passeront par WAPI, vous devez, en tant qu’administrateur, effectuer certains réglages via une interface où ils sont disponibles. Pour plus d’informations, consultez le chapitre Panneau d’administration WEDOS.global.
- Vos clients : votre panneau d’administration personnalisé. Nous vous recommandons de créer, dans votre propre panneau d’administration, une interface pour vos clients à l’aide de WAPI. Vos clients peuvent ainsi gérer les services sans avoir à créer de compte WEDOS. Pour plus d’informations, consultez le chapitre Panneau d’administration personnalisé.
Panneau d’administration WEDOS.global
Nous recommandons que vous seul (ou vos administrateurs désignés) ayez accès à vos services via le panneau d’administration WEDOS.global ⧉, et que vous maintenez une interface distincte pour vos clients finaux.
Les principaux domaines de la gestion du service WEDOS.protection actuellement accessibles uniquement dans panneau d’administration WEDOS.global ⧉ sont :
- Configuration directe du service. Si vous devez effectuer la configuration sur un seul service, par exemple configurer Filtres ou Upstream, vous devez accéder à ce service dans le panneau d'administration. Si vous souhaitez permettre à une autre personne de consulter ou de configurer ce service, vous pouvez l'ajouter en tant que membre (ils devront toutefois disposer de leur propre compte WEDOS).
- Configuration et gestion des modèles de domaine. Pour automatiser les routines de configuration fréquentes, vous pouvez utiliser l’interface d’administration afin de configurer modèles de domaine et laissez vos clients les répliquer sur leurs services via WAPI depuis votre panneau d’administration.
- IP cibles et sous-domaines. Si les adresses IP cibles ou les sous-domaines du client final changent, seul l’administrateur peut actuellement les mettre à jour. Pour en savoir plus, consultez l’article Protection – DNS et IP cibles (amont).
- Suivi des performances Grafana. Cette surveillance n’est actuellement disponible que pour l’ensemble du compte, et non pour des domaines individuels. Pour plus d’informations, voir l’article Protection – Grafana.
L’avantage supplémentaire de gérer depuis notre interface tous les services que vous revendez est que vous avez accès immédiatement à toutes les nouvelles fonctionnalités, sans avoir à les implémenter vous-même.
Panneau d’administration personnalisé
Vos clients finaux ne devraient avoir accès qu’aux services WEDOS.protection que vous revendez, depuis votre interface. Leur expérience est ainsi fluide, tandis que vous gardez le contrôle total sur les réglages qu’ils peuvent ou non effectuer.
Nous recommandons vivement d’inclure les fonctionnalités suivantes :
- Créer, renouveler et supprimer un service. Les clients doivent avoir la possibilité d’ajouter leurs domaines à WEDOS.protection, de renouveler ou de résilier leur abonnement.
Pendant l’exécution de wgp-domain-create, veillez également à vérifier périodiquement l'état du nouveau service avec wgp-domain-info. Si vous rencontrez des erreurs, en particulier error_crt, utilisez wgp-domain-retry pour tenter de résoudre le problème. Pour plus d'informations, consultez l'article WAPI – WEDOS.protection (WGP).
- Videz le cache. Vider le cache est particulièrement important lorsque les clients finaux mettent à jour des pages fréquemment consultées (comme la page d’accueil) et que leurs utilisateurs doivent voir ce changement immédiatement. Assurez-vous qu’un Vider le cache bouton qui envoie la
wgp-domain-cache-purgecommande est directement accessible à tous les clients.
Les fonctionnalités suivantes sont facultatives ; nous vous suggérons de les inclure à votre convenance :
- Gérer l’abonnement. S’il est pratique que tous vos clients utilisent le même forfait, vous pouvez leur permettre de le modifier dans votre panneau d’administration. N’oubliez pas que si un client passe à un forfait inférieur, le nouveau prix ne prend pas effet immédiatement, mais à partir de la période de facturation suivante, tandis qu’un passage à un forfait supérieur donne lieu immédiatement à un supplément. Vous trouverez plus d’informations dans l’article Protection – Formule d’abonnement.
- Configuration rapide via les modèles de domaine. Vous pouvez créer autant de modèles que vous le souhaitez dans le système et permettre à vos clients de les répliquer. Par exemple, vous pouvez créer un modèle avec blocage GeoIP, qui permet à vos utilisateurs de n’autoriser en un clic que les requêtes provenant de certains pays ou continents.
Les modèles de domaine n’appliquent leurs valeurs qu’au moment de la réplication. Si vous modifiez ultérieurement un modèle de domaine, répliquez-le à nouveau pour appliquer les nouveaux paramètres.
FAQ
Prévoyez-vous de publier des extensions pour les systèmes d’administration courants, comme DirectAdmin ?
Oui, nous développons actuellement des plugins WEDOS.protection et WEDOS.zone pour DirectAdmin. Ces plugins utilisent également WAPI ; en tant qu’administrateur, vous devrez donc toujours accéder au panneau d’administration WEDOS.global ⧉ pour certaines fonctionnalités.
