Sécuriser une intégration API consiste à donner à chaque application les accès nécessaires à son échange, puis à pouvoir renouveler ou retirer ces accès en maîtrisant les conséquences sur les données et les traitements.
Une connexion peut fonctionner avec un compte trop puissant, un secret copié entre environnements ou un jeton dont personne ne suit l’expiration. Le premier appel réussi ne valide donc ni les droits accordés ni le comportement après une révocation.
La première vérification porte sur le mécanisme réellement proposé par l’éditeur : clé d’API, OAuth ou autre interface documentée. Il faut ensuite distinguer l’identité du client, ses permissions et les ressources auxquelles il peut accéder. Les exemples de comptes et d’opérations ci-dessous sont pédagogiques ; ils ne décrivent pas un audit client.
Ces contrôles complètent le parcours du guide d’intégration API. Si votre besoin concerne déjà des logiciels identifiés, notre accompagnement en intégration API permet de cadrer les accès, les échanges et les responsabilités avec les équipes et prestataires concernés.
1. Définir le périmètre des accès consommés
Ce guide concerne une application qui utilise les interfaces d’un ERP, d’un CRM, d’un outil logistique ou d’un partenaire. Une partie des contrôles appartient au fournisseur ; une autre relève de l’intégration et de son exploitation. Commencez par identifier ces frontières, sans supposer que tous les paramètres sont modifiables par votre équipe.
Pour chaque échange, relevez le logiciel et l’environnement, l’application qui appelle, les opérations nécessaires, le propriétaire des accès et les données concernées. Précisez si l’application agit pour son propre compte ou au nom d’un utilisateur. Cette distinction influence le choix du mécanisme et les permissions à vérifier.
Conserver un inventaire utilisable
L’inventaire doit permettre de retrouver où l’accès est utilisé, qui peut demander sa modification et comment connaître son état. Il référence le dispositif de stockage et la version utile au diagnostic ; il ne constitue pas un second fichier de mots de passe. Limitez sa consultation aux personnes qui en ont besoin.
Séparez les accès de test et de production lorsque l’interface le permet et vérifiez les opérations réellement autorisées. Un compte de démonstration très permissif ne prouve pas que le compte prévu pour la production possède les bons droits. À l’inverse, un compte administrateur fonctionnel ne justifie pas de l’utiliser pour une simple lecture de catalogue.
2. Utiliser le mécanisme proposé par le fournisseur
Le choix part de la documentation officielle du logiciel et des conditions d’accès de votre contrat. Une API peut proposer une clé, un mécanisme OAuth ou une autre forme d’authentification. Il faut confirmer les possibilités dans l’environnement concerné, y compris les opérations disponibles et les restrictions propres au compte.
OAuth est un cadre d’autorisation ; OpenID Connect ajoute une couche d’identité. Un jeton d’identité destiné à une application ne doit pas être utilisé par défaut comme jeton d’accès à une API. Le format JWT et le protocole OAuth sont également deux notions distinctes : un accès OAuth ne vous autorise pas à supposer que son jeton est un JWT à interpréter localement.
Distinguer application et délégation utilisateur
Le flux client_credentials concerne un client confidentiel agissant pour son propre compte, lorsque le serveur d’autorisation le propose. Une délégation utilisateur suit un autre parcours, souvent un code d’autorisation avec PKCE selon les possibilités et les exigences du fournisseur. Les recommandations actuelles sont décrites dans la RFC 9700 sur la sécurité OAuth.
Vérifiez la durée de validité, l’audience, les permissions et la manière d’obtenir un nouveau jeton. Ne supposez pas qu’un refresh token sera disponible pour chaque flux. Une intégration doit savoir gérer les refus et le renouvellement documentés plutôt que conserver indéfiniment un jeton copié lors du développement.
La durée d’un jeton dépend du fournisseur et de la politique retenue. L’objectif est de comprendre l’exposition, les garanties disponibles et la conduite à tenir lorsqu’un accès expire ou doit être retiré.
3. Vérifier les permissions et l’accès aux objets
Une authentification réussie prouve seulement qu’un mécanisme d’identification a été accepté. Elle ne suffit pas à autoriser toutes les opérations sur toutes les ressources. Distinguez les droits de lecture, de création, de modification et de suppression, puis vérifiez les restrictions portant sur le compte, le client ou l’objet visé.
Dans un exemple fictif, un connecteur logistique peut lire les commandes autorisées et transmettre un retour d’expédition, tout en restant incapable de modifier un tarif commercial. Le test doit vérifier ces deux résultats : l’action attendue est acceptée et l’action hors périmètre est refusée.
Tester un autre compte et une autre opération
Un scope large comme orders:write ne décrit pas à lui seul tous les contrôles métier. Vérifiez qu’un identifiant appartenant à un autre compte ne permet pas de franchir les limites prévues. Ce risque est décrit par l’OWASP dans le contrôle d’autorisation au niveau des objets.
Préparez un objet autorisé, un objet hors périmètre et une action non permise. Réalisez ces essais dans un environnement prévu à cet effet, avec des données de test et un résultat attendu. Si le fournisseur ne permet pas de réduire certains droits, documentez cette contrainte et les protections complémentaires possibles au lieu de prétendre qu’un scope plus fin existe.
4. Relier chaque situation à un contrôle
La grille suivante organise une revue d’accès. Elle ne remplace pas le protocole d’incident ni les règles du fournisseur. Les décisions doivent être attribuées à des personnes autorisées et reliées à des preuves consultables sans exposer les secrets.
Accès, renouvellement et refus : quoi vérifier ?
| Situation | Contrôle | Décision à préparer | Preuve attendue |
|---|---|---|---|
| Échange serveur à serveur | Mécanisme documenté, client identifié, environnement et permissions. | Accorder seulement les capacités nécessaires disponibles. | Opération autorisée réussie et action hors périmètre refusée. |
| Délégation utilisateur | Flux pris en charge, contexte de délégation et ressources accessibles. | Séparer connexion de l’utilisateur et autorisation des appels. | Accès au bon compte ; refus sur un objet non autorisé. |
| Jeton refusé | Expiration, permissions, environnement et configuration officielle. | Corriger ou renouveler selon le contrat, sans boucle aveugle. | Appel contrôlé accepté avec le bon périmètre. |
| Rotation planifiée | Consommateurs connus et mécanisme de transition disponible. | Tester la bascule ; coexistence seulement si prévue et maîtrisée. | Nouvelle valeur utilisée ; ancienne valeur retirée selon le plan. |
| Secret compromis | Exposition, accès ouverts et responsabilités du protocole d’incident. | Révoquer ou remplacer l’accès concerné selon le dispositif applicable. | Accès exposé inutilisable ; remplacement et effets vérifiés. |
| Objet d’un autre compte | Autorisation effective sur la ressource, pas seulement validité du jeton. | Refuser et examiner la règle d’accès. | Aucune donnée ou action hors du périmètre autorisé. |
5. Stocker les secrets et préparer leur remplacement
Les clés et jetons doivent être conservés dans un dispositif adapté à l’application, avec des accès maîtrisés. Évitez de les recopier dans le code, les tickets, les exemples publics ou les journaux. La procédure doit aussi préciser leur distribution aux composants qui les utilisent et la manière d’identifier une ancienne version encore active.
Un coffre ne résout pas à lui seul la question des consommateurs oubliés. Relevez les workers, tâches planifiées et environnements qui dépendent de l’accès. Vérifiez qui peut modifier la configuration et comment tester la connexion après remplacement. Le guide OWASP sur la gestion des secrets développe le stockage, les permissions et le cycle de vie de ces valeurs.
Séparer rotation planifiée et compromission
Une rotation planifiée permet de préparer une transition selon les possibilités du fournisseur. Certains mécanismes autorisent plusieurs valeurs pendant une période contrôlée ; d’autres imposent un remplacement qui demande une coordination différente. La coexistence n’est donc pas une obligation universelle, ni une possibilité à inventer.
Une compromission change la décision : l’ancienne valeur exposée ne constitue pas un retour arrière sûr. Le protocole d’incident doit organiser la révocation ou le remplacement, l’examen de l’exposition et la vérification des traitements affectés. N’attendez pas le calendrier normal de rotation pour qualifier ce cas.
La fréquence des rotations et des exercices doit être justifiée par le risque, les exigences applicables et le mécanisme proposé. Une cadence mensuelle ou trimestrielle sans ce contexte ne constitue pas une règle générale. Conservez surtout la preuve qu’une transition et un retrait d’accès peuvent être réalisés dans les conditions prévues.
6. Vérifier transport, jetons et notifications selon leur protocole
Les échanges concernés doivent utiliser un transport protégé avec vérification des certificats. Une panne ou un environnement de test ne justifient pas de désactiver cette vérification dans le parcours de production. Si l’interface exige un certificat client ou une signature, appliquez son mécanisme officiel et les contrôles attendus avant l’effet métier.
Pour un jeton JWT effectivement utilisé dans ce rôle, les règles de validation portent notamment sur le profil attendu, l’émetteur, l’audience, les dates et les algorithmes autorisés. Elles doivent être mises en œuvre avec une bibliothèque adaptée et la configuration du fournisseur. Décoder un jeton sans valider ses garanties ne constitue pas une authentification.
Ne pas confondre identifiant et protection contre le rejeu
Lorsque le protocole prévoit une protection contre le rejeu, le destinataire doit contrôler la validité du message et détecter sa réutilisation selon les garanties de l’interface. La seule présence d’un identifiant, d’un horodatage ou d’un nonce ne suffit pas. Il faut comprendre le contrôle effectivement réalisé et les informations nécessaires à son application.
Une signature de webhook et un jeton d’accès sont des mécanismes distincts. Pour une notification, vérifiez les exigences de signature, le contenu signé, les possibilités de nouvelle livraison et les identifiants disponibles. Les répétitions légitimes d’une notification doivent être distinguées d’une acceptation non autorisée ; la protection de l’accès ne remplace pas le traitement des doublons métier.
Pour les validations JWT, la RFC 8725 fournit les bonnes pratiques. Les paramètres propres à votre interface restent ceux de sa documentation. Ce guide n’ajoute pas un protocole de signature maison à une API existante.
7. Distinguer refus d’accès, quota et compromission
Une réponse 401 ou 403 peut provenir d’une expiration, d’un accès insuffisant ou d’une configuration erronée ; elle ne démontre pas à elle seule une fuite. Relisez sa signification dans le contrat, l’identité utilisée et le dernier changement connu. Répéter le même appel avec les mêmes identifiants refusés ne constitue pas un diagnostic.
Un 429 concerne la limitation du débit selon l’interface appelée. Examinez le quota partagé, les reprises automatiques et les indications de temporisation disponibles. Il faut distinguer un consommateur légitime trop rapide, une mauvaise politique de reprise et une activité suspecte ; un nombre fixe de trois erreurs ne permet pas de trancher tous ces cas.
Conserver une décision et une responsabilité
La personne autorisée doit savoir quand ralentir, corriger la configuration, suspendre un accès ou escalader. Cette décision dépend de l’exposition et des effets possibles, avec un horaire de réévaluation et une trace. Les actions sensibles doivent suivre votre protocole plutôt qu’une consigne improvisée à partir du seul statut HTTP.
Le guide de diagnostic d’un incident API approfondit la collecte des preuves et la vérification de l’état distant avant une reprise. Il ne faut pas confondre le renouvellement d’un accès avec l’autorisation de répéter une création qui a peut-être déjà abouti.
8. Conserver des traces utiles et tester les refus
Le diagnostic doit pouvoir relier un appel à une application, un environnement, une opération et un résultat. Conservez les identifiants techniques utiles et une référence non sensible de version lorsque le dispositif le permet. Ne recopiez ni la valeur du secret ni le jeton complet pour prouver quel accès a servi.
Distinguez les besoins de diagnostic des preuves d’audit. Définissez les personnes autorisées, les données nécessaires et les durées adaptées à leurs finalités. Une collecte plus détaillée pendant un incident doit rester maîtrisée ; elle ne justifie pas de conserver systématiquement tous les corps de requête.
Transformer les erreurs connues en essais
- Jeton valide, mauvais objet. Vérifier le refus d’un accès à un compte hors périmètre.
- Ancien accès retiré. Vérifier qu’il ne fonctionne plus après la transition prévue, sans le réintroduire par une configuration secondaire.
- Permissions insuffisantes. Obtenir un diagnostic exploitable sans élargir automatiquement les droits.
- Notification répétée. Appliquer le contrôle officiel du fournisseur et vérifier que le traitement ne produit pas un effet métier supplémentaire non prévu.
- Erreur de configuration. Vérifier qu’elle ne déclenche pas une boucle d’appels ou une copie du secret dans un message d’erreur.
Ces essais utilisent des comptes et objets de test sur un périmètre autorisé. Le résultat attendu doit être écrit avant l’exécution, y compris pour les refus. Le support doit retrouver une cause et une action possible sans disposer du secret lui-même.
9. Préparer une revue d’accès réalisable
Commencez par un échange important dont les responsables et les interfaces sont identifiés. Recensez les accès utilisés, vérifiez leurs permissions, puis choisissez les essais représentatifs. Le calendrier dépend des possibilités du fournisseur, des validations et des environnements disponibles ; il ne découle pas d’un plan universel de quatre-vingt-dix jours.
- Identifier le client, ses consommateurs et le propriétaire de l’accès.
- Confirmer le mécanisme, les permissions et les opérations effectivement disponibles.
- Tester le fonctionnement autorisé et les refus importants.
- Documenter le renouvellement, le retrait et le protocole en cas d’exposition.
- Faire vérifier le diagnostic, les responsabilités et les données conservées.
Les points inconnus restent des dépendances à traiter. Un accès sans responsable ou un retrait impossible à vérifier demande un arbitrage avant d’élargir l’intégration. Une revue ne doit pas être annoncée comme un audit de sécurité complet si elle ne couvre que les accès de ce parcours.
10. Relier les droits au parcours utilisateur
Dans le projet d’espace client Corim connecté à l’ERP Colline, le compte, la licence et les droits participent aux services accessibles dans le portail. Ce contexte montre pourquoi la réception d’une donnée et le droit de l’afficher ou d’agir sur elle doivent rester distingués.
Les droits du portail et les permissions d’un connecteur ne sont pas interchangeables. Définissez ce que le compte technique peut récupérer, puis ce que l’application web peut restituer à chaque utilisateur. Les mécanismes propres aux interfaces doivent être confirmés avec leurs responsables et leur documentation.
11. Approfondir le protocole et le diagnostic
Pour les mécanismes OAuth, reportez-vous d’abord à la documentation du fournisseur et à la RFC de bonnes pratiques OAuth. Pour le stockage et le cycle de vie, utilisez la fiche OWASP sur les secrets.
Le diagnostic d’un flux API bloqué prend le relais lorsqu’une opération est refusée ou incertaine. Le guide d’intégration API relie ces accès au choix des interfaces, des données et des critères de recette.
12. Conclusion : vérifier ce qui est permis et ce qui doit être refusé
Un accès fonctionnel constitue le début de la vérification. Il faut encore confirmer son périmètre, les ressources autorisées et les conditions de renouvellement ou de retrait.
Préparez les refus autant que le parcours normal. Les tests sur un mauvais compte, une permission absente ou un ancien accès retiré rendent visibles des contrôles qu’un appel réussi ne permet pas d’évaluer.
Conservez des traces utiles et une procédure compréhensible pour les personnes concernées. Les valeurs chiffrées et les mécanismes doivent rester rattachés au fournisseur, au risque et aux politiques applicables.
Pour relier ces décisions à vos logiciels et à leurs échanges, notre accompagnement en intégration API permet de cadrer les accès, la recette et les responsabilités d’exploitation du parcours.