Skip To Content

웹후크 생성

ArcGIS 11.4 (Windows)  | |  도움말 아카이브

기관 관리자는 특정 이벤트가 발생했을 때 알림을 받도록 ArcGIS Enterprise 배포용 웹후크를 구성할 수 있습니다. 기관 및 서비스 웹후크를 구성하는 방법은 다음 섹션에 나와 있습니다.

웹후크 생성을 위한 필수 구성 요소

웹후크를 생성하기 전에 다음을 검토하세요.

  • 기관 웹후크를 사용하려면 기관에서 ArcGIS Enterprise 10.7 이후 버전을 사용 중이어야 합니다. 서비스 웹후크를 사용하려면 기관에서 ArcGIS Enterprise 11.0 이후 버전을 사용 중이어야 합니다.
  • 기관 웹후크를 생성하고 관리하려면 기관 웹후크 권한이나 기본 Administrator 역할을 할당받아야 합니다.
  • 지오프로세싱 서비스 웹후크를 생성하고 관리하려면 지오프로세싱 권한이나 기본 Administrator 역할을 할당받아야 합니다.
    비고:

    지오프로세싱 권한이 할당된 사용자는 사용자 설정 역할에 서버 기반 레이어 발행 권한이 추가되어야 합니다.

  • 피처 서비스 웹후크를 생성하고 관리하려면 피처 레이어 권한이나 기본 Administrator 역할을 할당받아야 합니다.
  • 웹후크 수신기는 HTTPS를 통해 통신하도록 구성되어야 합니다. 수신기에 지원되는 몇 가지 옵션으로는 서드 파티 웹 서비스 수신기(Microsoft Power Automate, Zapier, IFFT), 사용자 설정 웹 서비스, ArcGIS Notebook Server, ArcGIS Workflow Manager 등이 있습니다. 사용자 설정 웹 서비스를 생성하거나 서드 파티 수신기를 사용하여 시작하는 방법에 대한 예시는 웹후크 저장소를 참고하세요. Notebook ServerWorkflow Manager 웹후크 생성에 대한 자세한 내용은 ArcGIS Notebooks로 워크플로 자동화웹후크로 작업 생성을 각각 참고하세요.
  • 호스팅 피처 서비스에 대한 웹후크를 구성하려면 서비스에 편집 기능이 포함되어야 하며 동기화 없이 변경 추적이 활성화되어 있어야 합니다.
  • 호스팅되지 않은 피처 서비스에 대한 웹후크를 구성하려면 서비스가 참조하는 엔터프라이즈 지오데이터베이스 데이터가 변경 추적 요구사항을 충족하고 다음 패턴 중 하나를 따라야 합니다.
    • 아카이브가 활성화되고 Global ID가 있는 버전이 등록되지 않은 피처 서비스.
    • 버전 관리 기능이 활성화되지 않은 분기 버전 등록된 피처 서비스. 편집 내용이 기본 버전의 피처에 직접 적용됩니다.
    • 버전 관리 기능이 활성화된 분기 버전 등록된 피처 서비스. 버전 관리 기능을 활성화하는 경우 서비스는 서비스에서 게시 작업이 수행될 때마다 웹후크를 호출하는 FeaturesPosted 이벤트 트리거가 있는 웹후크를 생성할 수 있습니다.
    비고:

    분기 버전 등록된 피처 서비스에 대한 지원이 ArcGIS Enterprise 11.3에 추가되었습니다.

  • 지오프로세싱 서비스에 대한 웹후크를 구성하려면 서비스가 비동기식이어야 합니다.

기관 웹후크 구성

기관 웹후크를 사용하면 ArcGIS Enterprise portal 항목, 그룹, 사용자와 연결된 이벤트 트리거를 구독할 수 있습니다.

기관 웹후크 생성

ArcGIS Enterprise portal 웹사이트를 통해 기관 웹후크를 생성하려면 다음 단계를 따릅니다.

  1. 기본 Administrator 또는 기관 웹후크 권한이 있는 사용자 설정 역할의 구성원으로 로그인했는지 확인합니다.
  2. 기관 > 설정 > 웹후크로 이동합니다.
  3. 기관 웹후크에서 웹후크 생성을 클릭합니다.
  4. 웹후크 생성 창에서 다음을 수행합니다.
    1. 이름 텍스트 상자에 웹후크의 고유한 이름을 입력합니다.
    2. 유형 드롭다운 메뉴에서 웹후크 유형을 선택합니다.
      • 모두를 선택하면 지원되는 모든 이벤트 트리거를 구독하게 됩니다. 발생하는 각 이벤트에 대한 알림을 받게 됩니다.
      • 항목, 사용자, 그룹 또는 역할을 선택하면 구독하려는 이벤트 트리거를 수동으로 정의할 수 있습니다.
    3. 모두 이외의 웹후크 유형을 선택하면 선택한 웹후크 유형에 따라 추가 드롭다운 메뉴가 나타납니다. 예를 들어 웹후크 유형으로 항목을 선택한 경우 항목 드롭다운 메뉴가 나타나며 이를 통해 웹후크에서 모니터링할 특정 항목을 선택할 수 있습니다.
    4. 이벤트 드롭다운 메뉴에서 이벤트 트리거를 선택합니다. 예를 들어 특정 항목이 발행될 때 웹후크가 호출되도록 하려면 /items/<item ID>/publish를 선택합니다.
    5. 웹후크 수신기 유형을 선택합니다.
      • 웹후크 URL을 선택하는 경우 웹후크 수신기에 대한 페이로드 URL을 입력합니다. 페이로드 URL 예시는 다음과 같습니다.
        https://app.logic.azure.com:443/workflows/b688528a36e246279dc050f936e5ebd4/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=nHP-LBo9x-nSgMi11DSDuwRIUiJr-8yKGCy7OYaT_ow
      • Notebook을 선택하는 경우 웹후크가 트리거될 때 실행할 Notebook을 선택합니다.
        비고:

        Notebook 옵션을 사용할 수 없는 경우 포털에 Notebook Server가 구성되지 않은 것입니다. 옵션이 제공되지만 선택할 수 없는 경우는 웹후크 구성에 적합한 Notebook을 소유하지 않은 것입니다. 웹후크에 사용될 Notebook 항목을 소유하고 있어야 합니다.

    6. 필요에 따라 암호(선택 사항) 텍스트 상자에 웹후크에 대한 암호 값을 설정합니다. 암호 값은 웹후크 페이로드 헤더에 포함될 시그니처를 생성하는 데 사용됩니다. 웹후크 수신기는 이 시그니처를 사용하여 메시지를 신뢰할지 여부를 결정할 수 있습니다.
  5. 웹후크 생성을 클릭합니다.

기관 웹후크에 대한 고급 매개변수 구성

기관의 웹후크에 적용된 고급 설정을 사용하면 전달 시도 횟수, 알림 시간, 전달 시도 간격 지정과 같은 웹후크의 성능을 추가로 사용자 정의할 수 있습니다.

ArcGIS Enterprise portal 웹사이트를 통해 고급 등록정보를 설정하려면 다음을 수행합니다.

  1. 기본 Administrator 또는 기관 웹후크 권한이 있는 사용자 설정 역할의 구성원으로 기관에 로그인합니다.
  2. 기관 > 설정 > 웹후크로 이동합니다.
  3. 기관 웹후크에서 고급 웹후크 설정을 클릭합니다.
  4. 고급 웹후크 설정 창에서 다음을 수행합니다.
    1. 전달 시도 횟수 값을 설정합니다.

      해당 값은 웹후크 페이로드를 전달하기 위해 시도할 횟수를 지정합니다. 기본 설정에 따라 ArcGIS Enterprise portal은 페이로드 전달을 3번 시도합니다. 시도 값은 0과 5 사이의 정수여야 합니다.

    2. 알림 제한 시간 값을 설정합니다.

      해당 값은 ArcGIS Enterprise portal이 수신기로부터 응답을 수신하기 위해 대기할 시간(초)을 지정합니다. 기본 설정에 따라 ArcGIS Enterprise portal은 10초 대기합니다. ArcGIS Enterprise portal이 대기할 시간(초) 값은 0과 60초 사이의 정수여야 합니다.

    3. 알림 경과 시간 값을 설정합니다.

      해당 값은 각 페이로드 전달 시도 간 시간(초)을 지정합니다. 기본 설정에 따라 ArcGIS Enterprise portal은 이전 시도가 실패한 경우 5초 후에 전달 시도 횟수에 지정된 시도 횟수에 도달할 때까지 다른 페이로드 전달을 시도합니다.

  5. 위의 설정이 구성되면 저장을 클릭합니다.

    업데이트된 등록정보가 구성된 모든 기관 웹후크에 적용됩니다.

서비스 웹후크 구성

서비스 웹후크를 사용하면 기관의 피처 서비스와 관련된 이벤트 또는 지오프로세싱 서비스 작업이 완료될 때 트리거를 구독할 수 있습니다.

서비스 웹후크 생성

지오프로세싱 서비스 또는 피처 서비스의 웹후크를 생성하려면 다음 단계를 따릅니다.

  1. 기본 관리자 또는 서비스 웹후크를 생성 및 관리할 수 있는 관리 권한이 있는 사용자 설정 역할의 구성원으로 기관에 로그인합니다.

    비고:
    Publisher 역할이 할당된 구성원은 ArcGIS Enterprise portal 사이트에서 서비스 웹후크를 생성하거나 관리할 수 없으며 관리 API를 사용하는 해당 워크플로를 수행해야 합니다.

  2. 기관 > 설정 > 웹후크로 이동합니다.
  3. 서비스 웹후크에서 웹후크 생성을 클릭합니다.
  4. 웹후크 생성 창에서 다음을 수행합니다.
    1. 이름 텍스트 상자에 웹후크의 고유한 이름을 입력합니다.
    2. 서비스 드롭다운 메뉴에서 서비스를 선택합니다.

      비고:

      지오프로세싱 서비스를 선택하면 이벤트가 서비스 완료로 설정됩니다. 피처 서비스를 선택하면 이벤트 드롭다운 메뉴가 활성화됩니다.

    3. 피처 서비스 웹후크를 선택하는 경우 이벤트 드롭다운 메뉴에서 이벤트 트리거를 선택합니다. 예를 들어 편집에 새 첨부 파일이 포함될 때 웹후크가 호출되도록 하려면 AttachmentsCreated를 선택합니다.
    4. 웹후크 URL 텍스트 상자에 웹후크 수신기에 대한 페이로드 URL을 입력합니다. 페이로드 URL 예시는 다음과 같습니다.
      https://app.logic.azure.com:443/workflows/b688528a36e246279dc050f936e5ebd4/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=nHP-LBo9x-nSgMi11DSDuwRIUiJr-8yKGCy7OYaT_ow
    5. 필요에 따라 암호(선택 사항) 텍스트 상자에 웹후크에 대한 암호 값을 설정합니다. 암호 값은 웹후크 페이로드 헤더에 포함될 시그니처를 생성하는 데 사용됩니다. 웹후크 수신기는 이 시그니처를 사용하여 메시지를 신뢰할지 여부를 결정할 수 있습니다.
  5. 웹후크 생성을 클릭합니다.

서비스 웹후크에 대한 고급 매개변수 구성

서비스 웹후크에 적용된 고급 설정을 사용하면 전달 시도 횟수, 알림 시간, 전달 시도 간 시간 지정과 같은 웹후크의 성능을 추가로 사용자 정의할 수 있습니다.

ArcGIS Enterprise portal 웹사이트를 통해 고급 등록정보를 설정하려면 다음을 수행합니다.

  1. 기본 관리자 또는 서비스 웹후크를 생성 및 관리할 수 있는 관리 권한이 있는 사용자 설정 역할의 구성원으로 기관에 로그인합니다.

    비고:
    Publisher 역할이 할당된 구성원은 ArcGIS Enterprise portal 사이트에서 서비스 웹후크를 생성하거나 관리할 수 없으며 관리 API를 사용하는 해당 워크플로를 수행해야 합니다.

  2. 기관 > 설정 > 웹후크로 이동합니다.
  3. 서비스 웹후크에서 고급 웹후크 설정을 클릭합니다.
  4. 고급 웹후크 설정 창에서 다음을 수행합니다.
    1. 전달 시도 횟수 값을 설정합니다.

      해당 값은 웹후크 페이로드를 전달하기 위해 시도할 횟수를 지정합니다. 기본 설정에 따라 시스템은 페이로드 전달을 3번 시도합니다. 시도 값은 0과 5 사이의 정수여야 합니다.

    2. 알림 제한 시간 값을 설정합니다.

      해당 값은 시스템이 수신기로부터 응답을 수신하기 위해 대기할 시간(초)을 지정합니다. 기본 설정에 따라 시스템은 10초 대기합니다. 값은 0과 60초 사이의 정수여야 합니다.

    3. 알림 경과 시간 값을 설정합니다.

      해당 값은 각 페이로드 전달 시도 간 시간(초)을 지정합니다. 기본 설정에 따라 시스템은 이전 시도가 실패한 경우 5초 후에 전달 시도 횟수에 지정된 시도 횟수에 도달할 때까지 다른 페이로드 전달을 시도합니다.

    4. 지난 일수 값을 설정합니다.

      이 값은 웹후크가 비활성화되기 전에 특정 횟수의 실패가 발생할 수 있는 일수를 지정합니다. 기본 설정에 따라 시스템은 5일 동안 특정 횟수의 실패(최대 실패 횟수에 지정됨)를 허용합니다. 값은 1과 30 사이의 정수여야 합니다.

    5. 최대 실패 횟수 값을 설정합니다.

      이 값은 웹후크가 비활성화되기 전에 특정 일수 동안 발생할 수 있는 실패 횟수를 지정합니다. 기본 설정에 따라 시스템은 웹후크가 비활성화되기 전에 특정 일수 동안(지난 일수에 지정됨) 5번의 실패를 허용합니다. 값은 1과 30 사이의 정수여야 합니다.

  5. 위의 설정이 구성되면 저장을 클릭합니다.

    업데이트된 등록정보가 구성된 모든 서비스 웹후크에 적용됩니다.