Socle des connecteurs — santé, secrets, journaux (gratuit)

Le constat qui l'a fait écrire

Dans une famille de treize modules de connexion, l'inventaire donnait :

• sept journaux d'appels, sans un champ commun, avec trois politiques de purge différentes — et quatre qui ne purgeaient pas du tout ;

• six couches de transport HTTP, dont deux seulement possédaient une garde contre l'appel bloquant, un statut normalisé et la lecture de Retry-After ;

• aucune expurgation nulle part : les clés d'API, les jetons et les secrets clients étaient recopiés tels quels dans les journaux ;

• quatre boutons « Tester la connexion » sur onze connecteurs, de quatre formes différentes — et aucun sur celui dont le réglage est le plus délicat.

Ce qu'il porte

• Un tableau de bord de santé. Une ligne par connecteur configuré, tous modules confondus, les pannes en tête. Il répond à la seule question qu'on se pose vraiment : lequel est en train de tomber ?

• Un essai de connexion commun. Le module connecteur écrit une méthode qui rend « réussi, message » ; l'autorisation d'appel réseau, la mesure, la mise à jour de l'état et la fenêtre de retour sont tenues ici.

• Un transport partagé qui ne lève jamais : un code, une durée, un message. Il traduit le statut HTTP en conduite — renouveler le jeton, attendre, ou s'arrêter — lit Retry-After et borne l'attente, parce qu'un service qui demande de revenir dans un jour bloquerait la file entière.

• L'expurgation. Clés préfixées, jetons JWT, en-têtes d'autorisation, paramètres d'adresse sensibles : masqués avant d'être écrits, donc absents de la base, donc absents de l'export qu'on joint à une demande d'aide.

• Une purge unique pour tous les journaux, découverts au lieu d'être listés. Ajouter un module n'oblige plus à se souvenir d'ajouter son cron.

• Une sonde de sortie. Quand cinq connecteurs tombent le même jour, la cause est souvent la même et rarement cherchée en premier : le serveur n'a plus d'accès sortant. La sonde distingue les trois échecs qu'on confond toujours — rien n'est revenu, le service a refusé, le service est lent — et chacun appelle une réponse différente.

Ce qu'il ne fait pas

Il ne conclut rien. Un essai qui échoue constate l'échec et recopie ce que le service a répondu ; il n'affirme jamais que la configuration est fausse, parce qu'un service en panne donne exactement le même signal qu'une clé erronée.

Gratuit, LGPL-3, sans compte ni dépendance externe.