웹훅(Webhooks)-Teams 연동
Flexible User License의 웹훅(Webhooks) 기능은 라이선스 자동화 이벤트와 API 상태 이벤트를 지정한 채널에 알림 메시지로 전송하는 기능입니다. 웹훅을 사용하려면 먼저 연결할 채널의 URL을 발급받아 Flexible User License의 웹훅 설정 화면에 등록해야 합니다.
등록할 URL은 Teams에서 발급받은 Incoming Webhook URL입니다.
사용 전 필수 조건
웹훅을 사용하려면 다음 항목이 준비되어 있어야 합니다.
Microsoft Teams 계정
알림을 받을 Teams 채널
Incoming Webhook 생성 권한
일부 워크스페이스에서는 보안 정책에 따라 Microsoft 365 또는 Teams 관리 정책에 따라 관리자의 승인이 필요할 수 있습니다.
이는 외부 서비스가Team에 메시지를 전송하는 등 권한을 가지게 되기 때문입니다. 승인이 필요한 경우, 관리자에게 요청하십시오.
Microsoft Teams에서 Webhook URL 생성하기
알림을 받을 Teams 채널에 워크플로우(Workflow)를 추가하고, Send webhook alerts to a channel 템플릿을 이용해 Webhook URL을 발급받습니다.
알림을 받을 Teams 채널로 이동합니다.
채널 오른쪽의 …(더 보기) > alert > 워크플로우(Workflows)를 선택합니다.
워크플로우 화면에서 Send webhook alerts to a channel 템플릿을 선택합니다.
웹훅을 수신할 채널을 선택한 후 저장을 클릭합니다.
Copy webhook link 를 클릭하고 생성된 웹훅 링크를 복사합니다.
Webhook URL을 알고 있는 사람은 누구나 해당 채널로 메시지를 전송할 수 있습니다. URL은 외부에 공유하거나 공개 저장소(GitHub 등)에 업로드하지 않아야 합니다.
On This Page
Flexible User License에 Webhook 등록하기
발급받은 Webhook URL을 Flexible User License 앱에 등록합니다. 웹훅을 새로 생성하려면 Create webhook을 선택하고, 기존에 생성된 웹훅을 수정하여 등록하려면 목록에서 대상을 선택하여 등록할 수 있습니다.
Jira Cloud 사이트에 로그인합니다.
왼쪽 사이드 바의 앱 > Flexible User License를 선택합니다.
Flexible User License 앱의 내비게이션에서 Settings > Webhooks을 클릭합니다.
웹훅 화면 오른쪽 위에 있는 Create webhook을 클릭합니다.
<Create webhook>에서 별표(*)가 붙은 필수 항목을 입력합니다.
Enabled: 웹훅 활성화 여부입니다. 화면 우측 상단의 토글로 켜거나 끌 수 있습니다.
Type: 알림을 전송할 채널 유형으로 Teams를 선택합니다.
Name: 웹훅을 구별할 이름을 입력합니다. 목록과 알림 메시지에 함께 표시됩니다.
Webhook URL: Teams에서 발급받은 Incoming Webhook URL을 붙여넣습니다.
입력란 아래의 Configure an incoming webhook 링크를 클릭하면 URL 발급 방법을 확인할 수 있습니다.
Language: 알림 메시지에 사용할 언어를 선택합니다.
Events: 알림을 받을 이벤트를 선택합니다. 여러 이벤트를 동시에 선택할 수 있습니다.
Schedule: 알림을 받을 시간대를 설정합니다.
Events
알림을 받을 이벤트를 선택합니다. 이벤트 유형에 따라 발송 방식이 다릅니다.
License automation events
Automated license revocation: 라이선스가 자동으로 회수되었을 때 알림을 전송합니다. 이벤트가 발생하는 시점에 즉시 전송되며, Schedule에 설정된 수신 시간 내에서만 발송됩니다.
License user count exceeds the set limit: 라이선스 사용자 수가 설정한 한도의 75%를 초과했을 때 알림을 전송합니다. 하루 1회 발송됩니다.
API information events
Organization API Key & API Token is invalid: 등록된 Organization API Key 또는 API Token이 유효하지 않을 때 알림을 전송합니다. 하루 1회 발송됩니다.
Schedule
알림을 받을 시간대를 설정합니다.
Always: 요일과 시간대에 관계없이 항상 알림을 수신합니다.
Weekdays or custom: 선택한 요일과 시간대(From ~ To)에만 알림을 수신합니다. 설정한 시간 외에는 알림이 전송되지 않습니다.
이벤트별 발송시간은 다음과 같습니다.
이벤트 | 발송 방식 | Always 설정 시 | Weekdays or custom 설정 시 |
|---|---|---|---|
Automated license revocation | 이벤트 발생 시 즉시 | 발생 즉시 전송 | 설정된 요일·시간대 내에서 발생 즉시 전송 |
License user count exceeds the set limit | 하루 1회 | 오전 9시 전송 | 설정한 시작 시각(From)에 전송 |
Organization API Key & API Token is invalid | 하루 1회 | 오전 9시 전송 | 설정한 시작 시각(From)에 전송 |
연결 테스트 및 저장
입력을 마쳤다면 저장 전에 Teams 연결이 정상적으로 되는지 확인합니다.
Test connection을 클릭합니다.
연결한 Teams 채널에 테스트 메시지가 도착하는지 확인합니다.
테스트 메시지가 정상적으로 수신되면 Save 버튼이 활성화됩니다.
Save를 클릭하여 설정을 저장합니다.
Test connection이 완료되기 전에는 Save 버튼이 비활성화 상태로 표시됩니다.
On This Page
웹훅 편집
등록된 웹훅 목록에서 등록 정보를 수정하거나 등록된 웹훅을 삭제할 수 있습니다.
웹훅 이름 클릭: 편집 화면이 열리며, 등록한 정보를 수정할 수 있습니다.
웹훅 편집 화면에서 Incoming Webhook URL을 새로 등록하거나 기타 설정 항목을 수정할 수 있습니다.
Enabled 토글을 사용하면 웹훅을 삭제하지 않고 일시적으로 비활성화할 수 있습니다. 비활성 상태에서는 어떤 이벤트가 발생해도 알림이 전송되지 않습니다.
On This Page
웹훅 삭제
웹훅 목록에서 등록된 웹훅을 삭제할 수 있습니다.
Delete: Actions 컬럼의 Delete를 클릭하면 웹훅이 삭제됩니다.
삭제할 웹훅의 Enabled를 비활성화하면, Delete 버튼이 활성화됩니다.
On This Page