osFoundry / Platform
커넥터 설정
모든 연결에 대한 권위 있는 소스 — 스코프, 시크릿, OAuth 구성.
개요
커넥터 설정은 워크스페이스가 외부의 모든 것과 어떻게 연결되는지를 정의하고 저장하는 osFoundry Studio의 영역입니다. 여러분의 에이전트와 앱이 접근하는 API, 도구, 서비스가 그 대상입니다. 각 커넥터는 하나의 연결에 관한 전체 정보를 단일 권위 레코드로 담아 둡니다. OAuth 클라이언트 구성, 그 연결이 사용할 수 있도록 허용된 정확한 범위, 통신하는 엔드포인트, 그리고 인증에 쓰는 시크릿이나 토큰이 그것입니다. 같은 자격 증명을 여기 채팅에, 저기 에이전트에, 또 다른 앱에 붙여 넣는 대신, 하나의 커넥터 설정이 그 연결이 정의되는 유일한 장소가 되고 워크스페이스의 모든 것이 그것을 참조합니다.
osFoundry는 BYOK 방식의 로컬 우선 데스크톱 워크스페이스이므로, 커넥터 설정 안의 시크릿은 리셀러를 통해 빌린 것이 아니라 여러분 자신의 키와 토큰입니다. 게다가 남의 서버에 놓이는 대신 여러분의 기기에 머무를 수 있습니다. 연결에 OAuth가 필요하면, 커넥터 설정에서 클라이언트 세부 정보와 리디렉션을 설정하고 부여된 범위를 기록합니다. 그래서 어떤 연결에 어떤 접근이 주어졌는지 추측하지 않고 정확히 볼 수 있습니다. 토큰을 교체해야 하거나 범위를 좁혀야 할 때는 커넥터 설정에서 한 번만 바꾸면, 그 연결을 사용하는 모든 채팅과 에이전트, 앱이 변경 사항을 그대로 반영합니다.
바로 이 단일 공급원 설계가 핵심입니다. 연결은 흩어지기 쉽습니다. 같은 서비스에 서로 다른 키가 생기고, 잊힌 토큰이 남고, 권한이 불분명해집니다. 흩어진 구성은 유지보수 부담이자 동시에 보안 위험입니다. 범위와 시크릿, OAuth 설정을 하나의 커넥터 레코드에 함께 두면, 무엇이 어떤 접근 권한으로 어떤 자격 증명을 써서 연결되어 있는지에 대해 항상 정확한 답을 가질 수 있습니다. 이것이야말로 접근 권한을 감사하거나, 워크스페이스를 동료에게 넘기거나, 급하게 무언가를 회수할 때 가장 중요한 질문입니다.
주요 기능
- 외부 연결마다 커넥터 설정으로 한 번만 정의하고, 워크스페이스의 어떤 채팅, 에이전트, 앱에서든 그것을 참조하세요
- OAuth 클라이언트 구성을 저장하고, 연결에 부여된 정확한 범위를 기록하세요
- BYOK 모델 아래에서 API 키, 토큰, 시크릿을 로컬 우선으로 기기에 보관하고 리셀러 마진을 없애세요
- 한곳에서 토큰을 교체하거나 범위를 좁히면, 그 연결을 사용하는 모든 소비자가 변경 사항을 반영하도록 하세요
- 무엇이 어떤 자격 증명으로 연결되어 있고 각 연결이 실제로 어떤 접근 권한을 갖는지 한눈에 확인하세요
활용 사례
- 1인 개발자: 키를 프롬프트마다 붙여 넣는 대신, 올바른 범위를 지정한 하나의 커넥터 설정으로 에이전트를 서드파티 API에 연결합니다
- 프라이버시를 중시하는 팀 리더: 커넥터 설정을 통해 워크스페이스의 모든 시크릿을 기기에 보관하고, 접근을 공유하기 전에 부여된 OAuth 범위를 감사합니다
- 자동화 관리자: 만료가 임박한 토큰을 하나의 커넥터 설정에서 교체하면, 그 연결에 의존하는 모든 앱과 에이전트가 멈추지 않고 계속 작동합니다
자주 묻는 질문
커넥터 설정의 시크릿은 실제로 어디에 저장되나요?
osFoundry는 로컬 우선 데스크톱 워크스페이스이므로, 커넥터 시크릿, 즉 BYOK 모델에서 여러분 자신의 API 키와 토큰은 호스팅 서버가 아니라 여러분의 기기에 머무를 수 있습니다. 여러분과 연결하려는 서비스 사이에 끼어드는 리셀러는 없습니다.
커넥터 설정에는 시크릿 외에 무엇이 들어 있나요?
커넥터 설정은 하나의 연결에 대한 권위 레코드입니다. OAuth 클라이언트 구성, 그 연결에 부여된 구체적인 범위, 통신하는 엔드포인트, 인증에 쓰는 자격 증명을 담습니다. 이것들을 함께 두기 때문에 연결이 어떤 접근 권한을 갖는지 정확히 볼 수 있습니다.
연결을 변경하면 사용되는 모든 곳에서 일일이 업데이트해야 하나요?
아니요. 모든 것이 하나의 커넥터 설정을 참조하므로, 거기서 토큰을 업데이트하거나 범위를 조정하면 그 연결을 사용하는 모든 채팅과 에이전트, 앱에 반영됩니다. 사용처마다 자격 증명을 복제하지 않고 이 단일 진실 공급원을 두는 것이 바로 커넥터 설정이 존재하는 이유입니다.