osFoundry / Platform
Config dei connettori
Fonte autorevole per ogni connessione — scope, secret, configurazione OAuth.
Che cos’è
Le configurazioni connettore sono la parte di osFoundry Studio che definisce e memorizza come il tuo spazio di lavoro si collega a tutto ciò che gli sta all'esterno: le API, gli strumenti e i servizi a cui accedono i tuoi agenti e le tue app. Ogni connettore racchiude il quadro completo di una connessione in un unico record autorevole: la sua configurazione del client OAuth, gli scope esatti che quella connessione è autorizzata a usare, gli endpoint con cui dialoga e i secret o i token con cui si autentica. Invece di incollare la stessa credenziale in una chat qui, in un agente là e in un'app da qualche altra parte, una sola configurazione connettore diventa l'unico luogo in cui quella connessione è definita, e tutto nello spazio di lavoro la referenzia.
Poiché osFoundry è uno spazio di lavoro desktop, local-first e bring-your-own-key (BYOK), i secret all'interno di una configurazione connettore sono le tue chiavi e i tuoi token, non qualcosa noleggiato tramite un rivenditore, e possono restare sul tuo dispositivo anziché risiedere sul server di qualcun altro. Quando una connessione richiede OAuth, è nella configurazione connettore che si impostano i dettagli del client e il redirect e si registrano gli scope concessi, così vedi con precisione quale accesso è stato dato a una connessione invece di tirare a indovinare. Quando un token va ruotato o uno scope va ristretto, lo modifichi una volta nella configurazione connettore e ogni chat, agente e app che usa quella connessione recepisce la modifica.
È proprio questo design a fonte unica il punto centrale. Le connessioni tendono a proliferare: chiavi diverse per lo stesso servizio, token dimenticati, permessi poco chiari. Un assetto sparpagliato è al tempo stesso un onere di manutenzione e un rischio per la sicurezza. Tenere scope, secret e configurazione OAuth insieme in un solo record di connettore significa avere sempre una risposta esatta alla domanda su che cosa è connesso, con quale accesso e usando quale credenziale, che è esattamente ciò che conta quando controlli gli accessi, consegni uno spazio di lavoro a un collega o revochi qualcosa di fretta.
Funzionalità principali
- Definisci ogni connessione esterna una sola volta come configurazione connettore, poi referenziala da qualsiasi chat, agente o app dello spazio di lavoro
- Memorizza la configurazione del client OAuth e registra gli scope esatti concessi a una connessione
- Conserva chiavi API, token e secret in locale sul tuo dispositivo secondo un modello bring-your-own-key, senza ricarico del rivenditore
- Ruota un token o restringi uno scope in un unico punto e fai in modo che ogni consumatore di quella connessione recepisca la modifica
- Vedi a colpo d'occhio che cosa è connesso, con quale credenziale e quale accesso ha davvero ciascuna connessione
Casi d’uso
- Sviluppatore in solitaria: collega un agente a un'API di terze parti creando un'unica configurazione connettore con gli scope giusti, invece di incollare la chiave in ogni prompt
- Team lead attento alla privacy: tiene tutti i secret dello spazio sul dispositivo tramite le configurazioni connettore e verifica gli scope OAuth concessi prima di condividere l'accesso
- Manutentore di automazioni: ruota un token in scadenza in un'unica configurazione connettore e ogni app e agente che dipende da quella connessione continua a funzionare
Domande frequenti
Dove vengono effettivamente memorizzati i secret di una configurazione connettore?
osFoundry è uno spazio di lavoro desktop local-first, quindi i secret del connettore, cioè le tue chiavi API e i tuoi token nel modello bring-your-own-key, possono restare sul tuo dispositivo anziché su un server ospitato. Tra te e il servizio a cui ti colleghi non si interpone alcun rivenditore.
Cosa include una configurazione connettore oltre al secret?
Una configurazione connettore è il record autorevole di una connessione: la sua configurazione del client OAuth, gli scope specifici che le sono stati concessi, gli endpoint con cui dialoga e la credenziale con cui si autentica. Tenerli insieme è ciò che ti permette di vedere esattamente quale accesso ha una connessione.
Se modifico una connessione, devo aggiornarla ovunque venga usata?
No. Poiché tutto referenzia l'unica configurazione connettore, aggiornare lì un token o regolare uno scope si propaga a ogni chat, agente e app che usa quella connessione. Proprio questa fonte unica di verità è il motivo per cui esistono le configurazioni connettore, anziché duplicare le credenziali a ogni utilizzo.