osFoundry / Platform
Configurações de conectores
Fonte autoritativa para cada conexão — escopos, segredos, configuração OAuth.
O que é
As configurações de conector são a parte do osFoundry Studio que define e armazena como o seu espaço de trabalho se conecta a tudo o que está fora dele: as APIs, ferramentas e serviços que os seus agentes e apps acessam. Cada conector guarda o retrato completo de uma conexão em um único registro autoritativo: a configuração do cliente OAuth, os escopos exatos que aquela conexão pode usar, os endpoints com que ela fala e os segredos ou tokens com que se autentica. Em vez de colar a mesma credencial em um chat aqui, num agente ali e em um app em outro lugar, uma configuração de conector passa a ser o único lugar onde aquela conexão é definida, e tudo no espaço de trabalho a referencia.
Como o osFoundry é um espaço de trabalho de desktop, local por padrão e com sua própria chave (BYOK), os segredos dentro de uma configuração de conector são as suas próprias chaves e tokens, não algo alugado por meio de um revendedor, e podem permanecer no seu dispositivo em vez de ficar no servidor de outra pessoa. Quando uma conexão precisa de OAuth, é na configuração de conector que os detalhes do cliente e o redirecionamento são definidos e onde os escopos concedidos ficam registrados, então você vê com precisão que acesso foi dado a uma conexão em vez de adivinhar. Quando um token precisa ser rotacionado ou um escopo precisa ser restringido, você altera uma vez na configuração de conector e cada chat, agente e app que usa aquela conexão adota a mudança.
Esse desenho de fonte única é o ponto central. As conexões tendem a se espalhar: chaves diferentes para o mesmo serviço, tokens esquecidos, permissões pouco claras. Um arranjo disperso é ao mesmo tempo um peso de manutenção e um risco de segurança. Manter escopos, segredos e configuração de OAuth juntos em um único registro de conector significa que você sempre tem uma resposta precisa para a pergunta de o que está conectado, com que acesso e usando qual credencial, que é exatamente o que importa quando você audita acessos, entrega um espaço de trabalho a um colega ou revoga algo com pressa.
Principais recursos
- Defina cada conexão externa uma única vez como configuração de conector e a referencie a partir de qualquer chat, agente ou app do espaço de trabalho
- Armazene a configuração do cliente OAuth e registre os escopos exatos que foram concedidos a uma conexão
- Mantenha chaves de API, tokens e segredos localmente no seu dispositivo sob um modelo BYOK, sem sobretaxa de revendedor
- Rotacione um token ou restrinja um escopo em um único lugar e faça cada consumidor daquela conexão adotar a mudança
- Veja num relance o que está conectado, com qual credencial e que acesso cada conexão realmente tem
Casos de uso
- Desenvolvedor solo: liga um agente a uma API de terceiros com uma única configuração de conector com os escopos certos, em vez de colar a chave em cada prompt
- Líder de equipe atento à privacidade: mantém todos os segredos do espaço no dispositivo por meio de configurações de conector e audita os escopos OAuth concedidos antes de compartilhar o acesso
- Responsável por automações: rotaciona um token prestes a expirar em uma única configuração de conector e cada app e agente que depende daquela conexão continua funcionando
Perguntas frequentes
Onde os segredos de uma configuração de conector são realmente armazenados?
O osFoundry é um espaço de trabalho de desktop local por padrão, então os segredos do conector, as suas próprias chaves de API e tokens sob o modelo BYOK, podem ficar no seu dispositivo em vez de em um servidor hospedado. Não há revendedor algum entre você e o serviço ao qual está se conectando.
O que uma configuração de conector inclui além do segredo?
Uma configuração de conector é o registro autoritativo de uma conexão: a configuração do cliente OAuth, os escopos específicos que lhe foram concedidos, os endpoints com que ela fala e a credencial com que se autentica. Mantê-los juntos é o que permite ver exatamente que acesso uma conexão tem.
Se eu alterar uma conexão, preciso atualizá-la em todos os lugares em que é usada?
Não. Como tudo referencia a única configuração de conector, atualizar um token ou ajustar um escopo ali flui para cada chat, agente e app que usa aquela conexão. Essa fonte única de verdade é justamente a razão de existirem as configurações de conector, em vez de duplicar credenciais a cada uso.