박스 연결
Box에 있는 데이터에 액세스하려면 해당 데이터에 대한 연결 자산을 생성하세요.
Box 플랫폼은 클라우드 기반 콘텐츠 관리 및 파일 공유 서비스입니다.
전제조건
Box에서 나만의 앱 만들기
Box에 연결하기 전에 Box 개발자 콘솔에서 사용자 지정 앱을 생성해야 합니다. 사용자가 파일을 공유할 수 있는 애플리케이션 수준 액세스용 앱을 만들거나, 모든 사용자 계정에 대한 전사적 액세스용 앱을 만들 수 있습니다. 전사적인 액세스 권한이 있으므로, 사용자는 해당 애플리케이션과 파일 및 폴더를 공유할 필요가 없습니다.
- Box 개발자 콘솔로 이동한 후, 마법사의 안내에 따라 사용자 지정 앱을 생성하세요.
OAuth 2.0 with JWT (Server Authentication)인증 방법 에서 을 선택하십시오. - ‘구성’ 페이지에서 다음 항목을 선택하십시오. 그렇지 않다면 기본 설정을 그대로 유지하세요.
- 앱 액세스 수준 에 대해 다음 두 가지 옵션 중 하나를 선택하십시오:
- 사용자가 파일을 공유할 수 있도록 하려면 기본 설정인 ‘앱 액세스 전용 ’을 유지하십시오.
- ‘앱 + 엔터프라이즈 액세스’를 선택하여 모든 사용자 계정에 대한 전사적 액세스 권한을 가진 앱을 생성하세요.
- 사용자가 파일을 공유할 수 있도록 하려면 기본 설정인 ‘앱 액세스 전용 ’을 유지하십시오.
- ‘공개 키 추가 및 관리 ’에서 ‘공개/개인 키 쌍 생성’을 클릭합니다. 이 옵션을 선택하려면 Box 계정에서 2단계 인증이 활성화되어 있어야 하지만, 나중에 비활성화할 수 있습니다. 생성된 키 쌍을 사용하여 다운로드할 수 있는 config(
*_config.json) 파일이 생성됩니다. 프로젝트에서 연결을 작성하려면 이 파일의 정보가 필요합니다.
- 앱 액세스 수준 에 대해 다음 두 가지 옵션 중 하나를 선택하십시오:
- ‘앱 + 엔터프라이즈 액세스 ’를 선택한 경우, ‘고급 기능 ’에서 다음 두 가지 확인란을 모두 선택하십시오:
- 'as-user' 헤더를 사용하여 API 호출 수행
- 사용자 액세스 토큰 생성
- 승인을 위해 앱 클라이언트 ID를 Box 엔터프라이즈 관리자에게 제출하세요: Box Developer Console 에서 해당 애플리케이션으로 이동한 후, 애플리케이션 왼쪽 사이드바에서 ‘일반(General)’ 링크를 선택하세요. 화면을 아래로 스크롤하여 ‘앱 권한’ 섹션으로 이동하세요.
Box 연결 설정
다음 설정에 대해 다운로드한 구성 파일의 값을 입력하십시오:
- 클라이언트 ID
- 클라이언트 시크릿
- 엔터프라이즈 ID
- 개인 키 (각
\n자리를 줄 바꿈으로 대체하세요) - 개인 키 비밀번호 (설정 파일의 값
passphrase) - 공개 키 (구성 파일의 값
publicKeyID)
신임 정보의 경우, 저장소가 플랫폼에 대해 구성되어 있고 서비스가 금고를 지원하는 경우 비밀을 사용할 수 있습니다. 자세한 정보는 연결에서 금고의 비밀 정보 사용을 참조하십시오.
전사적 애플리케이션
전사적 액세스 앱을 구성한 경우, ‘사용자 이름’ 필드에 Box 사용자 계정의 사용자 이름을 입력하십시오.
애플리케이션 레벨 앱
앱이 파일에 접근하려면 사용자가 앱의 이메일 주소로 파일을 명시적으로 공유해야 합니다.
연결에 REST 호출을 수행하여 앱의 이메일 주소를 확인하세요. 예를 들어,
curl -X PUT "https://api.dataplatform.cloud.ibm.com/v2/connections/{connection_id}/actions/get_user_info?project_id={project_id}" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json"반환:
{ "login_name": "AutomationUser_123467_aBcDEFg12h@boxdevedition.com" }Watson Studio 에서 액세스할 수 있도록 하려는 Box의 파일과 폴더를 REST 호출을 통해 반환된 로그인 이름으로 공유하십시오.
FIPS (Federal Information Processing Standards) 준수
이 연결은 FIPS 규격을 준수하며, FIPS 지원 클러스터에서 사용할 수 있습니다.
개인 키 복호화
연관된 비밀번호를 사용하여 개인 키를 복호화하려면 다음 명령을 실행하십시오. 이 프로세스는 명령을 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 연결은 구조화된 파일 형식과 비구조화된 파일 형식을 모두 지원합니다.
이 연결은 Avro, CSV, 구분된 텍스트, Excel, JSON, ORC, Parquet, SAS, SAV, SHP 및 XML과 같은 구조화된 파일 형식을 지원합니다.
이 연결은 이진 데이터의 읽기 및 쓰기 모드를 지원합니다. 이 모드들은 DOC, DOCX, MD, PDF, PPT, PPTX, TXT와 같은 비정형 데이터 형식을 읽고 쓰는 데 사용할 수 있습니다.