Box 연동
Alli는 Box 연동을 통해 외부 파일 및 폴더를 손쉽게 가져와 지식베이스로 활용할 수 있도록 지원합니다. 조직 내에서 이미 사용 중인 Box의 자료를 자동으로 인덱싱하고, 폴더 구조 그대로 반영하여 관리할 수 있어, 더욱 자유롭고 유연한 문서 관리가 가능합니다. 이 가이드는 Box 플랫폼 앱 설정부터 Alli 대시보드 연동까지의 전체 과정을 단계별로 안내합니다. 아래 절차를 따라 설정을 완료하면, 사내에서 사용하고 있는 Box 콘텐츠를 Alli에서 손쉽게 활용할 수 있게 됩니다.
✅ Box 개발자 콘솔에서 앱 생성
https://app.box.com/developers/console 개발자 콘솔 페이지로 접속합니다.
플랫폼 앱을 작성합니다.
앱 엑세스 레벨을 앱+엔터프라이즈 엑세스로 지정합니다.
앱 범위를 'Box에 지정된 모든 파일 및 폴더 쓰기' 옵션으로 선택합니다.
고급 기능에서 '대리 사용자 헤더를 사용하여 API 키 호출 수행' 및 '사용자 엑세스 토큰 생성' 옵션을 활성화 합니다.
변경 내용을 저장합니다.
✅ 관리자 콘솔에서 앱 승인(Box 내에서 관리자 권한을 가지고 있는 계정만 접근할 수 있습니다)
https://app.box.com/developers/console 관리자 콘솔 페이지로 접속합니다.
통합 > 플랫폼 앱 관리자 > ... > 재승인/승인 버튼을 클릭하여 만들어진 앱을 승인합니다.
앱 승인 탭에서 '검토 및 제출' 버튼을 클릭합니다. 이 버튼을 클릭하면 앱이 활성화 상태로 전환됩니다.
✅ 연동 정보 확인
개발자 콘솔로 이동하여 해당되는 앱을 선택 > 일반 설정에서 유저 ID를 획득합니다.
이어서 구성 요소에서 클라이언트 ID와 암호를 획득합니다.
🔗 Alli 대시보드 연동 설정
Alli 대시보드로 이동하여 지식베이스 > 외부 데이터 탭에서 Box를 선택 후 세개 항목에 방금 획득해온 값을 넣어준 후 연동 버튼을 클릭합니다.
연동이 완료되었습니다.
Box 연동 및 문서 인덱싱
Box 연동이 완료되면, 문서 인덱싱은 자동 인덱싱 기능의 설정 여부에 따라 다음과 같이 운영됩니다.
🔄 자동 인덱싱 켜기 ON
매일 프로젝트 타임존 기준 자정에 Box에 저장된 문서가 Alli 대시보드로 자동 연동됩니다.
별도의 수동 작업 없이 최신 문서가 자동으로 반영됩니다.
⏸ 자동 인덱싱 기능 OFF
문서 동기화가 자동으로 이루어지지 않습니다.
사용자가 필요한 시점에 [지금 실행] 버튼을 클릭하여 수동으로 배치 작업을 실행해야 합니다.
⏰ 자동 인덱싱 스케줄 인덱싱은 프로젝트에 설정된 타임존 기준으로 매일 자정(00:00) 에 수행됩니다.
연동된 내용은 문서 탭에서 확인할 수 있습니다. 연동 시에는 Box 내의 폴더 구조가 그대로 반영되어 Alli 대시보드에 문서가 구성되며, 사용자의 Box 계정이 가진 권한 범위 내에서만 문서가 연동됩니다. ⚠️ 유의사항
연동된 문서는 Box의 변경사항을 기준으로 자동 반영되기 때문에, 문서 내용의 수정은 반드시 Box 내에서만 진행해야 합니다. Alli 대시보드에서는 문서 편집을 삼가주시기 바랍니다.
Last updated