박스

Box 데이터 소스에 저장된 문서를 크롤링합니다.

IBM Cloud Pak for Data IBM Software Hub

이 정보는 설치된 배포에만 적용됩니다. 관리형 배포에서 Box에 연결하는 방법에 대한 자세한 내용은 Box 를 참조하세요.

크롤링되는 문서

  • Discovery 가 지원하는 문서만 Box 폴더에서 크롤링됩니다. 다른 모든 문서는 무시됩니다. 자세한 내용은 지원되는 파일 형식 를 참조하세요.
  • 문서 수준 보안은 Box 애플리케이션의 앱 액세스 수준으로 App + Enterprise Access를 사용하도록 구성된 커넥터에 대해서만 지원됩니다. 이 옵션을 활성화하면 사용자는 Box에 로그인했을 때 액세스할 수 있는 동일한 콘텐츠를 크롤링하고 쿼리할 수 있습니다. 자세한 내용은 문서 수준 보안 지원 를 참조하세요.
  • 소스가 다시 크롤링되면, 새로운 문서가 추가되고, 업데이트된 문서는 현재 버전으로 수정되며, 삭제된 문서는 컬렉션의 색인에서 삭제됩니다.
  • 모든 Discovery 데이터 원본 커넥터는 읽기 전용입니다. 크롤링 계정에 부여된 권한에 관계없이 Discovery는 원본 데이터 원본의 콘텐츠를 쓰거나 업데이트하거나 삭제하지 않습니다.
  • Box 노트는 JSON 형식으로 저장되므로, Discovery 도 지정된 폴더에 있는 Box 노트를 수집합니다.

데이터 소스 요구사항

설치된 모든 배포에 대한 데이터 소스 요구 사항 외에도 Box 데이터 소스는 다음 요구 사항을 충족해야 합니다:

  • 연결하려는 데이터 소스에 필요한 모든 서비스 라이선스를 취득해야 합니다. 라이선스에 대한 자세한 내용은 데이터 원본의 시스템 관리자에게 문의하세요.

전제조건 단계

문서 수준 보안을 사용하려면 몇 가지 단계를 거쳐 설정해야 합니다. 자세한 정보는 문서 레벨 보안 정보를 참조하십시오.

Discovery에서 Box에 연결하려면 먼저 Box에서 사용자 지정 애플리케이션을 만들어야 합니다. 누구나 사용자 지정 앱을 만들 수 있지만 Box 관리자만 이를 승인할 수 있습니다.

사용자 지정 응용 프로그램을 만들려면 다음 단계를 완료하십시오

  1. Box 계정이 있는지 확인하십시오. 이 과정에서 구성 파일과 클라이언트 ID를 얻게 됩니다.

  2. 다음으로, 인증 방법으로 JWT를 사용한 서버 인증를 사용하는 사용자 지정 앱을 만듭니다.

    자세한 단계는 Box 개발자 문서에서 JWT로 설정하기를 참조하세요.

    앱을 만들 때 다음 가이드라인을 따르세요:

    1. 설정 절차 중에 JWT를 사용한 서버 인증 방법을 선택하여 키 쌍으로 애플리케이션 신원을 확인합니다.

    2. 크롤링하려는 Box 콘텐츠에 적합한 액세스 수준을 선택합니다:

      • 관리되는 사용자와 공유되는 Box 파일입니다: 앱 액세스 및 엔터프라이즈 액세스
      • 서비스 계정과 공유되는 Box 파일입니다: 앱 액세스 전용
      • 서비스 계정 및 해당 앱 사용자와 공유되는 Box 파일입니다: 앱 액세스 전용

      앱 액세스만으로 Box 레벨 액세스를 구성하는 기능은 4.6 릴리스에 추가되었습니다.

    3. 앱 액세스 수준 유형에 적합한 단계에 따라 액세스 수준을 구성합니다:

      • 앱 액세스 및 엔터프라이즈 액세스

        다음과 같은 응용 프로그램 범위를 선택하십시오:

        • Box에 저장된 모든 폴더 읽기
        • Box에 저장된 모든 폴더를 작성하십시오
        • 사용자 관리

        다음 고급 기능을 활성화하십시오:

        • 사용자 액세스 토큰 생성

      • 앱 액세스 전용

        서비스 계정과만 공유되는 파일을 크롤링하려면 다음 단계를 완료하세요:

        1. 다음과 같은 응용 프로그램 범위를 선택하십시오:

          • Box에 저장된 모든 폴더 읽기
          • Box에 저장된 모든 폴더를 작성하십시오

        2. 다음 단계를 완료하여 대상 Box 폴더 및 파일을 서비스 계정과 공유하세요:

          1. 일반 설정 페이지에서 서비스 계정 ID의 이메일을 복사합니다.
          2. 관리되는 사용자로 로그인한 경우 커넥터가 크롤링할 수 있도록 하려는 폴더 또는 파일을 공유합니다.
          3. 파일을 공유하도록 초대할 사람으로 서비스 계정 ID 이메일을 추가합니다.

          자세한 내용은 더 박스 문서를 참조하세요.

        서비스 계정 및 해당 앱 사용자와 공유되는 파일을 크롤링하려면 다음 단계를 완료하세요:

        1. 다음과 같은 응용 프로그램 범위를 선택하십시오:

          • Box에 저장된 모든 폴더 읽기
          • Box에 저장된 모든 폴더를 작성하십시오
          • 사용자 관리

        2. 다음 고급 기능을 활성화하십시오:

          • 사용자 액세스 토큰 생성

        3. 대상 Box 폴더 및 파일을 해당 앱 사용자와 공유하세요.

          자세한 내용은 더 박스 문서를 참조하세요.

  3. 인증용 키를 생성합니다. 다음 태스크를 완료했는지 확인하십시오.

    1. 일반 설정 페이지에서 공개키 추가를 클릭합니다.
    2. 개인 키용으로 생성된 다운로드한 구성 파일을 저장합니다.
    3. 변경사항 저장을 클릭하십시오.
    4. 설정 페이지에서 클라이언트 ID 값을 복사합니다.

  4. 다음으로 Box 관리자에게 앱 승인을 요청해야 합니다. Box 관리 콘솔에서 다음 태스크를 완료하십시오.

    1. 앱 > 사용자 지정 앱 관리자 페이지에서 앱 추가를 클릭합니다.

    2. 클라이언트 ID를 입력한 다음, 다음을 클릭합니다.

      자세한 내용은 맞춤형 앱 승인를 참조하세요.

  5. Box 관리자 단계: Box 관리자 콘솔에서 앱 정보가 정확한지 확인한 다음 인증를 클릭합니다.

Box 데이터 소스에 연결

Discovery 프로젝트에서 다음 단계를 완료하십시오

  1. 탐색 창에서 컬렉션 관리를 선택합니다.

  2. 새 컬렉션을 클릭합니다.

  3. 상자를 클릭한 다음, 다음을 클릭합니다.

  4. 컬렉션의 이름을 지정합니다.

  5. Box에 있는 문서의 언어가 영어가 아닌 경우 적절한 언어를 선택하세요.

    지원되는 언어 목록은 언어 지원을 참조하십시오.

  6. 선택사항. 동기화 일정을 변경합니다.

    자세한 내용은 크롤링 일정 옵션 를 참조하세요.

  7. 자격증명 입력 섹션에서 파일 선택를 클릭한 다음, 필수 단계의 일부로 공개 키를 추가할 때 생성 및 다운로드한 구성 파일을 찾아서 찾습니다.

    Box 개발자 사이트의 구성 페이지에서 구성 파일을 다시 다운로드할 수 있습니다.

  8. 선택사항. 크롤링할 대상 지정하기 섹션에서 특정 사용자의 콘텐츠 또는 크롤링할 콘텐츠가 있는 특정 폴더를 선택합니다. 아무것도 지정하지 않으면 서비스에서 사용자 지정 앱에서 사용할 수 있는 모든 콘텐츠를 크롤링합니다.

    • 전체 엔터프라이즈를 크롤링하려면 box://app.box.com/를 입력하십시오.

    • 특정 폴더를 크롤링하려면 box://app.box.com/user/USER'S_ACCOUNT_ID/folder/FOLDER_ID/FolderName 를 입력하세요.

      예를 들어, 다음과 같습니다. box://example.app.box.com/user/460250779/folder/158001591642/My Folder

    • 특정 사용자를 크롤링하려면 box://app.box.com/user/USER'S_ACCOUNT_ID/ 를 입력하십시오.

  9. 선택 사항: 프록시 서버를 사용하여 데이터 소스 서버에 액세스하는 경우 프록시 설정 섹션에서 프록시 설정 사용 스위치를 On 로 설정합니다. 다음 필드에 값을 추가합니다:

    사용자 이름
    선택사항. 프록시 서버에서 인증을 요구하는 경우, 인증을 위해 사용하는 사용자 이름. 사용자 이름을 모르는 경우 프록시 서버 관리자로부터 얻을 수 있습니다.
    비밀번호
    선택사항. 프록시 서버에서 인증이 필요한 경우, 인증에 사용하는 비밀번호. 비밀번호를 모르는 경우 프록시 서버 관리자로부터 얻을 수 있습니다.
    프록시 서버 호스트 이름 또는 IP 주소
    프록시 서버의 호스트 이름 또는 IP 주소.
    프록시 서버 포트 번호
    프록시 서버에 연결하고자 하는 네트워크 포트입니다.

  10. 선택사항. 문서 수준 보안을 활성화하려면 보안 섹션에서 문서 수준 보안 활성화 스위치를 On 로 설정합니다.

    이 옵션을 활성화하면 사용자는 Box에 로그인했을 때 액세스할 수 있는 동일한 콘텐츠를 크롤링하고 쿼리할 수 있습니다. 자세한 내용은 문서 수준 보안 지원 를 참조하세요.

  11. 크롤러가 사이트의 이미지에서 텍스트를 추출하도록 하려면 추가 처리 설정를 확장하고 광학 문자 인식(OCR) 를 On 으로 설정합니다.

    OCR이 활성화되어 있고 문서에 이미지가 포함되어 있으면 처리 시간이 더 오래 걸립니다. 자세한 내용은 광학 문자 인식 를 참조하세요.

  12. ** 완료**를 누르십시오.

컬렉션이 빠르게 생성됩니다. 데이터가 컬렉션에 추가되면 처리하는 데 시간이 더 걸립니다.

진행 상황을 확인하려면 활동 페이지로 이동하세요. 탐색 창에서 컬렉션 관리를 클릭한 다음 클릭하여 컬렉션을 엽니다.