Intégration et continuité
Remplacer une clé API sans perdre le suivi des réservations
Remplacer une clé ne termine pas le travail : il faut identifier les applications qui l’utilisent, vérifier la nouvelle référence et confirmer la fin de l’ancien accès. Les recherches, notifications et opérations après-vente peuvent dépendre de consommateurs différents.
Identifier tous les consommateurs avant de changer l’accès
Un connecteur de recherche, un traitement nocturne, un export et un service de suivi peuvent utiliser la même identité technique. Dressez leur liste avec le responsable, l’environnement, les opérations nécessaires et la référence du secret dans le coffre autorisé. La valeur du secret reste hors du document.
Recherchez les dépendances métier : quels départs doivent être suivis, quelles notifications attendues et quels remboursements encore ouverts ? Une recherche disponible ne démontre pas que ces opérations fonctionnent. Le guide d’observabilité aide à choisir des signaux distincts.
OWASP distingue création, rotation, révocation et expiration. Un redémarrage d’application ne révoque pas un accès volé. La durée de vie et les mécanismes disponibles dépendent du secret et du fournisseur ; ce guide ne fixe pas un calendrier universel.
Choisir une stratégie compatible avec l’interface
| Capacité documentée | Préparation du projet | Limite à conserver |
|---|---|---|
| Deux clés simultanées | Préparer la nouvelle référence, tester chaque consommateur puis retirer l’ancienne. | Vérifier la durée de coexistence et le périmètre exact des droits. |
| Une seule clé active | Convenir d’une fenêtre et d’un ordre de mise à jour coordonné. | Une interruption reste possible ; confirmer le comportement des tâches en cours. |
| Jetons temporaires | Examiner obtention, renouvellement et invalidation selon le protocole. | Ne pas assimiler jeton expiré et autorisation définitivement retirée. |
| Exposition suspectée | Faire décider la révocation et la continuité par les responsables habilités. | L’urgence peut imposer l’interruption ; ne pas réutiliser un secret compromis. |
Ce tableau décrit des options, pas les fonctions d’une marque. Une réponse « oui » en démonstration doit être reliée à la documentation du compte et à un scénario convenu.
Organiser une fenêtre avec résultats attendus
- Confirmer le périmètre, l’approbateur, le contact fournisseur et les opérations suspendues.
- Préparer le remplacement par le canal sécurisé de l’organisation ; inscrire uniquement sa référence dans le plan.
- Mettre à jour chaque consommateur selon l’ordre approuvé, y compris les tâches qui ne tournent pas pendant la fenêtre.
- Vérifier une opération autorisée par consommateur et relever heure, résultat et environnement.
- Faire confirmer la révocation de l’ancienne référence, puis surveiller les erreurs d’accès.
- Attribuer les anomalies et transmettre le bilan aux personnes qui suivent les dossiers.
Les reprises d’écriture demandent une attention particulière. Une erreur de connexion ne prouve pas que la réservation ou le paiement a échoué avant traitement. Retrouvez l’état fournisseur et la référence métier avant toute relance ; utilisez la méthode du guide de reprise sans doublon.
Exemple fictif : la recherche marche, la synchronisation échoue
Une OTA remplace l’accès de son connecteur hôtelier à 10 h. La recherche de test répond, mais le traitement de synchronisation prévu à 23 h utilise encore l’ancienne configuration. Le dossier de rotation reste incomplet jusqu’à la mise à jour de ce consommateur et à la vérification de sa prochaine exécution.
Pour préparer ce cas, le plan indique la fréquence de chaque tâche et la première échéance où son résultat pourra être observé. Si l’environnement autorisé permet un essai sans effet commercial, l’équipe peut anticiper la vérification. Sinon, elle garde une surveillance attribuée après la fenêtre, sans déclarer le consommateur testé.
La fermeture de la rotation repose sur la liste complète des consommateurs, l’accès attendu et le retrait confirmé de l’ancienne référence. Un code HTTP de succès sur une seule route ne vaut pas recette de l’ensemble du service.
Conserver les preuves et décider la reprise
Le plan de rotation rassemble droits attendus, ordre de mise à jour, observations et prochaines échéances. Les journaux partagés masquent les en-têtes d’authentification et tout élément sensible. OWASP recommande une journalisation des demandes, changements et usages sans divulguer les secrets.
Définissez avant la fenêtre les critères de suspension : consommateur manquant, révocation impossible à confirmer, dossier dont l’état reste inconnu. Le retour arrière dépend de la situation ; une ancienne clé soupçonnée d’exposition ne constitue pas un moyen acceptable de reprise. Faites choisir une nouvelle référence ou une suspension par l’équipe habilitée.
Pour un accès délégué plutôt qu’une clé statique, consultez aussi le guide OAuth. Les obligations du contrat, les notifications d’incident et les règles de votre organisation restent à vérifier séparément.
Sources et périmètre des faits documentés
La date de consultation figure avec chaque référence. Les méthodes d’essai et recommandations de ce guide sont éditoriales ; les conditions d’accès et d’usage se vérifient dans la documentation actuelle.
- OWASP : gestion des secrets — Cycle de vie, droits minimaux, rotation et journaux sans secrets. (consultée le )
Questions fréquentes
Questions utiles avant de décider
Une nouvelle clé invalide-t-elle automatiquement l’ancienne ?
Cela dépend de l’interface et du compte. Demandez la règle documentée et conservez la preuve de révocation ; ne déduisez pas le retrait de la seule création d’une nouvelle clé.
Faut-il remplacer toutes les clés à une fréquence identique ?
La politique dépend du type d’accès, des droits, de l’exposition et des mécanismes proposés. Conservez une règle approuvée pour chaque périmètre ; le guide ne propose pas une durée universelle.
Que faire si une tâche n’a pas encore été exécutée ?
Gardez son contrôle ouvert avec une échéance et un responsable. Un test anticipé autorisé peut aider ; sinon la prochaine exécution reste à observer avant de clôturer le périmètre.