osFoundry / Platform
コネクタ設定
すべての接続のための正規のソース ― スコープ、シークレット、OAuth設定。
概要
コネクタ設定は、ワークスペースが外部とどう接続するかを定義して保持する osFoundry Studio の機能です。エージェントやアプリが呼び出す API、ツール、サービスへの接続が対象になります。各コネクタは、1 つの接続に関するすべての情報を単一の正しいレコードとしてまとめています。OAuth クライアントの構成、その接続に許可された正確なスコープ、通信する先のエンドポイント、そして認証に使うシークレットやトークンです。同じ認証情報をチャットに貼り、別のエージェントにも貼り、さらにどこかのアプリにも貼るのではなく、1 つのコネクタ設定がその接続を定義する唯一の場所になり、ワークスペース内のすべてがそこを参照します。
osFoundry は BYOK でローカルファーストのデスクトップワークスペースなので、コネクタ設定の中にあるシークレットは、リセラー経由で借りたものではなく、あなた自身のキーやトークンです。しかも他社のサーバーに置くのではなく、端末に留めておけます。接続に OAuth が必要なときは、クライアントの詳細やリダイレクトを設定し、付与されたスコープを記録するのがコネクタ設定です。そのため、その接続にどんなアクセスが与えられているかを推測せずに正確に確認できます。トークンを更新したいとき、あるいはスコープを絞りたいときは、コネクタ設定を一度変更すれば、その接続を使うすべてのチャット、エージェント、アプリに変更が反映されます。
この唯一の正という設計こそが要点です。接続は放っておくと散らかりがちで、同じサービスに別々のキーがあったり、忘れられたトークンが残っていたり、権限が曖昧になったりします。バラバラな構成は保守の負担であり、同時にセキュリティ上のリスクでもあります。スコープ、シークレット、OAuth 設定を 1 つのコネクタレコードにまとめておけば、「何が、どんなアクセスで、どの認証情報を使って接続されているか」に常に正確な答えを持てます。これはアクセスを監査するとき、ワークスペースを同僚に引き継ぐとき、急いで何かを失効させるときに、まさに問われる問いです。
主な機能
- 外部への各接続をコネクタ設定として一度だけ定義し、ワークスペース内のどのチャット、エージェント、アプリからも参照する
- OAuth クライアントの構成を保存し、その接続に付与された正確なスコープを記録する
- API キー、トークン、シークレットを BYOK モデルのもとローカルファーストで端末に保持し、リセラーの上乗せをなくす
- トークンの更新やスコープの絞り込みを一箇所で行い、その接続を使うすべての利用側に変更を反映させる
- 何が、どの認証情報で接続され、各接続が実際にどのアクセスを持つのかを一目で把握できる
活用例
- 個人開発者：キーをプロンプトごとに貼り付けるのではなく、適切なスコープを設定した 1 つのコネクタ設定でエージェントをサードパーティ API に接続する
- プライバシー重視のチームリーダー：ワークスペースのシークレットをコネクタ設定で端末上に保持し、アクセスを共有する前に付与済みの OAuth スコープを監査する
- 自動化の保守担当：期限切れが近いトークンを 1 つのコネクタ設定で更新し、その接続に依存するすべてのアプリとエージェントを止めずに動かし続ける
よくある質問
コネクタ設定のシークレットは実際どこに保存されますか。
osFoundry はローカルファーストのデスクトップワークスペースなので、コネクタのシークレット、つまり BYOK モデルにおけるあなた自身の API キーやトークンは、ホスト型のサーバーではなく端末に留めておけます。あなたと接続先サービスの間にリセラーが入ることはありません。
コネクタ設定にはシークレットのほかに何が含まれますか。
コネクタ設定は 1 つの接続に関する正しいレコードです。OAuth クライアントの構成、その接続に付与された具体的なスコープ、通信先のエンドポイント、認証に使う認証情報を含みます。これらをまとめておくからこそ、その接続がどんなアクセスを持つかを正確に確認できます。
接続を変更したら、使っている場所すべてを更新する必要がありますか。
いいえ。すべてが 1 つのコネクタ設定を参照しているため、そこでトークンを更新したりスコープを調整したりすれば、その接続を使うすべてのチャット、エージェント、アプリに反映されます。利用箇所ごとに認証情報を複製するのではなく、この唯一の正があることこそがコネクタ設定の存在理由です。