Box 에 연결하기

Box는 안전한 클라우드 기반 파일 공유 및 협업 플랫폼으로, 팀이 언제 어디서나 어떤 기기에서든 실시간으로 문서를 작성, 편집 및 관리할 수 있도록 지원합니다.

Box를 IBM watsonx Orchestrate 와 연동하려면, 두 시스템이 원활하게 통신할 수 있도록 보안 연결을 설정해야 합니다. 통합 관리에 대한 일반적인 안내는 ‘사전 구축된 에이전트용 앱 연결’을 참조하세요.

중요:

기본적으로 해당 앱에서는 SSO(단일 로그인) 기능이 비활성화되어 있습니다. 이 기능을 활성화하려면 ‘애플리케이션에 대한 싱글 사인온 구성’을 참조하십시오.

연결 방법

다음 단계를 따라 Box를 watsonx Orchestrate 에 연결하세요:

Box는 watsonx Orchestrate 에서 다음 인증 방법을 지원합니다:

참고:

2025년 9월 이후에 생성된 에이전트의 경우, Box에서는 OAuth 2.0 방식의 인증만 지원됩니다.

연결 설정 페이지에서 Box 연결을 찾을 때 다음 연결 ID를 사용하십시오. 연결 ID를 검색하고 편집을 위해 연결을 여는 방법을 이해하려면 사전 구축된 에이전트용 앱 연결을 참조하십시오.


인증 유형	연결 ID
OAuth2 인증 코드	`box_ibm_184bdbd3`
키/값 쌍	`box_key_value_ibm_184bdbd3`

조직에서 OAuth 기반 인증을 사용하는 경우, 인증 유형을 ' OAuth2 인증 코드 '로 설정하고 다음 필드를 입력하십시오:


필드	설명
`server_url`	Box API 서버의 기본 URL
`authorization_url`	사용자가 접근 권한을 승인하기 위해 리디렉션되는 URL 예: `https://account.box.com/api/oauth2/authorize`
`token_url`	인증 코드를 액세스 토큰으로 교환하는 데 사용되는 엔드포인트. 예: `https://api.box.com/oauth2/token`
`client_id`	Box 개발자 콘솔의 Box 앱 클라이언트 ID
`client_secret`	Box 개발자 콘솔에서 Box 앱의 클라이언트 비밀을 확인하세요

이 값들을 확인하려면 Box 인증 API 문서를 참조하십시오.

조직에서 API 키 또는 레거시 구성을 사용하는 경우 인증 유형을 키-값 쌍 으로 설정하고 새 필드 추가를 사용하여 다음 필드를 각각 추가하십시오:


키	설명
`base_url`	Box API 엔드포인트의 기본 주소는 URL 입니다.
`token_url`	URL OAuth 토큰을 획득하는 데 사용됩니다. 예: `https://api.box.com/oauth2/token`
`client_id`	Box 애플리케이션의 클라이언트 ID
`client_secret`	Box 애플리케이션의 클라이언트 비밀
`subject_id`	앱이 대신 작동할 Box 사용자 또는 기업 ID
`subject_type`	주체 유형(예: 사용자 또는 기업)

참고 : 키-값 쌍을 사용할 때는 팀 자격 증명만 지원됩니다.

이 값들을 확인하려면 Box Authorization API 문서를 참조하십시오.

앱 연결이 완료되었으므로, 이제 watsonx Orchestrate 에서 앱을 사용할 수 있습니다.