Avec PrestaShop 9, l’Admin API ouvre une nouvelle ère pour les intégrations back-office : plus moderne, mieux structurée, et surtout pensée pour être sécurisée. Là où les webservices « legacy » reposaient souvent sur des clés statiques, l’Admin API s’appuie sur un standard officiel : OAuth2, explicitement décrit comme base du mécanisme d’authentification.
Dans cet article, nous allons voir comment sécuriser vos échanges « server-to-server » avec le bon workflow OAuth2, comment raisonner en scopes (permissions), et quelles bonnes pratiques appliquer (HTTPS, rotation de secrets, tests). L’objectif est de vous aider à construire une couche d’intégration robuste et évolutive, dans un contexte où l’Admin API continue d’évoluer avec de nouveaux endpoints.
1) Admin API PrestaShop 9 : une base moderne, et un virage sécurité
L’Admin API de PrestaShop 9 est conçue sur une base technologique moderne : elle s’appuie sur API Platform v3 et utilise une approche CQRS (Command Query Responsibility Segregation) via des « CQRS commands ». Cette architecture favorise des intégrations plus isolées et plus maintenables, en séparant clairement la lecture (queries) et les modifications (commands).
Cette modernisation s’inscrit aussi dans une transition assumée : l’écosystème vise à migrer « away from legacy web services toward a robust, future-proof integration layer ». Autrement dit, l’Admin API est appelée à devenir la référence pour interfacer PrestaShop avec des ERP, PIM, WMS, services de pricing, moteurs de recherche, etc.
Côté disponibilité, c’est un point important : l’Admin API est « enabled by default » dans PrestaShop 9, donc utilisable out-of-the-box. Mais la posture sécurité doit rester pragmatique : le Help Center précise que l’API est « still under development », avec des endpoints ajoutés et améliorés progressivement. Il faut donc anticiper les évolutions (versions, scopes, endpoints, module de diffusion) dans vos intégrations.
2) OAuth2 au cœur : Resource Server, Authorization Server interne ou externe
PrestaShop 9 positionne clairement l’Admin API : « The Admin API is based on the OAuth2 protocol. » Concrètement, cela change la philosophie d’accès : on n’envoie plus une clé API statique à chaque requête, on obtient un jeton d’accès (access token) à durée de vie limitée, et on l’utilise ensuite via un er standard.
Sur le plan d’architecture OAuth2, la documentation rappelle que « PrestaShop is always the resource server ». Cela signifie que l’API (les ressources protégées) est servie par PrestaShop, et que la validation des jetons est effectuée selon les règles OAuth2/OIDC prévues.
En revanche, le serveur d’autorisation (Authorization Server) peut être interne ou externe. PrestaShop permet donc des scénarios où vous déléguez l’émission des tokens à une solution IAM (Identity & Access Management) comme Keycloak, tout en gardant PrestaShop comme Resource Server. Cette séparation facilite l’alignement avec des politiques SI existantes (SSO, rotation, audits, segmentation des clients).
3) Le workflow recommandé “server-to-server” : Client Credentials
Pour la majorité des intégrations techniques (ERP, middleware, job d’import, connecteur SaaS), la documentation est explicite : « For ‘server-to-server’ interactions, the recommended OAuth workflow is the client credentials workflow. » C’est le bon choix quand aucun utilisateur n’est « devant l’écran » pour consentir, et que c’est une application qui parle à une autre.
Un point souvent sous-estimé est le contexte d’exécution : « The operations made via this workflow will be associated to an application not a user. » En pratique, cela implique que l’audit, la traçabilité et la gestion des droits doivent être pensés au niveau de l’application (client), pas d’un compte employé. C’est excellent pour isoler un connecteur (ex. “PIM-prod”) d’un autre (ex. “WMS-test”).
Côté implémentation, le principe est simple : votre intégration (client) s’authentifie avec un client_id / client_secret auprès du serveur d’autorisation, reçoit un access token, puis appelle l’Admin API avec ce token. Il faut ensuite gérer le cycle de vie : expiration, renouvellement automatique, stockage sécurisé du secret, et limitation des scopes au strict nécessaire.
4) Scopes : la clé d’une sécurité “least privilege” (et des 403 utiles)
OAuth2 dans PrestaShop 9 n’est pas seulement une méthode d’authentification ; c’est un modèle d’autorisation fin. La doc précise que « the first request to get an access token already has to define the scopes (or permissions)… ». Autrement dit, vous annoncez dès la demande de token ce que vous voulez avoir le droit de faire.
Cette exigence pousse naturellement vers le principe du moindre privilège : un connecteur d’expédition n’a pas besoin des mêmes droits qu’un connecteur de catalogue. En définissant des scopes séparés par cas d’usage, vous réduisez l’impact d’une fuite de token ou d’une compromission du client.
Et surtout, le comportement en cas d’écart est clair. La documentation fournit un exemple de politique de scopes : un appel sans scope requis renvoie une erreur 403 avec un JSON indiquant notamment status: 403 et detail: "Invalid scope.". C’est un signal précieux pour le diagnostic, et une garde-fou de sécurité indispensable pour éviter les « permissions implicites ».
5) Appeler l’Admin API : Bearer token, endpoint d’info client, durée de vie
Une fois le token obtenu, la règle est standard : vos requêtes vers l’Admin API doivent inclure un er Authorization: Bearer YOUR_ACCESS_TOKEN. La documentation « How to use » illustre notamment un endpoint pratique pour valider votre configuration : GET /admin-api/api-client/infos.
Cet endpoint est utile pour vérifier rapidement trois éléments : (1) que le token est bien accepté, (2) que vos scopes correspondent à ce qui est attendu, et (3) que vous appelez le bon environnement. C’est aussi une base simple pour construire des checks de santé (health checks) de votre intégration.
La réponse d’exemple montre également une information clé : la durée de vie du token, avec un champ "lifetime": 3600 (en secondes). En production, cela doit guider votre stratégie de renouvellement : rafraîchir avant expiration, gérer la dérive d’horloge, et éviter de demander un token à chaque appel (risque de throttling côté serveur d’autorisation).
6) HTTPS, TLS et pratiques de transport : la sécurité “incontournable”
OAuth2 protège l’accès logique (qui a le droit), mais ne remplace jamais la sécurité du transport. Les communications doivent être chiffrées : la documentation et les communications officielles rappellent une exigence d’HTTPS en production, avec la possibilité d’assouplir certains contrôles TLS uniquement en mode debug (ce qui doit rester strictement limité aux environnements de développement).
Ce point fait écho aux recommandations historiques du webservice PrestaShop 8, où l’on insistait déjà : « For security reasons, make sure your shop’s server supports secure SSL connection. » La différence majeure avec PrestaShop 9, c’est que le couple OAuth2 + HTTPS fournit un modèle plus robuste que « clé statique + SSL » pour la majorité des scénarios modernes.
Dans votre checklist sécurité, ajoutez aussi : pinning ou validation stricte des certificats côté client, désactivation des suites faibles, monitoring des erreurs TLS, et séparation claire des environnements (dev/staging/prod) avec des clients OAuth distincts. Un token intercepté sur un transport non chiffré annule à lui seul les bénéfices d’OAuth.
7) Exemple avec serveur externe : Keycloak et client_credentials
PrestaShop documente un exemple officiel avec Keycloak, très parlant pour les SI déjà outillés. L’idée : utiliser l’endpoint token OpenID Connect de Keycloak (du type .../protocol/openid-connect/token) et demander un jeton via grant_type=client_credentials.
La démonstration met aussi en avant l’inclusion des scopes dans la demande : vous envoyez à la fois l’identité applicative (client_id/secret) et l’énumération des permissions souhaitées. Cela matérialise l’approche « déclarative » : pas de droits cachés, pas d’élévation implicite.
Ce modèle est particulièrement adapté si vous devez : centraliser les secrets, gérer des politiques de rotation, imposer des contraintes réseau (IP allowlist), ou consolider des audits. Et comme PrestaShop reste Resource Server, vous gardez une cohérence d’API tout en industrialisant la gestion des identités applicatives.
8) Qualité, tests et gouvernance : sécuriser aussi par le cycle de contribution
L’Admin API évolue : c’est un chantier actif avec des endpoints en cours d’ajout. Cette réalité doit vous pousser à traiter la sécurité comme un processus, pas comme une case à cocher. D’un côté, vous bénéficiez d’améliorations régulières ; de l’autre, vous devez suivre les changements (nouvelles ressources, nouveaux scopes, comportement affiné).
Côté cœur et écosystème, la roadmap indique que les endpoints mergés sont intégrés au module ps_apiresources, véhicule de diffusion des ressources Admin API, avec un objectif « by the end of 2025 ». Cela signifie que la surface d’API disponible peut s’étendre sans attendre une refonte complète, via un canal de distribution maîtrisé.
Enfin, la sécurité passe aussi par les tests : les docs de contribution mentionnent une base ApiTestCase et des helpers comme getItem/createItem qui acceptent array $scopes = []. C’est une excellente pratique : tester explicitement les scopes au moment des requêtes (cas OK, cas 403, cas scope manquant) pour éviter les régressions. Pour contribuer ou suivre les échanges, un canal Slack dédié #cfc-adminapi est également mentionné.
9) Outillage : docs Swagger/OpenAPI et industrialisation des appels
Pour accélérer et fiabiliser vos intégrations, l’Admin API expose une documentation auto-générée : une page Swagger à l’URL .../admin-api/docs. et une spécification OpenAPI JSON à .../admin-api/docs.json. C’est particulièrement utile pour importer une collection dans Postman, générer des clients, ou alimenter des tests contractuels.
Au-delà du confort, cet outillage renforce la sécurité opérationnelle : vous standardisez les appels, vous limitez les erreurs de sérialisation, et vous rendez plus visibles les exigences d’auth (Bearer token) et d’autorisations (scopes). Une équipe intégration peut ainsi vérifier rapidement qu’un endpoint nécessite un scope précis avant de passer en production.
Dans une démarche mature, couplez OpenAPI à des contrôles automatisés : validation de schémas, tests d’intégration en CI, et scanners de dépendances. L’objectif est d’éviter les « contournements » non documentés et de garder un alignement strict entre ce qui est exposé et ce qui est réellement autorisé.
Sécuriser vos intégrations avec l’Admin API PrestaShop 9, c’est adopter un socle standard (OAuth2), une logique de permissions explicites (scopes) et des pratiques de transport strictes (HTTPS/TLS). Le workflow Client Credentials est particulièrement adapté aux échanges applicatifs, en associant les opérations à une application plutôt qu’à un utilisateur.
Enfin, gardez à l’esprit que l’Admin API progresse : endpoints, module ps_apiresources, contributions et tests continuent de renforcer la plateforme. En structurant vos intégrations autour d’OAuth2, des scopes et de l’outillage OpenAPI, vous préparez une transition durable depuis les webservices legacy vers une couche d’intégration plus robuste et « future-proof ».

