기관 관리자는 특정 이벤트가 발생했을 때 알림을 받도록 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 Server 및 Workflow Manager 웹후크 생성에 대한 자세한 내용은 ArcGIS Notebooks로 워크플로 자동화 및 웹후크로 작업 생성을 각각 참고하세요.
- 호스팅 피처 서비스에 대한 웹후크를 구성하려면 서비스에 편집 기능이 포함되어야 하며 동기화 없이 변경 추적이 활성화되어 있어야 합니다.
- 호스팅되지 않은 피처 서비스에 대한 웹후크를 구성하려면 서비스가 참조하는 엔터프라이즈 지오데이터베이스 데이터가 변경 추적 요구사항을 충족하고 다음 패턴 중 하나를 따라야 합니다.
- 아카이브가 활성화되고 Global ID가 있는 버전이 등록되지 않은 피처 서비스.
- 버전 관리 기능이 활성화되지 않은 분기 버전 등록된 피처 서비스. 편집 내용이 기본 버전의 피처에 직접 적용됩니다.
- 버전 관리 기능이 활성화된 분기 버전 등록된 피처 서비스. 버전 관리 기능을 활성화하는 경우 서비스는 서비스에서 게시 작업이 수행될 때마다 웹후크를 호출하는 FeaturesPosted 이벤트 트리거가 있는 웹후크를 생성할 수 있습니다.
비고:
분기 버전 등록된 피처 서비스에 대한 지원이 ArcGIS Enterprise 11.3에 추가되었습니다.
- 지오프로세싱 서비스에 대한 웹후크를 구성하려면 서비스가 비동기식이어야 합니다.
기관 웹후크 구성
기관 웹후크를 사용하면 ArcGIS Enterprise portal 항목, 그룹, 사용자와 연결된 이벤트 트리거를 구독할 수 있습니다.
기관 웹후크 생성
ArcGIS Enterprise portal 웹사이트를 통해 기관 웹후크를 생성하려면 다음 단계를 따릅니다.
- 기본 Administrator 또는 기관 웹후크 권한이 있는 사용자 설정 역할의 구성원으로 로그인했는지 확인합니다.
- 기관 > 설정 > 웹후크로 이동합니다.
- 기관 웹후크에서 웹후크 생성을 클릭합니다.
- 웹후크 생성 창에서 다음을 수행합니다.
- 이름 텍스트 상자에 웹후크의 고유한 이름을 입력합니다.
- 유형 드롭다운 메뉴에서 웹후크 유형을 선택합니다.
- 모두를 선택하면 지원되는 모든 이벤트 트리거를 구독하게 됩니다. 발생하는 각 이벤트에 대한 알림을 받게 됩니다.
- 항목, 사용자, 그룹 또는 역할을 선택하면 구독하려는 이벤트 트리거를 수동으로 정의할 수 있습니다.
- 모두 이외의 웹후크 유형을 선택하면 선택한 웹후크 유형에 따라 추가 드롭다운 메뉴가 나타납니다. 예를 들어 웹후크 유형으로 항목을 선택한 경우 항목 드롭다운 메뉴가 나타나며 이를 통해 웹후크에서 모니터링할 특정 항목을 선택할 수 있습니다.
- 이벤트 드롭다운 메뉴에서 이벤트 트리거를 선택합니다. 예를 들어 특정 항목이 발행될 때 웹후크가 호출되도록 하려면 /items/<item ID>/publish를 선택합니다.
- 웹후크 수신기 유형을 선택합니다.
- 웹후크 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 항목을 소유하고 있어야 합니다.
- 웹후크 URL을 선택하는 경우 웹후크 수신기에 대한 페이로드 URL을 입력합니다. 페이로드 URL 예시는 다음과 같습니다.
- 필요에 따라 암호(선택 사항) 텍스트 상자에 웹후크에 대한 암호 값을 설정합니다. 암호 값은 웹후크 페이로드 헤더에 포함될 시그니처를 생성하는 데 사용됩니다. 웹후크 수신기는 이 시그니처를 사용하여 메시지를 신뢰할지 여부를 결정할 수 있습니다.
- 웹후크 생성을 클릭합니다.
기관 웹후크에 대한 고급 매개변수 구성
기관의 웹후크에 적용된 고급 설정을 사용하면 전달 시도 횟수, 알림 시간, 전달 시도 간격 지정과 같은 웹후크의 성능을 추가로 사용자 정의할 수 있습니다.
ArcGIS Enterprise portal 웹사이트를 통해 고급 등록정보를 설정하려면 다음을 수행합니다.
- 기본 Administrator 또는 기관 웹후크 권한이 있는 사용자 설정 역할의 구성원으로 기관에 로그인합니다.
- 기관 > 설정 > 웹후크로 이동합니다.
- 기관 웹후크에서 고급 웹후크 설정을 클릭합니다.
- 고급 웹후크 설정 창에서 다음을 수행합니다.
- 전달 시도 횟수 값을 설정합니다.
해당 값은 웹후크 페이로드를 전달하기 위해 시도할 횟수를 지정합니다. 기본 설정에 따라 ArcGIS Enterprise portal은 페이로드 전달을 3번 시도합니다. 시도 값은 0과 5 사이의 정수여야 합니다.
- 알림 제한 시간 값을 설정합니다.
해당 값은 ArcGIS Enterprise portal이 수신기로부터 응답을 수신하기 위해 대기할 시간(초)을 지정합니다. 기본 설정에 따라 ArcGIS Enterprise portal은 10초 대기합니다. ArcGIS Enterprise portal이 대기할 시간(초) 값은 0과 60초 사이의 정수여야 합니다.
- 알림 경과 시간 값을 설정합니다.
해당 값은 각 페이로드 전달 시도 간 시간(초)을 지정합니다. 기본 설정에 따라 ArcGIS Enterprise portal은 이전 시도가 실패한 경우 5초 후에 전달 시도 횟수에 지정된 시도 횟수에 도달할 때까지 다른 페이로드 전달을 시도합니다.
- 전달 시도 횟수 값을 설정합니다.
- 위의 설정이 구성되면 저장을 클릭합니다.
업데이트된 등록정보가 구성된 모든 기관 웹후크에 적용됩니다.
서비스 웹후크 구성
서비스 웹후크를 사용하면 기관의 피처 서비스와 관련된 이벤트 또는 지오프로세싱 서비스 작업이 완료될 때 트리거를 구독할 수 있습니다.
서비스 웹후크 생성
지오프로세싱 서비스 또는 피처 서비스의 웹후크를 생성하려면 다음 단계를 따릅니다.
- 기본 관리자 또는 서비스 웹후크를 생성 및 관리할 수 있는 관리 권한이 있는 사용자 설정 역할의 구성원으로 기관에 로그인합니다.
비고:
Publisher 역할이 할당된 구성원은 ArcGIS Enterprise portal 사이트에서 서비스 웹후크를 생성하거나 관리할 수 없으며 관리 API를 사용하는 해당 워크플로를 수행해야 합니다. - 기관 > 설정 > 웹후크로 이동합니다.
- 서비스 웹후크에서 웹후크 생성을 클릭합니다.
- 웹후크 생성 창에서 다음을 수행합니다.
- 이름 텍스트 상자에 웹후크의 고유한 이름을 입력합니다.
- 서비스 드롭다운 메뉴에서 서비스를 선택합니다.
비고:
지오프로세싱 서비스를 선택하면 이벤트가 서비스 완료로 설정됩니다. 피처 서비스를 선택하면 이벤트 드롭다운 메뉴가 활성화됩니다.
- 피처 서비스 웹후크를 선택하는 경우 이벤트 드롭다운 메뉴에서 이벤트 트리거를 선택합니다. 예를 들어 편집에 새 첨부 파일이 포함될 때 웹후크가 호출되도록 하려면 AttachmentsCreated를 선택합니다.
- 웹후크 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
- 필요에 따라 암호(선택 사항) 텍스트 상자에 웹후크에 대한 암호 값을 설정합니다. 암호 값은 웹후크 페이로드 헤더에 포함될 시그니처를 생성하는 데 사용됩니다. 웹후크 수신기는 이 시그니처를 사용하여 메시지를 신뢰할지 여부를 결정할 수 있습니다.
- 웹후크 생성을 클릭합니다.
서비스 웹후크에 대한 고급 매개변수 구성
서비스 웹후크에 적용된 고급 설정을 사용하면 전달 시도 횟수, 알림 시간, 전달 시도 간 시간 지정과 같은 웹후크의 성능을 추가로 사용자 정의할 수 있습니다.
ArcGIS Enterprise portal 웹사이트를 통해 고급 등록정보를 설정하려면 다음을 수행합니다.
- 기본 관리자 또는 서비스 웹후크를 생성 및 관리할 수 있는 관리 권한이 있는 사용자 설정 역할의 구성원으로 기관에 로그인합니다.
비고:
Publisher 역할이 할당된 구성원은 ArcGIS Enterprise portal 사이트에서 서비스 웹후크를 생성하거나 관리할 수 없으며 관리 API를 사용하는 해당 워크플로를 수행해야 합니다. - 기관 > 설정 > 웹후크로 이동합니다.
- 서비스 웹후크에서 고급 웹후크 설정을 클릭합니다.
- 고급 웹후크 설정 창에서 다음을 수행합니다.
- 전달 시도 횟수 값을 설정합니다.
해당 값은 웹후크 페이로드를 전달하기 위해 시도할 횟수를 지정합니다. 기본 설정에 따라 시스템은 페이로드 전달을 3번 시도합니다. 시도 값은 0과 5 사이의 정수여야 합니다.
- 알림 제한 시간 값을 설정합니다.
해당 값은 시스템이 수신기로부터 응답을 수신하기 위해 대기할 시간(초)을 지정합니다. 기본 설정에 따라 시스템은 10초 대기합니다. 값은 0과 60초 사이의 정수여야 합니다.
- 알림 경과 시간 값을 설정합니다.
해당 값은 각 페이로드 전달 시도 간 시간(초)을 지정합니다. 기본 설정에 따라 시스템은 이전 시도가 실패한 경우 5초 후에 전달 시도 횟수에 지정된 시도 횟수에 도달할 때까지 다른 페이로드 전달을 시도합니다.
- 지난 일수 값을 설정합니다.
이 값은 웹후크가 비활성화되기 전에 특정 횟수의 실패가 발생할 수 있는 일수를 지정합니다. 기본 설정에 따라 시스템은 5일 동안 특정 횟수의 실패(최대 실패 횟수에 지정됨)를 허용합니다. 값은 1과 30 사이의 정수여야 합니다.
- 최대 실패 횟수 값을 설정합니다.
이 값은 웹후크가 비활성화되기 전에 특정 일수 동안 발생할 수 있는 실패 횟수를 지정합니다. 기본 설정에 따라 시스템은 웹후크가 비활성화되기 전에 특정 일수 동안(지난 일수에 지정됨) 5번의 실패를 허용합니다. 값은 1과 30 사이의 정수여야 합니다.
- 전달 시도 횟수 값을 설정합니다.
- 위의 설정이 구성되면 저장을 클릭합니다.
업데이트된 등록정보가 구성된 모든 서비스 웹후크에 적용됩니다.