Box의 데이터에 액세스하려면 해당 데이터에 대한 연결 자산을 작성하십시오.
Box 플랫폼은 클라우드 컨텐츠 관리 및 파일 공유 서비스입니다.
전제조건
Box에서 사용자 정의 앱 작성
Box에 대한 연결을 작성하기 전에 Box Developer Console에서 사용자 정의 앱을 작성합니다. 사용자가 파일을 공유하는 데 사용할 수 있는 애플리케이션 레벨 액세스를 위한 앱을 작성하거나 모든 사용자 계정에 대한 엔터프라이즈 액세스를 위한 앱을 작성할 수 있습니다. 엔터프라이즈 액세스를 사용하면 사용자는 파일과 폴더를 애플리케이션과 공유할 필요가 없습니다.
- Box Developer Console로 이동한 후 마법사에 따라 사용자 정의 앱을 작성하십시오. 인증 방법에
OAuth 2.0 with JWT (Server Authentication)
을 선택하십시오. - 구성 페이지에서 다음을 선택하십시오. 아니면 기본 설정을 유지하십시오.
- 앱 액세스 레벨에 대해 다음 두 가지 선택사항 중 하나를 선택하십시오.
- 사용자가 파일을 공유하는 액세스를 허용하려면 기본 앱 액세스 전용 선택사항을 보존하십시오.
- 앱 + 엔터프라이즈 액세스를 선택하여 모든 사용자 계정에 대한 엔터프라이즈 전체 액세스 권한이 있는 앱을 작성하십시오.
- 사용자가 파일을 공유하는 액세스를 허용하려면 기본 앱 액세스 전용 선택사항을 보존하십시오.
- 공용 키 추가 및 관리아래에서 공용/개인 키패드 생성을 클릭하십시오. 이 선택을 하려면 Box 계정에 2요소 인증을 사용하도록 설정해야 합니다. 나중에 이를 사용 안함으로 설정할 수 있습니다. 생성된 키 쌍은 다운로드할 구성(
*_config.json
) 파일을 생성합니다. 프로젝트에서 연결을 작성하려면 이 파일의 정보가 필요합니다.
- 앱 액세스 레벨에 대해 다음 두 가지 선택사항 중 하나를 선택하십시오.
- 앱 + 엔터프라이즈 액세스를 선택한 경우 고급 기능아래에서 다음 두 선택란을 모두 선택하십시오.
- 사용자 헤더를 사용하여 API 호출 작성
- 사용자 액세스 토큰 생성
- 권한 부여를 위해 Box 엔터프라이즈 관리자에게 앱 클라이언트 ID를 제출하십시오. Box Developer Console의 애플리케이션으로 이동한 후 애플리케이션의 왼쪽 사이드바에 있는 일반 링크를 선택하십시오. 앱 권한 섹션으로 화면 이동하십시오.
개인 키 해독하기
연결된 비밀번호를 사용하여 개인키를 해독하려면 다음 명령을 실행합니다. 이 프로세스는 ' openssl pkcs8
명령을 사용하여 암호화되지 않은 버전의 개인키를 생성합니다.
openssl pkcs8 -in private_key.pem -passin file:pass.txt -out private_key_unencrypted.pem
사용되는 매개 변수는 다음과 같습니다:
- private_key.pem
- Box에서 생성하여 제공한 암호화된 개인 키입니다.
- pass.txt
- 이 파일에는 Box에서 생성하여 제공한 개인 키와 연결된 비밀번호가 포함되어 있습니다.
- private_key_unencrypted.pem
- 명령을 실행한 후 암호화되지 않은 개인 키가 포함된 출력 파일입니다.
플랫폼에 있는 위치를 기반으로 연결을 작성하는 방법 선택
- 프로젝트에서
- 자산 > 새 자산 > 데이터 소스에 연결을 클릭하십시오. 프로젝트에 연결 추가를 참조하십시오.
- 카탈로그에서
- 카탈로그에 추가 > 연결을 클릭하십시오. 카탈로그에 연결 자산 추가를 참조하십시오.
- 배치 영역에서
- 자산 가져오기 > 데이터 액세스 > 연결을 클릭하십시오. 배치 영역에 데이터 자산 추가를 참조하십시오.
- 플랫폼 자산 카탈로그에서
- 새 연결을 클릭하십시오. 플랫폼 연결 추가를 참조하십시오.
Box 연결 작성
다음 설정에 다운로드한 구성 파일의 값을 입력하십시오.
- 클라이언트 ID
- 클라이언트 시크릿
- Enterprise ID
- 개인 키(각
\n
을(를) 줄 바꾸기로 바꾸기) - 개인 키 비밀번호(구성 파일의
passphrase
값) - 공용 키(구성 파일의
publicKeyID
값)
엔터프라이즈 앱
엔터프라이즈 전체 액세스 앱을 구성한 경우, 사용자 이름 필드에 Box 사용자 계정의 사용자 이름을 입력하십시오.
애플리케이션 레벨 앱
사용자는 앱이 파일에 액세스하기 위해 앱의 이메일 주소로 파일을 명시적으로 공유해야 합니다.
앱 이메일 주소를 알아내려면 연결에 대한 REST 호출을 실행하십시오. 예를 들어,
PUT https://api.dataplatform.cloud.ibm.com/v2/connections/{connection_id}/actions/get_user_info?project_id={project_id}
요청 본문:
{}
반환:
{ "login_name": "[email protected]" }
REST 호출에서 반환된 로그인 이름으로 watsonx.ai Studio에서 액세스하려는 파일 및 폴더를 Box에서 공유하세요.
다음 단계: 연결에서 데이터 자산 추가
프로젝트에 있는 연결에서 데이터 추가를 참조하십시오.
카탈로그에 있는 연결에서 데이터 추가를 참조하십시오.
이 연결의 사용처
다음 작업 공간 및 도구에서 Box 연결을 사용할 수 있습니다.
프로젝트
- Data Refinery (watsonx.ai Studio 또는 ' IBM Knowledge Catalog' )
- DataStage (DataStage 서비스). DataStage의 데이터 소스에 연결을 참조하십시오.
- 메타데이터 강화IBM Knowledge Catalog
- Metadata import (IBM Knowledge Catalog)
Catalogs
Platform assets catalog
기타 카탈로그IBM Knowledge Catalog
제한사항
Box 폴더에 수천 개의 파일이 있는 경우 연결은 제한시간이 초과되기 전에 파일을 검색하지 못할 수 있습니다. Box 파일을 사용하는 작업 또는 프로파일링이 작동하지 않을 수 있습니다.
임시 해결책: 동일한 폴더에 더 적은 수의 파일이 있도록 Box에서 파일 계층 구조를 재구성하십시오.
지원되는 파일 유형
Box 연결은 Avro, CSV, Delimited text, Excel, JSON, ORC, Parquet, SAS, SAV, SHP, XML등의 파일 유형을 지원합니다.
자세한 정보
상위 주제: 지원되는 연결