osFoundry / Platform
Конфиги коннекторов
Авторитетный источник для каждого подключения — scopes, секреты, OAuth-конфиг.
Что это
Конфигурации коннекторов — это часть osFoundry Studio, которая определяет и хранит, как ваше рабочее пространство подключается ко всему внешнему: к API, инструментам и сервисам, к которым обращаются ваши агенты и приложения. Каждый коннектор держит полную картину одного подключения в единой авторитетной записи: его конфигурацию клиента OAuth, точные области доступа, которые этому подключению разрешено использовать, эндпоинты, с которыми оно общается, и секреты или токены, которыми оно аутентифицируется. Вместо того чтобы вставлять одни и те же учётные данные то в чат, то в агента, то в какое-то приложение, одна конфигурация коннектора становится единственным местом, где это подключение определено, и всё в рабочем пространстве ссылается на неё.
Поскольку osFoundry — это десктопное рабочее пространство с принципом local-first и моделью bring-your-own-key (BYOK), секреты внутри конфигурации коннектора — это ваши собственные ключи и токены, а не что-то арендованное через реселлера, и они могут оставаться на вашем устройстве, а не лежать на чужом сервере. Когда подключению нужен OAuth, именно в конфигурации коннектора задаются данные клиента и редирект и фиксируются выданные области доступа, так что вы точно видите, какой доступ получило подключение, а не гадаете. Когда токен нужно ротировать, а область доступа сузить, вы меняете это в конфигурации коннектора один раз, и каждый чат, агент и приложение, использующие это подключение, подхватывают изменение.
Именно этот принцип единого источника и есть суть. Подключения склонны расползаться: разные ключи для одного сервиса, забытые токены, неясные разрешения. Разрозненная настройка — это одновременно бремя сопровождения и риск для безопасности. Когда области доступа, секреты и конфигурация OAuth собраны вместе в одной записи коннектора, у вас всегда есть точный ответ на вопрос, что подключено, с каким доступом и с помощью каких учётных данных, а это ровно тот вопрос, который важен, когда вы проводите аудит доступа, передаёте рабочее пространство коллеге или срочно что-то отзываете.
Ключевые возможности
- Определите каждое внешнее подключение один раз как конфигурацию коннектора и ссылайтесь на неё из любого чата, агента или приложения в рабочем пространстве
- Храните конфигурацию клиента OAuth и фиксируйте точные области доступа, выданные подключению
- Держите API-ключи, токены и секреты локально на своём устройстве по модели bring-your-own-key, без наценки реселлера
- Ротируйте токен или сужайте область доступа в одном месте, и каждый потребитель этого подключения подхватит изменение
- Видьте с первого взгляда, что подключено, с какими учётными данными и какой доступ на самом деле есть у каждого подключения
Сценарии использования
- Разработчик-одиночка: подключает агента к стороннему API, настроив одну конфигурацию коннектора с нужными областями доступа, вместо того чтобы вставлять ключ в каждый промпт
- Тимлид, заботящийся о приватности: держит все секреты рабочего пространства на устройстве через конфигурации коннекторов и проверяет выданные области OAuth перед тем, как открыть доступ
- Сопровождающий автоматизаций: ротирует истекающий токен в одной конфигурации коннектора, и каждое приложение и агент, зависящие от этого подключения, продолжают работать
Часто задаваемые вопросы
Где на самом деле хранятся секреты из конфигурации коннектора?
osFoundry — это десктопное рабочее пространство с принципом local-first, поэтому секреты коннектора, то есть ваши собственные API-ключи и токены по модели bring-your-own-key, могут оставаться на вашем устройстве, а не на размещённом сервере. Между вами и сервисом, к которому вы подключаетесь, нет никакого реселлера.
Что входит в конфигурацию коннектора помимо секрета?
Конфигурация коннектора — это авторитетная запись одного подключения: его конфигурация клиента OAuth, конкретные выданные ему области доступа, эндпоинты, с которыми оно общается, и учётные данные, которыми оно аутентифицируется. Именно то, что они собраны вместе, позволяет вам точно видеть, какой доступ есть у подключения.
Если я изменю подключение, придётся ли обновлять его везде, где оно используется?
Нет. Поскольку всё ссылается на одну конфигурацию коннектора, обновление токена или корректировка области доступа там доходят до каждого чата, агента и приложения, использующих это подключение. Именно этот единый источник истины и есть причина, по которой существуют конфигурации коннекторов, вместо дублирования учётных данных при каждом использовании.