개요
Box 사용자, 그룹, 파일 및 폴더에 대한 작업을 수행하고 Freshservice에서 Box 사용을 관리합니다
설명
Box 앱은 Freshservice 내에서 반복 가능한 작업을 자동화하고 SaaS 관리에 대한 정확한 사용 정보를 추적하는 데 도움이 됩니다.
오케스트레이션
오케스트레이션 앱은 Freshservice 워크플로우를 통해 특정 작업을 수행하여 다양한 시스템에 걸쳐 여러 반복 가능한 작업을 자동화할 수 있는 기능을 제공합니다. Box 앱을 사용하여 다음 작업을 수행할 수 있습니다:
사용자 관리
사용자 생성
사용자 삭제
사용자 비활성화
사용자 활성화
사용자 업데이트
사용자 ID 조회
사용자 가져오기
그룹에 사용자 추가
그룹 관리
그룹 생성
그룹 삭제
그룹 업데이트
문서 관리
소유 항목 전송
파일 삭제
파일에 대한 공유 링크 가져오기
파일에 대한 공유 링크 생성
Box 파일을 FS 티켓 노트에 첨부
Box 파일을 첨부 파일로 하여 티켓 생성
티켓 첨부 파일을 Box에 업로드
문서 공유
협력자 추가
협력 제거
폴더 관리
폴더 생성
폴더 삭제
폴더에 대한 공유 링크 가져오기
폴더에 대한 공유 링크 생성
참고: 모든 문서 및 폴더 관리 작업은 사용자가 구성할 사용자 정의 앱 내의 항목에 대해서만 수행할 수 있습니다.
Saas 관리
이 통합은 SaaS 관리 애드온이 필요합니다. 자세한 내용은 여기에서 확인할 수 있습니다.
Freshservice의 Box와의 SaaS 관리 통합을 통해 Freshservice 내에서 Box를 직접 사용하여 사용자 추적 및 관리를 할 수 있습니다. Box와의 통합을 통해 다음을 수행할 수 있습니다:
Box를 사용하는 사용자와 그들의 Box 사용 빈도(로그인뿐만 아니라 Box에서 파일 생성/업데이트)를 추적하여 비활성 사용자를 비활성화 대상으로 식별합니다
이 통합을 SaaS 관리에 사용하려면,
- SaaS 탐색 토글을 활성화하고 Freshservice 도메인 이름 및 상담원 API 키를 제공합니다.
참고: SaaS 탐색이 무엇인지에 대해 더 알고 싶다면, 여기를 클릭하세요. - 클릭 확인.
- 확인이 성공하면, 클릭 추가 하고 설치를 클릭하여 설치를 완료합니다.
참고: 첫 번째 동기화는 데이터 로드에 따라 몇 시간이 걸릴 수 있습니다.
사전 요구 사항
Box API를 사용하기 시작하려면 서버 측 인증을 사용하여 사용자 정의 앱을 설정해야 합니다
앱 생성
Box에 로그인하고 개발자 콘솔로 이동합니다. 새 앱 생성을 선택합니다.
애플리케이션 유형 목록에서 사용자 정의 앱을 선택합니다. 다음 단계에 대한 선택을 요청하는 모달이 나타납니다.
서버 인증(JWT 사용)을 선택하여 키 쌍으로 애플리케이션 ID를 확인합니다. 그런 다음 애플리케이션 이름을 제공하고 앱 생성을 클릭합니다.
참고: 선택을 완료하면 새 애플리케이션을 생성하지 않고는 다른 인증 방법으로 변경할 수 없습니다.
2. 기본 구성
애플리케이션 액세스
기업의 기존 관리 사용자를 사용하려면 개발자 콘솔의 구성 탭을 통해 액세스할 수 있는 애플리케이션 액세스 설정으로 이동합니다. 앱 액세스 + 기업 액세스로 설정합니다.
애플리케이션 범위
앱 작업을 수행하려면 애플리케이션 범위에 나열된 모든 범위를 선택합니다. 각 옵션에 대한 자세한 정보는 범위 가이드를 참조하세요 여기.
3. 공개 및 개인 키 생성
JWT를 사용한 서버 인증을 활용하여 사용자 정의 앱이 생성되면 개발자 콘솔의 구성 탭을 통해 키 쌍을 생성할 수 있습니다. 선택한 방법에 관계없이 Box 계정에는 보안 목적으로 2FA가 활성화되어 있어야 합니다.
키 쌍 구성 파일을 생성하려면 개발자 콘솔의 구성 탭으로 이동하여 공개 키 추가 및 관리 섹션으로 스크롤합니다
Box가 키 쌍을 생성하도록 공개/개인 키 쌍 생성 버튼을 클릭합니다. 그러면 애플리케이션에서 Box 구성 매개변수의 입력으로 사용할 수 있는 JSON 구성 파일이 다운로드됩니다.
참고: 보안상의 이유로 Box는 개인 키를 저장하지 않습니다. 개인 키를 분실한 경우 전체 키 쌍을 재설정해야 합니다.
4. 앱 권한 부여
애플리케이션을 사용하기 전에 Box 관리자가 Box 관리자 콘솔 내에서 애플리케이션을 승인해야 합니다.
개발자 콘솔 내에서 애플리케이션에 대한 권한 부여 탭으로 이동합니다.
승인을 위해 Box 엔터프라이즈 관리자에게 이메일을 보내려면 제출 및 검토를 클릭합니다.
구성 변경 후 재인증
일반적인 규칙으로, 개발자 콘솔 내에서 구성 변경 후 Box 관리자 콘솔에서 애플리케이션은 재인증이 필요합니다. 이 단계를 건너뛰면 생성된 액세스 토큰이 구성 변경 사항을 반영하지 않습니다.
앱 설치 매개변수
앱을 설치하고 인증하려면 다음 입력을 제공해야 합니다:
Box 구성 - 공개 및 개인 키 쌍을 생성할 때 다운로드한 JSON 파일에서 복사
다음 두 매개변수는 문서를 Freshservice 티켓에 노트로 첨부하거나 새 티켓에 직접 첨부하는 데 필요합니다.
Freshservice 도메인 - Freshservice 테넌트의 도메인입니다. 예: demo.freshservice.com
Freshservice API 키 - Freshservice 테넌트에 로그인합니다. 프로필 아이콘을 클릭한 다음 오른쪽 창에서 "프로필 설정"을 클릭하고 "내 API 키" 아래에서 캡차를 완료하고 API 키를 복사합니다.
