외부 콘텐츠 인덱싱 구성 Box

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 3분

    • 개발자 콘솔에서 OAuth 2.0 애플리케이션을 Box 생성하고 권한을 부여하여 외부 콘텐츠 커넥터가 소스 시스템에 액세스할 Box 수 있도록 허용합니다Box.

    시작하기 전에

    개발자 콘솔 및 Box 관리자 UI 포털에 대한 Box 관리자 액세스 권한이 필요합니다.

    외부 콘텐츠 커넥터에 대한 Box 개인/공개 키 쌍을 만들고 PEM 인코딩(Base64 ASCII) X.509 형식으로 공개 키 인증서를 추출해야 합니다. 공개/개인 키 쌍 생성 및 공개 키 인증서 추출에 대한 자세한 내용은 을 참조하십시오 외부 콘텐츠 커넥터에 대한 Box 공개/개인 키 쌍 만들기.

    필요한 역할: 없음

    이 태스크 정보

    Box 외부 콘텐츠 커넥터는 API를 Box 사용하여 소스 시스템에서 Box 문서와 사용자 권한을 검색합니다.

    커넥터가 API를 Box 통해 소스 시스템에 액세스할 Box 수 있도록 하려면 개발자 콘솔에서 OAuth 2.0 애플리케이션을 Box 구성하고 권한을 부여해야 합니다. 커넥터 관리자는 OAuth 2.0 애플리케이션 및 해당 API 키에서 복사한 설정을 사용하여 소스 시스템에 적절하게 연결하도록 외부 커넥터를 구성할 Box 수 있습니다.

    프로시저

    1. Box 개발자 콘솔에서 외부 콘텐츠 커넥터에 대한 Box 새 OAuth 2.0 애플리케이션을 생성합니다.
      1. 관리자 자격 증명으로 https://app.box.com/developers/console 이동하여 로그인합니다.
      2. 플랫폼 앱 생성을 선택한 다음 사용자 지정 앱을 선택합니다.
        개발자 콘솔의 Box 내 플랫폼 앱 화면.
      3. 사용자 지정 앱 만들기 창에서 앱의 이름을 입력하고 용도를 지정한 후 다음을 선택합니다.
        개발자 콘솔에서 사용자 지정 앱 화면 1/2 Box 생성.
      4. 사용자 지정 앱 만들기 창에서 서버 인증(JWT 사용)을 선택한 다음, 앱 만들기를 선택합니다.
        개발자 콘솔에서 사용자 지정 앱 화면 2/2 Box 생성.
        새 OAuth 2.0 애플리케이션에 대한 구성 화면이 나타납니다.
    2. 필요한 설정으로 새 OAuth 2.0 애플리케이션을 구성하고 이에 대한 공개/비공개 키 페어를 생성합니다.
      1. 앱 액세스 수준 섹션에서 앱 + 엔터프라이즈 액세스 옵션을 선택합니다.
        개발자 콘솔의 Box 앱 접근 수준 구성 설정.
      2. 애플리케이션 범위 섹션의 콘텐츠 작업 제목 아래에서 Box에 저장된 모든 파일 및 폴더 읽기 및 Box에 저장된 모든 파일 및 폴더 쓰기 옵션이 아직 선택되지 않은 경우 선택합니다.
        개발자 콘솔의 Box 애플리케이션 범위 구성 설정입니다.
      3. 고급 기능 섹션에서 있는 그대로 헤더를 사용하여 API 호출하기 및 사용자 액세스 토큰 생성 옵션을 선택합니다.
        개발자 콘솔의 Box 고급 기능 구성 설정.
      4. 공개 키 추가 및 관리 섹션에서 공개 키 추가를 선택합니다.
        개발자 콘솔에서 공개 키 구성 설정을 Box 추가하고 관리합니다.
        새 공개 키 추가 대화 상자가 나타납니다.
      5. 새 공개 키 추가 대화 상자에서 -----BEGIN PUBLIC KEY ----- 및 -----END PUBLIC KEY ----- 마커를 포함하여 PEM 인코딩 공개 키 텍스트를 공개 키 필드에 붙여 넣은 다음 확인 및 저장을 선택합니다.
        개발자 콘솔에서 새 공개 키 대화 상자를 Box 추가합니다.
      6. 새 공개 키에 대해 표시되는 공개 키 ID 문자열을 Box 복사하여 안전한 위치에 저장합니다.
        개발자 콘솔에서 새 공개 키에 표시되는 ID입니다Box.
        중요사항:
        커넥터 관리자는 외부 콘텐츠 커넥터를 구성할 때 이 공개 키 ID 문자열이 필요합니다.Box
      7. 앱 설정 섹션에서 JSON으로 다운로드를 선택한 다음, 다운로드한 JSON 형식 설정 파일을 안전한 위치에 저장합니다.
        개발자 콘솔의 Box 앱 설정 섹션.
        중요사항:
        커넥터 관리자는 외부 콘텐츠 커넥터를 구성할 때 이 JSON 형식 설정 파일이 필요합니다.Box
      8. 변경 내용 저장을 선택합니다.
        OAuth 2.0 앱의 구성이 성공적으로 업데이트되었음을 알리는 메시지가 나타납니다.
    3. 새 OAuth 2.0 애플리케이션에 대한 권한 부여 요청을 제출합니다.
      1. 새 OAuth 2.0 애플리케이션에 대한 권한 부여 화면으로 이동합니다.
      2. 검토 및 제출을 선택합니다.
        개발자 콘솔 인증 설정의 Box 검토 및 제출 옵션.
      3. 앱 권한 부여 제출 검토 화면에서 OAuth 2.0 애플리케이션에 대한 설명을 입력한 다음, 제출을 선택합니다.
        개발자 콘솔에서 앱 인증 제출 검토 화면.Box
        앱의 인증 상태는 인증 보류 중으로 표시됩니다.
    4. Box 관리 UI 포털에서 새 OAuth 2.0 애플리케이션에 권한을 부여합니다.
      1. 관리자 자격 증명으로 https://app.box.com/master 이동하여 로그인합니다.
      2. 통합 메뉴 아이콘 을 선택한 다음 플랫폼 앱 관리자 탭으로 이동합니다.
      3. 서버 인증 앱을 선택하고 새 OAuth 2.0 애플리케이션에 대한 항목을 찾습니다.
      4. 오버플로우 아이콘 을 선택하여 앱 항목의 컨텍스트 메뉴를 연 다음, 앱 인증을 선택합니다.
        의 Box 플랫폼 앱 관리자 화면 관리자 UI 포털
      5. Authorize App(앱 인증) 화면에서 Authorize( 인증)를 선택합니다.
        의 Box 앱 승인 화면 관리자 UI 포털
        앱의 권한 부여 상태가 권한 부여됨으로 변경됩니다.

    다음에 수행할 작업

    커넥터 관리자에게 다음 항목을 제공합니다.
    • OAuth 2.0 애플리케이션을 구성하는 데 사용한 관리자 계정의 이메일 주소 Box 입니다.
    • 단계에서 2.f복사한 공개 키 ID 문자열입니다.
    • 단계에서 2.g다운로드한 JSON 형식 설정 파일입니다.

    커넥터 관리자는 소스 시스템에서 사용자 상자와 보안 주체를 검색하도록 외부 콘텐츠 커넥터를 Box 구성하려면 이러한 항목이 Box 필요합니다.

    클라우드 외부 콘텐츠 커넥터 생성 및 구성에 Box 대한 자세한 내용은 문서를 참조하십시오 Box 외부 콘텐츠 커넥터 생성.