Intégration API

Sécuriser une intégration API : jetons, droits et secrets

Jérémy Chomel Dawap
  • Publié le : 22 mars 2025
  • Mis à jour le : 2 novembre 2026
  • Temps de lecture : 12 minutes
  1. Définir le périmètre des accès consommés
  2. Utiliser le mécanisme proposé par le fournisseur
  3. Vérifier les permissions et l’accès aux objets
  4. Relier chaque situation à un contrôle
  5. Stocker les secrets et préparer leur remplacement
  6. Vérifier transport, jetons et notifications selon leur protocole
  7. Distinguer refus d’accès, quota et compromission
  8. Conserver des traces utiles et tester les refus
  9. Préparer une revue d’accès réalisable
  10. Relier les droits au parcours utilisateur
  11. Approfondir le protocole et le diagnostic
  12. Conclusion : vérifier ce qui est permis et ce qui doit être refusé
Portrait de Jérémy Chomel

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 ?

Contrôles à adapter aux interfaces, aux droits disponibles et au risque du parcours.
SituationContrôleDécision à préparerPreuve attendue
Échange serveur à serveurMé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 utilisateurFlux 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éeConsommateurs 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 compromisExposition, 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 compteAutorisation 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.

  1. Identifier le client, ses consommateurs et le propriétaire de l’accès.
  2. Confirmer le mécanisme, les permissions et les opérations effectivement disponibles.
  3. Tester le fonctionnement autorisé et les refus importants.
  4. Documenter le renouvellement, le retrait et le protocole en cas d’exposition.
  5. 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.

Portrait de Jérémy Chomel

Cadrons les accès de votre intégration.

Les logiciels, les opérations nécessaires et les responsabilités : préparons un échange testable avec les bons accès et une maintenance définie.

Vous préférez échanger ? Planifier un rendez-vous

Articles recommandés

Comprendre l’intégration API : étapes et cas concrets Intégration API Comprendre l’intégration API : étapes et cas concrets Lire l'article
  • 20 juillet 2024
  • Lecture ~25 min

Suivez la commande 1UP de Wix à ShippingBo et Odoo, comparez quatre architectures et préparez vos données, vos contrôles et votre maintenance. Ce guide relie les décisions techniques aux projets Fauré Le Page, Velizen, Corim et CHL Logistics pour cadrer une intégration API et approfondir chaque sujet avec les guides spécialisés.

Diagnostiquer un incident API sans créer de doublon Intégration API Diagnostic incident API : erreurs, traces et reprise Lire l'article
  • 9 juin 2025
  • Lecture ~15 min

Retrouvez l’opération, les effets déjà produits et la prochaine vérification avant de relancer. La matrice distingue accès refusé, quota, donnée rejetée et résultat incertain. Trois scénarios fictifs et une sonde HTTP qui gère aussi les réponses non JSON aident à préparer le diagnostic et la clôture.

Observabilité API et runbooks pour piloter le run en production Intégration API Observabilité API et runbooks : piloter le run en production Lire l'article
  • 24 mars 2025
  • Lecture ~28 min

L’observabilité API tient quand les SLO, les logs corrélés, les traces et les modes opératoires racontent la même histoire au support. Sans ce socle, les alertes arrivent trop tard, les incidents se répètent et le run devient une enquête artisanale au lieu de rester pilotable. Chaque alerte débouche ainsi sur un diagnostic, un seuil de gel et une preuve de clôture.

Idempotence API : éviter les doublons métier Intégration API Idempotence API : éviter les doublons métier Lire l'article
  • 25 mai 2025
  • Lecture ~46 min

Une intégration API peut sembler fonctionner correctement pendant des semaines, puis générer soudainement des doublons de commandes, de paiements ou d’écritures comptables. Ce type d’incident coûte rarement seulement du temps technique. Il mobilise aussi le support, la finance et le commerce dans le run métier.