> For the complete documentation index, see [llms.txt](https://docs.allganize.ai/allganize-alli-works/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.allganize.ai/allganize-alli-works/knowledge-base/integration-thirdparty/box.md).

# Box 연동

Alli는 조직에서 이미 사용 중인 Box 리소스를 별도의 전처리 없이 그대로 지식베이스로 활용할 수 있도록 연동 기능을 제공합니다. Box의 폴더 구조와 접근 권한을 유지한 채 문서를 자동으로 가져오며, 이를 기반으로 다양한 업무 시나리오에 맞는 LLM 기반 앱을 손쉽게 활용할 수 있습니다.

### 1. Box 연동 시작하기

<figure><img src="/files/FqFU9rt7ZQ4FQfvRfkQ7" alt=""><figcaption></figcaption></figure>

아래의 절차에 따라 연동을 시작합니다.

1. Alli 대시보드에서 지식베이스 > 외부데이터 탭으로 이동합니다.
2. Box **Connect(연동)** 버튼을 클릭합니다.
3. Box를 연동할 계정으로 로그인 합니다.

> 주의 사항
>
> * 연동 과정은 OAuth 인증 방식을 통해 진행됩니다.
> * 연동한 계정을 통해 연동되는 문서들은 해당 계정의 권한 기준으로 수집됩니다.

<div><figure><img src="/files/jHQukbqTpVIGj6HAGLge" alt=""><figcaption></figcaption></figure> <figure><img src="/files/lUCjs6TetEP2YPxqDGOb" alt=""><figcaption></figcaption></figure></div>

### 2. 연동 설정

Box 계정 등록이 완료되면, 연동 대상과 방식에 대한 세부 설정을 진행합니다.

1. 연동 계정 옆의 **Configure(설정)** 버튼을 클릭합니다.

<figure><img src="/files/m7qTzsTqt9o0ORR0nMa1" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/bpZ00UsQctfSbfT2ttaU" alt=""><figcaption></figcaption></figure>

2. 연동할 **File types(파일 형식)** 을 선택합니다.
   * **All**: 지원되는 모든 파일 형식을 가져옵니다.
   * 원하는 파일 형식만 가져오고자 할 경우, 개별 체크박스를 선택합니다.
3. 연동할 **Sync scopes(범위)** 를 선택합니다.
   * **Entire Box (All Files)**: Box의 모든 (최상단의) 폴더/파일 항목을 연동합니다.
   * **Specific folders**: Box의 특정 폴더 항목만 선택적으로 연동합니다.
     * 최상단의 폴더만 선택할 수 있으며, 파일은 선택할 수 없습니다.
4. 상세 설정이 완료되면 저장 버튼을 클릭합니다.

<figure><img src="/files/WoJwdLDhBYbYiNJFiDZy" alt=""><figcaption></figcaption></figure>

5. 저장된 설정을 바탕으로 즉시 연동을 진행하려면 **Run now(지금 실행)** 버튼을 클릭합니다.
   * 파일 형식과 연동 범위만 설정하고 실제 연동을 진행하지 않으려면 **Close(닫기)** 버튼을 클릭합니다.

### 3. 연동 진행 상황 확인

<figure><img src="/files/CyoSDn8GQUgUqrS1Zilc" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/uKkTmw4XrAQTHXyTrV8j" alt=""><figcaption></figcaption></figure>

연동이 시작되면 진행 중인 상태를 확인할 수 있습니다. **View progress(진행 상태 보기)** 를 클릭하면 현재 연동 과정에서 어느 단계가 진행 중인지 실시간으로 확인할 수 있습니다.&#x20;

Box 연동은 총 **2단계**로 구성됩니다.

1. **Box 폴더/파일 및 권한 정보 연동**\
   Box 내 폴더와 문서 정보 및 각 리소스에 할당된 Box 권한을 함께 연동합니다.
2. **Box 그룹 및 사용자 연동**\
   Box 내의 사용자 및 그룹 정보를 연동합니다.

**\[연동 성공]**

**View progress(진행 상태 보기)** 를 통해 현재 연동 상황에 대한 상세 정보를 확인할 수 있습니다.

<figure><img src="/files/EmYU5SHWvbM4y8Wl8B6Y" alt=""><figcaption></figcaption></figure>

**\[연동 실패]**

연동이 실패하면 실패한 단계와 원인을 확인할 수 있습니다.

### 4. 자동 실행 / 지금 실행 및 연동 해제

<figure><img src="/files/98uuBNmyGL0kUNyk6cKR" alt=""><figcaption></figcaption></figure>

연동 후 **Run automatically(자동 실행)** 토글을 ON으로 설정하면 매일 자정에 하루 한 번 변경 사항이 업데이트됩니다. **Run now(지금 실행)**&#xC744; 클릭하면 버튼을 누른 시점을 기준으로 기존 대비 업데이트된 내용을 즉시 반영할 수 있습니다.

### 5. 연동 후 문서 구조 및 자동 관리

연동이 완료되면 다음과 같은 방식으로 문서가 구성 및 관리됩니다.

<figure><img src="/files/hjyVaveMf1sfTaefoo3D" alt=""><figcaption></figcaption></figure>

**문서 구조 구성**

* 연동이 완료되면 Alli 문서함과 Works의 공용 문서함 내에 "Box"라는 이름의 루트 폴더가 자동 생성됩니다.
* 연동된 Box의 폴더/파일은 이 루트 폴더 아래에 하위 폴더로 구성되며, 폴더 및 문서 계층 구조가 그대로 반영됩니다.
* 사용자는 Box의 실제 구조와 동일한 형태로 문서를 탐색할 수 있습니다.

### 6. 연동 해제

<figure><img src="/files/CZHz1pCKJvRLhF5DlBki" alt=""><figcaption></figcaption></figure>

연동된 Box 계정과 Alli의 연결을 해지하려면 **Disconnect(연동 해제)** 버튼을 클릭하세요. \
Box계정과의 연동을 해제하면 이후 Box에서 발생하는 변경 사항은 더 이상 반영되지 않습니다.\
&#x20;\
이 때 기존에 연동된 문서를 Alli 문서함에 유지한 채로 연동을 해제할지, 모든 데이터를 삭제한 후 계정 연동을 해제할지 선택할 수 있습니다.

두 가지 선택지가 제공됩니다.

* **계정만 해제**: **Delete Data(데이터 삭제)** 체크박스를 선택하지 않고 연결 해제 버튼을 클릭하면, Box 계정과의 연동만 해제됩니다. 이미 연동된 문서는 Alli에 그대로 남아 검색 및 활용이 가능합니다.
* **데이터 삭제**: **Delete Data(데이터 삭제)** 체크박스를 선택한 후 연결 해제 버튼을 클릭하면, 계정 연동 해지와 함께 연동되어 있던 모든 데이터가 일괄 삭제됩니다.

### 7. 연동된 문서의 제한 사항과 설정 가능한 항목

<div><figure><img src="/files/6GVkXT9MKRVimCFtLjjm" alt=""><figcaption></figcaption></figure> <figure><img src="/files/wwIKDwQktf0eg8sT0S3g" alt=""><figcaption></figcaption></figure></div>

연동된 폴더 및 문서는 Box 원본 보존을 위해 다음과 같은 제약이 있습니다.

* Alli 내에서 Box와 연동된 폴더 및 문서 내용을 직접 편집하거나 삭제하는 것은 불가능합니다.

| 항목  | 불가능한 작업                         |
| --- | ------------------------------- |
| 폴더  | 추가 / 삭제 / 이름 변경 / 이동 / 접근 권한 변경 |
| 문서서 | 업로드 / 삭제 / 이름 변경 / 접근 권한 변경     |

단, 다음의 항목은 Alli 내에서 개별 문서 단위로 자유롭게 설정 및 수정할 수 있습니다:

* 문서에 해시태그 추가
* 문서 상태 설정 (On/Off)
* Q\&A 자동 생성 여부 설정, 자동 태깅 실행

이러한 Alli 내에서 제공하는 메타데이터는 문서가 업데이트되더라도 유지됩니다.

### 8. 권한 및 사용자 처리

<figure><img src="/files/LZ4I5UINE1x8BVg65IFh" alt=""><figcaption></figcaption></figure>

Box에서 설정된 권한 정보는 Alli에도 반영되며, 다음과 같은 방식으로 작동합니다.

* Box에 설정된 사용자 및 그룹 정보가 Alli에서도 그대로 나타납니다.
* 단, Alli에서는 모든 사용자 권한이 Viewer(읽기 전용)로 통일됩니다.
  * 예를 들어 Box에서 Editor로 설정된 사용자도 Alli에서는 Viewer로만 적용됩니다.
* Box에 등록된 사용자가 아직 Alli에 가입하지 않았다면, 해당 사용자는 권한 리스트에 표시되지 않습니다.
  * 추후 Alli에 가입하게 되면 자동으로 권한 목록에 추가되어 표시됩니다.
* Box에서 권한을 그룹으로 설정한 경우, 해당 그룹이 Alli 권한 목록에 반영됩니다.

### 9. Works 내 문서 활용 방식

<div><figure><img src="/files/qFI7WWDZyBQSjBPOKogU" alt=""><figcaption></figcaption></figure> <figure><img src="/files/hxP6fqIndQVtCgqDDllM" alt=""><figcaption></figcaption></figure></div>

연동된 Box 문서는 **Works > 공용 문서함** 내에서 다른 문서와 동일한 방식으로 활용할 수 있습니다.

* **Shared Documents(공용 문서함)** 내에는 Box연동 시 자동으로 생성된 "Box" 폴더가 루트로 추가되며, 해당 폴더를 통해 연동된 문서에 접근할 수 있습니다.
* **공용 문서함**에서 표시되는 문서 목록은 사용자의 권한에 따라 다르게 표시됩니다. 즉, 사용자에게 권한이 부여된 문서만 문서함에 노출되므로, 기존 직접 업로드 방식의 문서함과 동일하게 불필요한 문서 접근을 방지하고 보안을 유지할 수 있습니다.