Connecteurs
Connecteurs
Déclaration d'un service externe, autorisation d'écriture, et journal d'audit.
Un connecteur est un accès déclaré à un service externe. Il est rattaché au Dossier dans lequel il a été créé ; aucun autre Dossier ne le voit ni n'atteint ses secrets.
Ouvrir l'écran#
Chat → « Dossier · sources & mémoire » → onglet « Connecteurs — API et Modules »
Le compteur porté par l'onglet est le nombre de connecteurs déclarés. Chaque connecteur occupe une carte dépliable.
Déclarer un service préconfiguré#
L'adresse, le mode d'authentification et le lien « Documentation » sont fournis par la carte.
- « Connecter » sous le service voulu.
- Saisir le ou les secrets demandés.
- « Ajouter le connecteur ».
Les services exigeant plusieurs champs — identifiant, domaine, clé — les présentent conjointement.
Déclarer une API arbitraire#
- « ＋ API personnalisée ».
- Renseigner l'adresse de base, le mode d'authentification et le secret.
- « Ajouter le connecteur ».
« Charger un fichier… » accepte une spécification d'API. Fournie, elle remplace la découverte à l'aveugle des routes disponibles.
Éléments d'une carte#
| Bouton | Effet |
|---|---|
| « Renommer cette brique » | Change le nom affiché |
| « 🔑 Identifiants » | Ressaisie du secret, validée par « Enregistrer » |
| « Logo… » | Associe une image locale au connecteur |
| « Tester l'API » | Émet un appel réel et affiche la réponse |
| « Supprimer » | Retire le connecteur et ses secrets |
Un secret enregistré n'est jamais réaffiché. La carte indique uniquement qu'il est défini.
En cas d'échec, le message de « Tester l'API » reprend la cause renvoyée par le service. Un refus de droits et un secret invalide ne se corrigent pas au même endroit ; le message désigne lequel des deux s'applique.
Autorisation d'écriture#
Chaque connecteur porte un interrupteur d'écriture, coupé par défaut. Coupé, l'agent dispose d'un accès en lecture seule.
L'état est évalué à l'instant de l'appel, non au moment du rendu de la carte : la coupure prend effet immédiatement, y compris en cours de tour.
Journal d'audit#
Les modules infra et transfert tiennent un journal de toutes les opérations émises par l'agent, réussies comme échouées.
Accès#
Chat → « Dossier · sources & mémoire » → onglet « Connecteurs — API et Modules » → carte du connecteur → « Journal d'audit »
L'écran est intitulé « Journal d'audit — » suivi du nom du connecteur.
Colonnes#
| Colonne | Contenu |
|---|---|
| Horodatage (UTC) | Instant de l'opération, en temps universel |
| Cible | Serveur ou site visé — local pour le poste lui-même |
| Opération | Commande ou action exécutée |
| Issue | OK, ou le code de retour en cas d'échec |
Sous chaque opération, « Sortie » déplie la réponse de la cible. Elle n'est pas une colonne : elle est repliée par défaut, une sortie de commande occupant plusieurs lignes.
Les entrées sont paginées de la plus récente à la plus ancienne ; « Plus anciennes → » remonte dans le temps.
Le journal survit à la suppression du connecteur. Retirer une carte n'efface pas la trace des opérations qu'elle a portées.
Le module de navigateur tient un journal de structure identique pour les actions menées dans une interface web.