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

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 2분
  • ServiceNow 콜백 URL로 Box를 구독하도록 웹후크를 구성합니다.

    시작하기 전에

    • 통합 허브 구독을 요청합니다.
    • Box 스포크를 활성화합니다.
    • 필요한 역할: admin.

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

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

    시작하기 전에

    필요한 역할: 관리자

    프로시저

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

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

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

        필드

        이름

        Chatter 피드 업데이트

        설명

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

        이벤트 유형

        하나 이상의 옵션 사용

        엔드포인트 URL

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

        페이로드 형식

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

        콜백 매개변수

        콜백 매개변수 추가를 선택하여 GET 또는 POST 메서드를 구성합니다.

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

    결과

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

    ServiceNow에 Box 웹후크 등록

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

    시작하기 전에

    필요한 역할: admin.

    프로시저

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

      필드

      이름

      필요에 따라 웹후크 레지스트리의 이름을 지정합니다

      트리거 이름

      적절한 이벤트 트리거 선택

      기본 키

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

      플로우 이름

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

      보조 키

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

      설명

      선택적으로 기록의 목적을 설명하십시오.

    4. 확인하려면 제출을 선택합니다.

    결과

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