웹후크는 서비스에 영향을 미치는 특정 이벤트가 발생하는 경우 정보를 전송합니다. ArcGIS Online에서 호스팅 피처 레이어, 호스팅 피처 레이어 뷰, 호스팅 테이블을 채우는 피처 서비스의 웹후크를 생성하고, 웹후크가 호출되는 이벤트를 정의할 수 있습니다.
웹후크를 생성하거나 관리하려면 항목에 데이터 변경 사항 추적(피처 추가, 업데이트, 삭제) 편집 설정이 활성화되어 있어야 합니다.
웹후크 생성
호스팅 피처 레이어, 호스팅 피처 레이어 뷰, 호스팅 테이블의 웹후크를 생성하여 해당 항목의 작업 자동화를 알리거나 지원할 수 있는 트리거와 메시징을 사용할 수 있습니다.
웹후크를 지원하는 인프라는 ArcGIS 외부에 구성되어 있습니다. 웹후크를 생성하기 전에 구성해야 하는 사항 및 웹후크를 생성하는 데 필요한 권한에 대한 자세한 내용은 ArcGIS Online의 웹후크를 참고하세요.
호스팅 피처 레이어, 호스팅 피처 레이어 뷰, 호스팅 테이블의 웹후크를 생성하려면 다음 단계를 완료합니다.
- 기관에 로그인합니다.
- 호스팅 피처 레이어, 뷰, 테이블의 항목 페이지를 여세요.
- 설정 탭을 클릭합니다.
- 웹후크 섹션으로 스크롤하여 웹후크 생성을 클릭합니다.
웹후크 생성 버튼이 비활성화된 경우 레이어에 데이터 변경 사항 추적(피처 추가, 업데이트, 삭제) 옵션이 활성화되지 않을 수 있습니다.
뷰의 경우 소스 호스팅 피처 레이어에서 데이터 변경 사항 추적(피처 추가, 업데이트, 삭제) 옵션을 활성화해야 합니다.
- 웹후크 이름을 입력하세요.
- 이벤트 메뉴를 확장하고 웹후크를 트리거할 모든 이벤트 체크 박스를 선택하세요.
- 웹후크 수신기 URL 텍스트 상자에 웹후크 수신기의 URL을 입력하세요.
웹후크 수신기는 이미 있어야 하며, 보안 HTTPS 연결을 통해 통신하도록 구성되어 있어야 합니다.
- 필요한 경우 보안을 강화화기 위해 시크릿 키를 제공하세요.
웹후크에 시크릿 키를 제공하기 전에 웹후크 수신기에서 시크릿 키를 구성해야 합니다.
- 웹후크 이름을 입력하세요.
웹후크가 이 항목의 웹후크 목록에 표시됩니다.
웹후크 관리
항목 페이지의 설정 탭에서 웹후크를 관리할 수 있습니다.
항목 소유자는 내 설정에서 소유 중인 모든 웹후크에 접근하고 관리할 수도 있습니다.
팁:
기관 관리자는 기관 > 설정 > 웹후크 탭에서 기관의 모든 웹후크에 접근하고 관리할 수 있습니다. 자세한 내용은 기관 전체에서 웹후크 관리를 참조하세요.
호스팅 피처 레이어, 호스팅 피처 레이어 뷰, 호스팅 테이블과 관련된 웹후크 관리에는 다음이 포함됩니다.
- 웹후크 비활성화 또는 활성화 — 웹후크가 비활성 상태인 경우 웹후크를 트리거하도록 정의된 이벤트가 발생해도 웹후크가 실행되지 않습니다. 자동 업데이트를 수행하는 동안 수신함이 메시지로 가득 채워지는 일을 방지하기 위해 레이어의 모든 웹후크를 일시적으로 비활성화할 수 있습니다. 또는 가능한 모든 이벤트로 실행되는 하나의 웹후크를 일시적으로 비활성화하고, 단일 트리거로 실행되는 다른 웹후크를 활성화하여 해당 이벤트에 일시적으로 집중할 수 있습니다.
- 웹후크 편집 — 웹후크 설정을 변경할 수 있습니다. 예를 들어 시크릿 키를 추가하거나 웹후크를 실행시키는 이벤트 트리거를 변경할 수 있습니다.
- 웹후크 삭제 — 웹후크가 더 이상 필요하지 않은 경우에는 삭제할 수 있습니다.
비고:
웹후크는 즉시 삭제됩니다. 휴지통으로 이동하지 않습니다.
항목 페이지에서 웹후크 관리
호스팅 피처 레이어, 호스팅 피처 레이어 뷰, 연관된 호스팅 테이블의 항목 페이지에서 웹후크를 관리하려면 다음 단계를 완료합니다.
- 기관에 로그인합니다.
- 호스팅 피처 레이어, 뷰, 테이블의 항목 페이지를 여세요.
- 설정 탭을 클릭하고 웹후크 섹션으로 스크롤합니다.
이 항목과 연관된 모든 웹후크가 여기에 나열됩니다.
- 다음 관리 작업 중 하나를 수행하세요.
- 웹후크를 비활성화하려면 웹후크 이름 옆에 있는 토글 버튼을 비활성화하세요.
- 웹후크를 활성화하려면 웹후크 이름 옆에 있는 토글 버튼을 활성화하세요.
- 웹후크 설정을 편집하려면 웹후크 이름 옆에 있는 옵션 버튼
을 클릭하고 편집을 클릭하세요. 웹후크의 이름, 이벤트, 웹후크 수신기 URL 또는 시크릿 키를 변경하고 웹후크 업데이트를 클릭하세요. - 웹후크를 삭제하려면 웹후크 이름 옆에 있는 옵션 버튼 을 클릭하고 삭제를 클릭하세요. 확인 메시지가 표시되면 삭제를 클릭하세요.
내 설정에서 웹후크 관리
내 설정에서 웹후크를 관리하려면 다음 단계를 완료합니다.
- 기관에 로그인합니다.
- 사이트 상단에서 구성원 이름을 클릭한 다음 내 설정을 클릭하세요.
- 웹후크 탭을 클릭하세요.
- 다음 관리 작업 중 하나를 수행하세요.
- 웹후크를 비활성화하려면 웹후크 이름 옆에 있는 토글 버튼을 비활성화하세요.
- 웹후크를 활성화하려면 웹후크 이름 옆에 있는 토글 버튼을 활성화하세요.
- 웹후크 설정을 편집하려면 웹후크 이름 옆에 있는 옵션 버튼 을 클릭하고 편집을 클릭하세요. 웹후크의 이름, 이벤트, 웹후크 수신기 URL 또는 시크릿 키를 변경하고 웹후크 업데이트를 클릭하세요.
- 웹후크를 삭제하려면 웹후크 이름 옆에 있는 옵션 버튼 을 클릭하고 삭제를 클릭하세요. 확인 메시지가 표시되면 삭제를 클릭하세요.