Box CLI

프로그램 소개

Box CLI는 Box 플랫폼과 상호작용하기 위한 강력한 명령줄 인터페이스입니다. 이를 통해 사용자는 Box 계정의 파일, 폴더, 사용자, 공동 작업 등을 손쉽게 관리할 수 있습니다.

주요 기능

• 대량 작업(Bulk Actions): CSV 파일을 사용하여 여러 파일이나 폴더에 대한 작업을 한 번에 실행할 수 있습니다. 각 행은 개별적인 API 호출로 처리됩니다.
• 사용자 대리 실행(As-User Header): 다른 사용자를 대신하여 작업을 수행할 수 있는 기능을 제공합니다.
• 검색 API(Search API): Box 엔터프라이즈 계정 내의 파일과 폴더를 검색할 수 있습니다.
• 포괄적인 관리 명령어: 파일 관리(files), 폴더 관리(folders), 사용자 관리(users), 공유 링크 관리(shared-links), 작업 관리(tasks), 검색(search), 웹훅(webhooks) 등 Box API가 제공하는 다양한 기능을 명령어로 제어할 수 있습니다.

다운로드·설치 방법

Box CLI는 Windows와 macOS용 설치 프로그램을 제공합니다. 최신 릴리스 페이지에서 해당 시스템의 설치 파일(.exe 또는 .pkg)을 다운로드하여 설치할 수 있습니다.

Linux 환경이나 Node.js 패키지로 설치하려면, 시스템에 Node.js가 설치된 상태에서 아래 명령어를 실행하면 됩니다.

npm install –global @box/cli

기본 사용법

설치 후 가장 먼저 해야 할 일은 Box 계정에 로그인하는 것입니다.

• 빠른 로그인: 공식 Box CLI 앱을 사용하여 가장 간단하게 로그인할 수 있습니다. 터미널에서 box login -d 명령어를 실행하면 브라우저 창이 열려 인증을 진행할 수 있습니다.
• 플랫폼 앱 로그인:自己의 OAuth 앱(Client ID와 Client Secret)을 사용하여 로그인할 수도 있습니다. box login 명령어를 실행하고 안내에 따라 자격 증명을 입력합니다.
• JWT 인증: 서버 환경 등에서 사용할 수 있는 JWT 방식도 지원합니다. Box 개발자 콘솔에서 다운로드한 JSON 구성 파일을 CLI에 등록하여 사용할 수 있습니다.

로그인 후 box 명령어와 함께 다양한 명령어(예: box users:get, box search)를 사용하여 작업을 수행할 수 있습니다.

이런 경우에 유용합니다

• 企業 콘텐츠 관리: 수백 또는 수천 개의 파일과 폴더를 한 번에 업로드, 다운로드, 이동하거나 메타데이터를 추가해야 할 때
• 사용자 및 권한 관리: 엔터프라이즈 내의 여러 사용자를 대상으로 공동 작업을 설정하거나 사용자 정보를 조회해야 할 때
• 자동화 스크립트 작성: 정기적인 백업, 보고서 생성, 파일 정리 등의 반복적인 작업을 자동화하고 싶을 때
• 개발 및 통합: Box API와 직접 상호작용하는 자체 앱이나 워크플로우를 개발할 때 Box CLI를 테스트 도구로 활용할 때

지원 환경·시스템 요구사항

Box CLI는 Windows, macOS, Linux에서 사용할 수 있습니다. 모든 플랫폼에서 사용하기 위해 Node.js 18 이상이 설치되어 있어야 합니다. Windows와 macOS에서는 별도의 안정된 저장소(Credential Manager 또는 Keychain)를 사용하여 인증 정보를 안전하게 관리합니다.

최신 버전·업데이트

최신 버전은 3.16.0입니다. GitHub 릴리스 페이지에서 최신 업데이트 내역을 확인하고 설치 파일을 다운로드할 수 있습니다.

제한 사항·확인 사항

Linux 환경에서 안전한 자격 증명 저장을 위해 libsecret-1-dev 패키지가 설치되어 있어야 합니다. 이 패키지가 없으면 자격 증명이 평문 파일로 저장될 수 있습니다. Box CLI는 현재 MAJOR 버전(3.x)만 지원하며, 이전 버전은 더 이상 업데이트되지 않습니다.