Box 스포크에 대한 양방향 웹후크 설정

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 3분

    • ServiceNow 콜백 URL을 사용하여 Box를 구독하도록 웹후크를 구성합니다.

    시작하기 전에

    • 통합 허브 Professional 구독 요청
    • Box 스포크 활성화
    • 필요한 역할: admin

    Box 계정에 엔드포인트 URL 추가

    Box 계정에서 엔드포인트 URL을 지정하여 Box 스포크에 대한 웹후크를 생성합니다.

    시작하기 전에

    필요한 역할: admin

    프로시저

    1. Box 개발자 콘솔에 로그인합니다.
    2. 요구 사항에 따라 앱을 만듭니다.

      앱 생성에 대한 자세한 내용은 을 참조하십시오 OAuth 애플리케이션 생성.

    3. 앱의 기본 키와 보조 키를 생성하고 값을 기록합니다.
      1. My Apps(내 앱)에서 애플리케이션을 선택합니다.
        애플리케이션의 일반 설정에 있습니다.
      2. 웹후크로 이동합니다.
      3. 서명 키 관리를 선택합니다.
      4. 기본 키 섹션에서 키 생성을 선택합니다.
      5. Secondary Key(보조 키) 섹션에서 Generate Key(키 생성)를 선택합니다.
      6. 나중을 위해 두 키 값을 모두 복사하여 저장합니다.
    4. 웹후크 섹션으로 이동합니다.
    5. V1 웹후크를 만들려면 웹후크 만들기 를 선택하고 V1을 선택합니다.
      1. 필드를 완성합니다.

        필드

        값

        이름

        Chatter 피드 업데이트

        설명

        변경 사항이 발생하면 Chatter 피드를 자동으로 업데이트합니다.

        이벤트 유형

        		 하나 이상의 옵션 사용

        엔드포인트 URL

        인스턴스의 ServiceNow 엔드포인트 URL은 https://<instance-name>.service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint 형식입니다.

        페이로드 형식

        적절한 페이로드 데이터 형식 선택

        콜백 매개변수

        콜백 매개변수 추가를 선택하여 GET 또는 POST 메서드를 구성합니다.
      2. Webhoook 저장을 선택합니다.
    6. V2 웹후크를 만들려면 웹후크 만들기 를 선택하고 V2를 선택합니다.
      주:
      V2 웹후크를 만들려면 구성 설정에서 웹후크 관리를 사용하도록 설정해야 합니다. 자세한 내용은 OAuth 애플리케이션 생성 문서를 참조하십시오.
      1. URL 주소에 인스턴스의 ServiceNow 엔드포인트 URL을 https://<instance-name>.service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint 형식으로 입력합니다.
      2. 웹후크를 트리거할 항목 유형(The type of item to trigger a webhook)에서 항목 선택(Choose an item)을 선택합니다.
      3. 웹후크 구성 파일 또는 폴더를 선택합니다.
      4. 확인하려면 선택을 선택합니다.
        구성된 웹후크 트리거 목록이 웹후크 생성 페이지에 표시됩니다.
      5. 각 트리거에 대해 적절한 GET 및 POST 메서드를 사용하도록 설정합니다.
      6. 확인하려면 웹후크 만들기를 선택합니다.

    결과

    엔드포인트 URL이 Box 계정에 추가됩니다. 요구 사항에 따라 웹후크 레지스트리와 하위 플로우를 생성할 수 있습니다.

    ServiceNow에 Box 웹후크 등록

    ServiceNow에서 Box 웹후크 레지스트리를 생성하여 Box 계정에서 특정 이벤트가 발생할 때 ServiceNow 앱에 알립니다.

    시작하기 전에

    필요한 역할: admin.

    프로시저

    1. 에서 ServiceNow다음으로 이동합니다. 모두 > 상자 > Box 웹후크 레지스트리.
    2. 새로 만들기를 선택합니다.
    3. 필드에 내용을 입력합니다.

      필드

      값

      이름

      필요한 경우 웹후크 레지스트리의 이름을 지정합니다

      트리거 이름

      적절한 이벤트 트리거 선택

      기본 키

      에서 생성한 기본 키 Box 계정에 엔드포인트 URL 추가

      플로우 이름

      이벤트가 트리거될 때 발생하는 플로우

      보조 키

      에서 생성한 보조 키 Box 계정에 엔드포인트 URL 추가

      설명

      선택적으로 기록의 목적을 설명합니다.
    4. 확인하려면 제출을 선택합니다.

    결과

    Box 웹후크가 ServiceNow 인스턴스에 등록됩니다.