Box 연결 정보

입력 항목

품목명	필수	내용
이름	예	TROCCO 내부에서 사용할 연결 정보 이름을 입력합니다.
메모	No	TROCCO 내부에서 사용할 연결 정보 메모를 입력할 수 있습니다.
인증 방식	예	인증 방식을 선택합니다. OAuth 2.0 인증 OAuth 2.0 인증은 전송원 Box에서만 사용할 수 있습니다. JWT 인증
Box 계정	예	인증 방식으로 OAuth 2.0 인증을 선택한 경우 입력합니다. Box 계정 인증을 클릭하세요.
커스텀 앱 설정 파일	예	인증방식에서 JWT 인증을 선택한 경우 입력합니다. 입력 내용에 대한 자세한 내용은 커스텀 앱을 이용한 데이터 전송을 참고하세요.

품목명

필수

내용

이름

예

TROCCO 내부에서 사용할 연결 정보 이름을 입력합니다.

메모

TROCCO 내부에서 사용할 연결 정보 메모를 입력할 수 있습니다.

인증 방식

예

인증 방식을 선택합니다.

OAuth 2.0 인증
- OAuth 2.0 인증은 전송원 Box에서만 사용할 수 있습니다.
JWT 인증

Box 계정

예

인증 방식으로 OAuth 2.0 인증을 선택한 경우 입력합니다.
Box 계정 인증을 클릭하세요.

커스텀 앱 설정 파일

예

인증방식에서 JWT 인증을 선택한 경우 입력합니다.
입력 내용에 대한 자세한 내용은 커스텀 앱을 이용한 데이터 전송을 참고하세요.

주의 사항

Box API의 일부 토큰, 코드, URL에는 유효기간이 설정되어 있습니다.

액세스 토큰의 유효기간

액세스 토큰은 전송원 Box에서 데이터를 가져올 때 활용됩니다.
액세스 토큰의 유효기간은 60분입니다.

유효기간 내에 전송 대상 데이터를 전송처 Box에서 가져오지 못한 경우, 해당 데이터는 전송되지 않습니다.
만약 유효기간 내에 데이터 취득이 완료되지 않을 경우, 전송 대상 데이터 크기를 줄이는 등의 조치를 취해 주십시오.

갱신 토큰의 유효기간

인증방식으로 OAuth 2.0 인증을 사용하는 경우, 전송원 Box에서 데이터를 가져올 때 업데이트 토큰이 활용된다.
갱신 토큰의 유효기간은 갱신 토큰 생성 또는 사용을 기점으로 60일입니다.

연결 정보 생성 또는 마지막 데이터 전송을 기준으로 60일 동안 데이터 전송이 이루어지지 않을 경우, 갱신 토큰은 만료됩니다.
갱신 토큰이 만료된 경우, 연결 정보 편집 화면에서 Box 계정 인증을 다시 수행해야 합니다.

위 외에도 유효기간이 설정되어 있는 것도 있습니다.
자세한 내용은 토큰 및 URL의 유효기간을 참조하세요.

커스텀 앱을 이용한 데이터 전송

다음은 커스텀 앱을 사용하여 데이터를 전송하는 절차를 설명합니다.
커스텀 앱 제작, 승인, 공유의 세 가지 프로세스로 나누어 설명합니다.

커스텀 앱 제작 및 승인 요청

내 계정(Box 상단 화면)에서 개발자 콘솔 을 클릭합니다.
cc_box_001

내 앱에서 앱 새로 만들기를 클릭합니다.
cc_box_002

사용자 지정 앱을 클릭합니다.
cc_box_003

인증 방법으로 서버 인증(JWT 사용) 을 선택하고, 원하는 앱 이름을 입력한 후 앱 생성을 클릭한다.
cc_box_004

구성 탭 > 공개키 추가 및 관리에서****공개/비밀 키 쌍 생성을 클릭합니다.
cc_box_005
아래 구성의 비밀키가 JSON 파일 형식으로 다운로드됩니다.

{ "boxAppSettings": { "clientID": "YYYYY", "clientSecret": "YYYYYY", "clientSecret "XXXXXXX", "appAuth": "XXXXXXX". { "publicKeyID": "AAAA", "privateKey": "AAAA", "privateKey": "BBBBB", "passphrase": "BBBBB". "CCCC" } }, "enterpriseID": "CCCC" } }. "ZZZZ"}

이전 단계에서 가져온 JSON 파일의 내용을 모두 복사하여 TROCCO의 연결 정보 생성 화면의 사용자 지정 앱 설정 파일에 붙여 넣습니다.
cc_box_006