osFoundry / Platform
Configs de connecteurs
Source d'autorité pour chaque connexion — scopes, secrets, configuration OAuth.
Présentation
Les configurations de connecteur constituent la partie d'osFoundry Studio qui définit et stocke la façon dont votre espace de travail se connecte à tout ce qui lui est extérieur : les API, les outils et les services que vos agents et vos apps sollicitent. Chaque connecteur réunit l'image complète d'une connexion dans un unique enregistrement faisant autorité : sa configuration de client OAuth, les scopes exacts que cette connexion est autorisée à utiliser, les endpoints avec lesquels elle échange, et les secrets ou jetons avec lesquels elle s'authentifie. Au lieu de coller le même identifiant dans un chat ici, un agent là et une app ailleurs, une seule configuration de connecteur devient l'unique endroit où cette connexion est définie, et tout le reste de l'espace de travail y fait référence.
Comme osFoundry est un espace de travail de bureau, local d'abord et en apportez-votre-propre-clé (BYOK), les secrets à l'intérieur d'une configuration de connecteur sont vos propres clés et jetons, et non quelque chose loué via un revendeur. Ils peuvent rester sur votre appareil plutôt que de séjourner sur le serveur de quelqu'un d'autre. Quand une connexion a besoin d'OAuth, c'est dans la configuration de connecteur que sont paramétrés les détails du client et la redirection, et que sont consignés les scopes accordés, de sorte que vous voyez précisément quel accès a été donné à une connexion au lieu de le deviner. Quand un jeton doit être renouvelé ou un scope resserré, vous le modifiez une seule fois dans la configuration de connecteur et chaque chat, agent et app qui utilise cette connexion adopte le changement.
Cette conception à source unique est tout l'intérêt. Les connexions ont tendance à proliférer : des clés différentes pour le même service, des jetons oubliés, des permissions floues. Un montage éparpillé est à la fois une charge de maintenance et un risque de sécurité. Garder scopes, secrets et configuration OAuth réunis dans un seul enregistrement de connecteur, c'est disposer en permanence d'une réponse exacte à la question de savoir ce qui est connecté, avec quel accès et via quel identifiant, ce qui est justement la question qui compte quand vous auditez les accès, confiez un espace de travail à un collègue ou révoquez quelque chose dans l'urgence.
Fonctionnalités clés
- Définissez chaque connexion externe une seule fois sous forme de configuration de connecteur, puis référencez-la depuis n'importe quel chat, agent ou app de l'espace de travail
- Stockez la configuration du client OAuth et consignez les scopes exacts accordés à une connexion
- Conservez clés d'API, jetons et secrets en local sur votre appareil selon un modèle apportez-votre-propre-clé, sans marge de revendeur
- Renouvelez un jeton ou resserrez un scope à un seul endroit, et chaque consommateur de cette connexion adopte le changement
- Voyez d'un coup d'œil ce qui est connecté, avec quel identifiant, et quel accès chaque connexion possède réellement
Cas d’usage
- Développeur solo : relie un agent à une API tierce en créant une seule configuration de connecteur dotée des bons scopes, plutôt que de coller la clé dans chaque prompt
- Responsable d'équipe soucieux de confidentialité : garde tous les secrets de l'espace sur l'appareil grâce aux configurations de connecteur et audite les scopes OAuth accordés avant de partager l'accès
- Mainteneur d'automatisations : renouvelle un jeton bientôt expiré dans une seule configuration de connecteur, et chaque app et agent qui dépend de cette connexion continue de fonctionner
Questions fréquentes
Où sont réellement stockés les secrets d'une configuration de connecteur ?
osFoundry est un espace de travail de bureau local d'abord, si bien que les secrets du connecteur, vos propres clés d'API et jetons dans le modèle apportez-votre-propre-clé, peuvent rester sur votre appareil plutôt que sur un serveur hébergé. Aucun revendeur ne s'intercale entre vous et le service auquel vous vous connectez.
Qu'inclut une configuration de connecteur en dehors du secret ?
Une configuration de connecteur est l'enregistrement faisant autorité pour une connexion : sa configuration de client OAuth, les scopes précis qui lui ont été accordés, les endpoints avec lesquels elle échange et l'identifiant avec lequel elle s'authentifie. C'est le fait de les réunir qui vous permet de voir exactement quel accès une connexion possède.
Si je modifie une connexion, dois-je la mettre à jour partout où elle est utilisée ?
Non. Comme tout fait référence à l'unique configuration de connecteur, y mettre à jour un jeton ou ajuster un scope se répercute sur chaque chat, agent et app qui utilise cette connexion. C'est cette source unique de vérité qui justifie l'existence des configurations de connecteur, plutôt que de dupliquer les identifiants à chaque usage.