워크플로용 웹후크 만들기 및 관리

필수 웹후크 권한

Qlik Cloud Webhooks API 및 자동화 UI를 사용하여 웹후크를 만들거나 관리할 때 다음 권한 중 하나 또는 둘 다를 요청해야 합니다.

• 웹후크 사용: 사용자가 소유한 웹후크를 만들고, 보고, 업데이트하고, 삭제하는 데 필요합니다.

• 웹후크 관리: 다른 사용자가 만든 웹후크를 포함하여 테넌트의 모든 웹후크를 관리하는 데 필요합니다.

웹후크 작동 방식

Qlik Cloud에서 이벤트가 발생하면(예: 새 응용 프로그램이 만들어지거나 사용자가 삭제됨) 웹후크는 HTTP 콜백을 사용하여 지정된 외부 응용 프로그램에 JSON 형식으로 정보를 보냅니다. 그러면 이 외부 응용 프로그램은 이벤트 데이터를 사용하여 추가 작업을 트리거할 수 있습니다.

예:

• 새 응용 프로그램이 만들어지면 Slack을 통해 팀에 알립니다.

• 새 팀 구성원이 테넌트에 추가되면 환영 이메일을 자동으로 보냅니다.

• 테넌트에서 사용자가 삭제되면 스프레드시트를 업데이트합니다.

웹후크 사용의 이점

웹후크는 다른 시스템과의 실시간 통합을 허용하여 지속적인 수동 확인이나 반복적인 API 요청의 필요성을 없앱니다. 이벤트를 수신 대기하고 관련 데이터를 즉시 전송함으로써 웹후크는 불필요한 작업을 줄이고 원활한 자동화를 가능하게 합니다.

웹후크 통합에 널리 사용되는 플랫폼

웹후크 데이터를 처리하고 응답하기 위해 사용자 지정 서비스를 구축하거나 다음과 같은 타사 플랫폼을 사용할 수 있습니다.

• Qlik Automate (영어로만 제공)

• Pipedream

• Zapier

• Microsoft Power Automate

https://<your-tenantURL>/api/v1/webhooks/{id}

{
    "Content-Type": "application/json",
    "X-Execution-Token: <your-execution-token>",
    "Qlik-Signature": "446bd5e3f5b635f491d17557e4bec6ebc61b7bd2bc9cc7b612e4e",
    "User-Agent": "Qlik Webhook"
}

{
    "cloudEventsVersion": "0.1",
    "source": "com.qlik/engine",
    "contentType": "application/json",
    "eventId": "e65c1481-e8a-4be-a5ca-27dfcde077d7",
    "eventTime": "2021-03-08T14:51:29Z",
    "eventTypeVersion": "1.0.0",
    "eventType": "com.qlik.v1.app.deleted",
    "extensions": {
        "ownerId": "vNRGrDZIypJzauw59BbpvkRhqbmI",
        "tenantId": "oZcMPa_1PwH4FUdrh6839YHHdEJN",
        "userId": "vNRGrDZIypJtcGTzauw59BbpqbmI"
    },
    "data": {
        "attributes": {
            "id": "0984fec4-aa8c-4253-b1d1-4fd4f9c78",
            "name": "New App",
            "createdDate": "2021-03-08T14:51:28.888Z",
            "modifiedDate": "2021-03-08T14:51:29.316Z",
            "owner": "auth0|b62a17c577a4abe6e807b07d18c4d82286352542d633d120100b03fb11",
            "ownerId": "vNRGrDZIypJtcGTzauw59BbpvbmI",
            "published": false,
            "hasSectionAccess": false
        }
    }
}

웹후크 만들기

웹후크는 다음 사용자가 만들 수 있습니다.

• 관리 활동 센터의 테넌트 관리자.

• Qlik Automate 인터페이스의 모든 사용자.

Qlik Automate에서 웹후크를 사용하는 방법에 대한 자세한 내용은 웹후크 작업 (영어로만 제공)을 참조하십시오.

다음과 같이 하십시오.

1. 관리 활동 센터에서 웹후크로 이동합니다.

2. 새로 만들기를 클릭합니다.

3. 웹후크의 이름을 입력하고 선택적으로 설명을 추가합니다.

4. URL(엔드포인트)의 경우 웹후크가 JSON 데이터를 보낼 FQDN(정규화된 도메인 이름)을 입력합니다.

   • 이 URL은 HTTPS 프로토콜을 사용해야 합니다(예: https://domain.com). IP 주소는 웹후크 엔드포인트로 사용할 수 없습니다.

5. 선택적으로 웹후크 인증을 위한 암호 를 입력합니다.

   • 암호는 32자에서 64자 사이여야 합니다.

   • 만들어진 경우 암호는 해시의 일부로 포함되어 HTTP 요청에 qlik-signature로 추가됩니다.

6. 클라우드 이벤트 Qlik Cloud 웹후크 서비스에서 내보낸 이벤트 페이로드입니다. 활성화하고 저장한 후에는 변경 사항을 실행 취소할 수 없습니다.

7. 인증서 해지 확인을 활성화하면 웹후크 인증서가 유효하고 해지되지 않았는지 확인합니다.

8. 선택적으로 요청에 추가할 HTTP 헤더를 추가합니다. 헤더 값을 암호화하려면 확인란을 선택합니다.

   정보 메모보안상의 이유로 암호화된 헤더는 편집할 수 없으며, 헤더를 삭제하려면 삭제 아이콘을 클릭합니다. 값을 제거하려면 제거 아이콘을 클릭하고 새 값을 입력합니다.

9. 이벤트에서 웹후크를 트리거할 시스템 이벤트를 선택합니다. 사용 가능한 이벤트는 다음과 같습니다.

   • 자동화 이벤트

   • API 이벤트

   • 응용 프로그램 이벤트

   • 데이터 통합 이벤트

   • 사용자 이벤트

10. 만들기를 클릭합니다.

웹후크 관리

정보 메모

Qlik Automate에서 만든 웹후크는 관리 활동 센터에서만 볼 수 있습니다. 편집, 삭제, 활성화 또는 비활성화할 수 없습니다.

이러한 웹후크를 관리하려면 Qlik Automate 인터페이스를 사용하십시오.

웹후크 정렬 및 검색

테이블에서 웹후크를 정렬하고 검색하려면:

• 열 맨 위에 있는 를 클릭하여 정렬 순서를 변경합니다.

• 열 맨 위에 있는 를 클릭하여 웹후크를 검색합니다. 검색 필터는 전체 및 부분 일치에 대해 작동합니다.

웹후크 켜기 또는 끄기

다음과 같이 하십시오.

1. 관리 활동 센터에서 웹후크로 이동합니다.

2. 웹후크 옆에 있는 를 클릭합니다.

3. 웹후크를 켜려면 활성화를 선택합니다.

4. 웹후크를 끄려면 비활성화를 선택합니다.

새로 만든 웹후크는 기본적으로 활성화되어 있습니다.

웹후크 편집

다음과 같이 하십시오.

1. 관리 활동 센터에서 웹후크로 이동합니다.

2. 편집할 웹후크에 대해 를 클릭합니다.

3. 편집을 선택합니다.

4. 편집을 수행하고 저장을 클릭합니다.

정보 메모저장되지 않은 변경 사항이 있을 때 취소를 클릭하면 확인 대화 상자가 나타납니다. 변경 사항을 저장하지 않고 닫으려면 삭제를 클릭합니다.

웹후크 삭제

다음과 같이 하십시오.

1. 관리 활동 센터에서 웹후크로 이동합니다.

2. 삭제할 웹후크를 선택합니다.

3. 삭제를 클릭합니다.

4. 삭제를 확인합니다.

정보 메모하나 이상의 웹후크를 선택할 때까지 삭제 버튼을 사용할 수 없습니다. 작업 모음에 선택한 웹후크 수가 표시됩니다.

웹후크 기록 보기

웹후크 이벤트 기록은 7일 동안 보존됩니다.

다음과 같이 하십시오.

1. 관리 활동 센터에서 웹후크로 이동합니다.

2. 웹후크 옆에 있는 을 클릭하여 이벤트 기록을 확장합니다.

   

3. 이벤트 전송을 수동으로 다시 보내려면 이벤트 행에서 을 클릭합니다.

4. 이벤트 응답 페이로드를 보려면 이벤트 행에서 를 클릭합니다.

   페이로드에는 응용 프로그램 ID, 이름 및 타임스탬프와 같은 세부 정보가 표시되며, 이는 과거 이벤트를 디버깅하거나 감사하는 데 유용합니다.