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.
Microsoft et Microsoft 365 sont des marques du groupe de sociétés Microsoft. AIKeep, édité par STEP BY STEP, est une solution indépendante : il n'est ni affilié, ni sponsorisé, ni certifié, ni approuvé par les titulaires de ces marques, et n'entretient avec eux aucun lien capitalistique ni de partenariat. Ces noms ne sont cités que pour désigner les services auxquels AIKeep se connecte ou qu'il utilise ; ils restent la propriété de leurs titulaires.