Box 스포크

스토어에서 앱 요청

사용 가능한 모든 앱을 보고 스토어에 요청을 제출하는 방법에 대한 자세한 내용을 보려면 다음을 ServiceNow Store 방문하십시오. 출시된 모든 앱의 누적 릴리스 정보는 ServiceNow Store 버전 기록 릴리스 정보를 참조하십시오.

통합 허브 구독

이 스포크는 Integration Hub 구독이 필요합니다. 자세한 내용은 법무 일정 - 통합 허브 개요를 참조하십시오.

스포크 버전

Box 스포크 v3.6.0 이 최신 버전입니다.

지원되는 버전

API 버전 v2입니다.

스포크 요구 사항

인스턴스와 Box 계정에서 동일한 언어가 선택되어 ServiceNow 있는지 확인하십시오.

인스턴스에서 ServiceNow 다음으로 이동하여 필요한 언어를 선택합니다. 사용자 프로파일 > 기본 설정 > 표시.
Box 계정에서 다음으로 이동하여 필요한 언어를 선택합니다. 계정 설정 > 계정 > 일반 옵션.

스포크 플로우

Box 스포크 Box 작업 자동화를 보여주는 초안 상태의 샘플 플로우를 제공합니다. 샘플 플로우를 사용자 지정하려면 새 애플리케이션 범위에 복사합니다. 사용 가능한 샘플 플로우는 다음과 같습니다.


플로우	설명
작성 시 첨부 파일을 Box로 이동	새 첨부 파일 기록이 추가되면 첨부 파일을 Box에서 ServiceNow Box로 이동합니다. Box에서 이동된 첨부 파일에 대한 공유 링크로 트리거 기록을 업데이트합니다.
온보딩 사용자	Box 사용자 그룹에서 사용자를 만들 ServiceNow 때 Box에서 사용자를 만듭니다.

스포크 작업

에서는 Box 스포크 이벤트가 발생할 때 Box 작업을 자동화하는 작업을 제공합니다.ServiceNow 사용 가능한 작업은 다음과 같습니다.


범주	동작	설명
Box AI 관리	질문하기	제공된 컨텍스트를 사용하여 지원되는 AI 모델에 프롬프트를 보내고 사용자의 질문에 중점을 둔 간략한 답변을 반환합니다.
	메타데이터 추출 자유 형식	지원되는 AI 모델에 컨텍스트 인식 요청을 보내고 메타데이터를 구조화된 키-값 쌍으로 추출합니다.
	AI 에이전트 기본 구성 조회	지정된 AI 에이전트에 대한 기본 구성 설정을 검색합니다.
Box Hub 관리	ID로 Box 허브 정보 조회	지정된 허브 ID를 사용하여 Box 허브에 대한 상세 정보를 검색합니다.
	Box 허브 항목 스트림 조회	지정된 Box Hub와 연결된 모든 항목을 검색합니다.
	Box 허브 스트림 조회	접근 토큰을 생성하는 데 사용된 Box 자격 증명을 기반으로 요청 사용자가 사용할 수 있는 모든 Box 허브를 검색합니다.
문서 관리	파일에 메타데이터 추가	제공된 속성 정보를 Box 파일에 대한 메타데이터로 추가하여 저장합니다.
	기록에 상자 파일 첨부	Box에서 파일을 복사하여 지정된 ServiceNow 기록에 첨부합니다.
	파일 ID 조회	Box에 있는 지정된 파일의 ID를 검색합니다.
	소유 항목 이동	Box에서 지정된 사용자가 소유한 모든 항목을 지정된 폴더로 이동합니다.
	파일 제거	Box에서 지정된 파일을 제거합니다.
	콘텐츠 스트림 검색	사용자의 콘텐츠 또는 전체 엔터프라이즈에서 파일, 폴더, 웹 링크, 공유 파일을 조회합니다.
	파일 업로드	지정된 파일을 Box에 업로드합니다.
	보관 스트림 조회	Box 애플리케이션에서 사용 가능한 모든 아카이브를 검색합니다.
문서 공유	공동 작업자 추가	사용자 또는 그룹에 특정 파일이나 폴더에 대해 지정된 수준의 액세스 권한을 부여합니다. 공동 작업자는 다음 액세스 수준 중 하나를 갖습니다. 공동 소유자 편집자 미리 보기 업로더 미리 보기 업로더 뷰어 뷰어 업로더
	공유된 링크 작성	Box에서 파일이나 폴더에 대한 직접 읽기 전용 링크를 만듭니다.
	ID로 폴더 공동 작업자 조회	지정된 폴더 ID에 연결된 모든 공동 작업자를 검색합니다.
	공동 작업자 제거	Box의 파일이나 폴더에서 지정된 공동 작업을 제거합니다.
파일 관리	파일 정보 조회	지정된 파일에 대한 자세한 정보를 조회합니다.
폴더 관리	폴더 작성	지정된 Box 사용자 계정을 대신하여 Box에 폴더를 만듭니다.
	폴더 삭제	Box에서 지정된 폴더를 삭제합니다.
	폴더 ID 조회	Box에 있는 지정된 폴더의 ID를 검색합니다. 주: Box에 추가된 항목에 액세스할 수 있으려면 10분이 걸립니다. 예를 들어 하나의 작업이 폴더를 생성하는 경우 폴더 ID 조회 작업은 10분이 지나야 결과를 반환하지 않습니다.
	폴더 정보 조회	지정된 폴더의 상세 정보를 검색합니다.
	폴더 항목 스트림 조회	파일, 하위 폴더 및 웹 링크를 포함하여 지정된 폴더 내의 모든 항목을 검색합니다.
그룹 관리	그룹 작성	지정된 초대 기본 설정으로 Box에서 그룹을 작성합니다.
	그룹 삭제	Box에서 지정된 그룹을 삭제합니다.
	그룹 업데이트	지정된 기본 설정으로 Box의 지정된 그룹을 업데이트합니다.
법무 자료보전 관리	법무 자료보전 보험 할당	파일, 파일 버전, 폴더 또는 사용자에게 법무 보전 보험을 할당합니다.
	소송대비 자료보전(Legal Holds) 보험 작성	법무 보전 보험을 작성합니다.
	모든 법무 보류 보험 스트림 조회	기업의 법무 보류 보험 목록을 조회합니다.
	ID로 법무 보류 보험 할당 조회	지정된 ID에 대한 법무 보류 보험 할당을 조회합니다.
	법무 보류 보험 할당 스트림 조회	법무 보류 보험에 할당된 항목의 목록을 조회합니다.
	ID로 법무 보류 보험 조회	지정된 ID에 대한 법무 보전 보험을 조회합니다.
	소송대비 자료보전(Legal Holds) 보험 제거	기존의 법무 보전 보험을 삭제합니다.
	법무 자료보전 보험 비할당	법무 보류에 대한 항목 할당을 제거합니다.
	소송대비 자료보전(Legal Holds) 보험 업데이트	법무 관련 자료 보전 보험을 업데이트합니다.
메타데이터 관리	파일 ID로 파일에서 메타데이터 인스턴스 조회	지정된 파일 ID를 사용하여 파일의 메타데이터 인스턴스를 검색합니다.
	범위 및 템플릿 키로 파일에서 메타데이터 인스턴스 조회	지정된 범위와 템플릿 키가 있는 폴더의 메타데이터 인스턴스를 검색합니다.
	폴더 ID로 폴더에서 메타데이터 인스턴스 조회	지정된 폴더 ID를 사용하여 폴더의 모든 메타데이터를 검색합니다. 주: 폴더 ID 값이 0인 루트 폴더에서는 이 작업을 사용하지 마십시오.
	범위 및 템플릿 키로 폴더에서 메타데이터 인스턴스 조회	지정된 범위와 템플릿 키를 사용하여 폴더의 모든 메타데이터를 검색합니다.
	메타데이터 스트림으로 파일 또는 폴더 쿼리	SQL 같은 구문을 사용하여 파일 또는 폴더를 검색하고 일치하는 결과를 반환합니다.
보존 보험 관리	유지 보험 할당	항목에 보존 보험을 할당합니다.
	유지 보험 작성	유지 보험을 작성합니다.
	보존 보험 조회	엔터프라이즈의 모든 보존 보험을 조회합니다.
	ID로 보존 보험 할당 조회	지정된 ID의 보존 보험을 조회합니다.
	보존 보험 할당 스트림 조회	지정된 보존 보험과 연결된 모든 보존 보험 할당의 목록을 반환합니다.
	ID로 보존 보험 조회	지정된 ID의 보존 보험을 조회합니다.
	유지 보험 업데이트	유지 보험을 업데이트합니다.
사용자 관리	그룹에 사용자 추가	Box의 지정된 그룹에 지정된 사용자를 추가합니다.
	사용자 작성	Box에서 사용자 계정을 작성합니다.
	사용자 제거	Box에서 지정된 사용자를 삭제합니다.
	사용자 비사용	Box에서 지정된 사용자의 상태를 비활성으로 설정합니다.
	사용자 사용	Box에서 지정된 사용자의 상태를 활성으로 설정합니다.
	사용자 ID 조회	Box에서 지정된 사용자의 ID를 조회합니다.
	사용자를 업데이트합니다	지정된 역할이 변경된 Box에서 지정된 사용자를 업데이트합니다.
웹후크 관리	웹후크 작성	웹후크를 작성합니다.
	ID로 웹후크 조회	지정된 ID로 웹후크를 검색합니다.
	웹후크 스트림 조회	지정된 애플리케이션에 대해 정의된 모든 웹후크를 검색합니다.
	웹후크 제거	웹후크를 제거합니다.
	웹후크 업데이트	웹후크를 업데이트합니다.

사용 가능한 AI 에이전트

사용 가능한 AI 에이전트를 통합 허브 설치 Now Assist 하고 사용합니다. 자세한 내용은 통합 허브에 대한 Now Assist 문서를 참조하십시오.

이 스포크는 인간과 유사한 인텔리전스를 모방하여 인스턴스에서 작업을 ServiceNow 수행하는 독립 실행형 AI 에이전트를 제공합니다.

ServiceNow 에이전트 시스템에서는 목표를 실행하기 위한 하나 이상의 독립 실행형 AI 에이전트와 함께 대규모 언어 모델(LLM) 지침 세트로 구성된 에이전트 워크플로우를 생성할 수 있습니다. 요구 사항에 따라 에이전트 워크플로우를 생성하고 필요한 트리거를 제공하기 위해 AI 에이전트를 추가하는 방법에 대한 자세한 내용은 을 참조하십시오 .
사용 가능한 다른 AI 에이전트를 검색하고 에이전트 워크플로우에 추가할 수도 있습니다. 자세한 내용은 Find AI agents 문서를 참조하십시오.
필요한 스포크 AI 에이전트의 클론을 생성하고 요구 사항에 따라 사용자 지정할 수 있습니다. 클론 생성에 대한 자세한 내용은 을 참조하십시오 .
AI 에이전트에 대한 자세한 내용은 을 참조하십시오 .

사용 가능한 AI 에이전트는 다음과 같습니다.


AI 에이전트	설명
Box 사용자 관리 AI 에이전트	Box에서 사용자 관리 작업(즉, 그룹에 사용자 추가, 사용자 활성화, 사용자 생성, 사용자 삭제, 사용자 업데이트, 사용자 ID 조회, 사용자 비활성화)을 관리합니다.
Box 폴더 관리 AI 에이전트	Box에서 폴더 관리 작업(즉, 폴더 생성, 폴더 ID 조회, 폴더 삭제)을 관리합니다.
Box 문서 공유 AI 에이전트	Box에서 문서 공유 작업(즉, 공동 작업자 제거, 공동 작업자 추가, 공유 링크 생성, ID로 폴더 공동 작업자 조회)을 관리합니다.
Box 그룹 관리 AI 에이전트	Box에서 그룹 관리 작업(즉, 그룹 업데이트, 그룹 생성, 그룹 삭제)을 관리합니다.
Box 메타데이터 관리 AI 에이전트	Box에서 메타데이터 검색 작업(즉, 범위 및 템플릿 키로 파일에서 메타데이터 인스턴스 조회, 폴더 ID로 폴더에서 메타데이터 인스턴스 조회, 범위 및 템플릿 키로 폴더에서 메타데이터 인스턴스 조회, 파일 ID로 파일에서 메타데이터 인스턴스 조회)을 관리합니다.
Box 보존 정책 관리 AI 에이전트	Box에서 보존 정책 관리 작업(즉, 보존 정책 업데이트, 보존 정책 스트림 조회, ID로 보존 정책 할당 조회, ID로 보존 정책 조회, 보존 정책 할당 스트림 조회)을 관리합니다.
Box 문서 관리 AI 에이전트	Box에서 문서 관리 작업(파일 제거, 기록에 box 파일 첨부, 파일 업로드, 소유한 항목 이동, 콘텐츠 스트림 검색, 파일 ID 조회, 파일에 메타데이터 추가)을 관리합니다.
Box 법무 자료보전 관리 AI 에이전트	Box에서 법무 보류 관리 작업(즉, 법무 보전 보험 생성, ID로 법무 보류 보험 할당 조회, 법무 보전 보험 업데이트, 모든 법무 보류 보험 스트림 조회, ID로 법무 보전 보험 조회, 법무 보전 보험 할당 해제, 법무 보전 보험 제거, 법무 보류 보험 할당 스트림 조회)을 Box에서 관리합니다.

애플리케이션과 함께 Now Assist 설치된 AI 에이전트 중에 에이전틱 워크플로우에 사용되지 않을 수 있습니다. 사용할 수 있는 모든 에이전트를 보는 방법을 알아보려면 AI 에이전트 찾기를 참조하세요.

주:

AI 에이전트를 실행하는 사용자에게 AI 에이전트와 연결된 테이블의 데이터에 액세스하거나 데이터에 대한 작업을 수행하는 데 필요한 역할과 권한이 있는지 확인합니다.

스포크 트리거

ServiceNow 는 트리거를 생성하는 Box의 특정 이벤트를 지원합니다. 먼저 지원되는 트리거 정의를 사용하여 플로우를 구성해야 합니다. 푸시 요청과 같은 이벤트가 Box에서 발생하면 웹후크를 통해 페이로드를 인스턴스로 ServiceNow 보냅니다. 이후에는 구성한 플로우가 인스턴스에서 트리거 ServiceNow 되어 워크플로우를 자동화합니다. 지원되는 이벤트는 다음과 같습니다.


범주	트리거	설명
파일 관리	파일이 다운로드됨	파일이 다운로드되면 플로우가 트리거됩니다.
	파일이 잠겨 있음	파일이 잠겨 있으면 플로우가 트리거됩니다.
	파일 이동됨	파일이 이동되면 플로우가 트리거됩니다.
	파일 이름 변경됨	파일의 이름이 바뀌면 플로우가 트리거됩니다.
	파일 잠금이 해제됨	파일의 잠금이 해제되면 플로우가 트리거됩니다.
	파일 업로드됨	파일이 업로드될 때 플로우가 트리거됩니다.
폴더 관리	폴더 작성됨	폴더가 생성되면 플로우가 트리거됩니다.
	폴더 다운로드됨	폴더가 다운로드되면 플로우가 트리거됩니다.
	폴더 이동됨	폴더가 이동되면 플로우가 트리거됩니다.
	폴더 이름 변경됨	폴더 이름이 변경되면 플로우가 트리거됩니다.

Box 스포크에 대한 트리거 설정에 대한 자세한 내용은 다음 문서를 참조하십시오 Box 스포크에 대한 트리거 설정. 인바운드 통합에 대한 자세한 내용은 다음 문서를 참조하십시오 조건부 및 이벤트 기반 인바운드 통합.

스포크 사용자 역할

스포크에서 사용할 수 있는 사용자 역할은 다음과 같습니다.

정책 사용자(sn_box_spoke.box_policies_user): 이 역할이 있는 사용자는 보존 정책 모듈에만 액세스할 수 있습니다.
법무 자료보전 정책 사용자(sn_box_spoke.legal_hold_policy_user): 이 역할이 있는 사용자는 법무 자료보전 정책 모듈에만 액세스할 수 있습니다.
Box 웹후크 레지스트리 사용자(sn_box_spoke.box_webhook_registry_user): 이 역할을 가진 사용자는 Box 웹후크 레지스트리 모듈에만 액세스할 수 있습니다.

Box 스포크 모듈

필요한 이벤트에 대한 알림을 받도록 양방향 웹후크를 설정할 수 있습니다. 웹후크 레지스트리는 ServiceNow 앱에 알리기 위해 충족해야 하는 조건을 정의합니다. 이러한 조건은 알림을 받으려는 Box의 이벤트를 기반으로 합니다. 조건이 충족되면 지정된 트리거 이름이 연결된 하위 플로우를 트리거하여 Box 작업을 자동화합니다.

웹후크는 별도의 설정이 필요하며 스포크 작업을 사용하지 않고 독립적으로 사용할 수 있습니다. Box 스포크는 인스턴스에 Box 스포크 애플리케이션을 추가하며 다음 모듈을 포함합니다.

표 1. Box 모듈
모듈	설명
Box 웹후크 레지스트리	ServiceNow에서 Box 웹후크를 생성하고 봅니다.
법무 자료보전 정책	사용 가능한 Box 법무 정책 목록을 봅니다.
유지 정책	사용 가능한 Box 보존 정책 목록을 봅니다.

Box 계정 요구 사항

Box 스포크 OAuth 2.0 토큰을 생성하려면 Box 계정에 사용자 지정 앱을 만들어야 합니다. OAuth 애플리케이션 생성 문서를 참조하십시오.

연결 및 자격 증명 별칭 요구 사항

통합 허브 는 별칭을 사용하여 연결 및 자격 증명 정보와 OAuth 자격 증명을 관리합니다. 별칭을 사용하면 여러 환경을 사용할 때 여러 자격 증명과 연결 정보 프로파일을 구성하지 않아도 됩니다. 연결 또는 자격 증명 정보가 변경되면 연결을 사용하는 작업을 업데이트할 필요가 없습니다.

이 스포크는 다음 별칭 기록을 사용하여 작업을 승인합니다.


연결 및 자격 증명 별칭	설명	연결 별칭 요구 사항
상자	Box 공동 작업 및 파일 관리 API에 대한 연결입니다.	연결 유형: HTTP 연결 URL: https://api.box.com
Box 업로드	Box 업로드 서비스에 연결합니다.	연결 유형: HTTP 연결 URL: https://upload.box.com

스포크 연결 별칭을 사용하려면 각 별칭에 대해 연결된 연결 기록과 연결된 자격 증명 기록을 생성합니다. 스포크 설정에 대한 자세한 내용은 다음 문서를 참조하십시오 Box 스포크 설정.