웹훅(Webhooks)-Slack 연동
Flexible User License의 웹훅(Webhooks) 기능은 라이선스 자동화 이벤트와 API 상태 이벤트를 지정한 채널에 알림 메시지로 전송하는 기능입니다. 웹훅을 사용하려면 먼저 연결할 채널의 URL을 발급받아 Flexible User License의 웹훅 설정 화면에 등록해야 합니다.
등록할 URL은 Slack에서 발급받은 Incoming Webhook URL입니다.
사용 전 필수 조건
웹훅을 사용하려면 다음 항목이 준비되어 있어야 합니다.
Slack 워크스페이스 계정
알림을 받을 Slack 채널(예:
#appb)Slack App 생성 권한
일부 워크스페이스에서는 보안 정책에 따라 Slack 앱 생성 또는 Webhook 연결 시 관리자 승인이 필요할 수 있습니다.
이는 외부 서비스가 Slack에 메시지를 전송하는 등 권한을 가지게 되기 때문입니다. 승인이 필요한 경우, 관리자에게 요청하십시오.
Slack에서 Webhook URL 발급하기
Slack App을 새로 생성하고 Incoming Webhooks를 활성화한 뒤, 알림을 받을 채널에 대한 Webhook URL을 발급받습니다.
Slack API 페이지(https://api.slack.com/apps)에 접속하여 로그인합니다.
Create New App을 클릭합니다.
From scratch를 선택합니다.
<Name app & choose workspace> 화면에서 다음 정보를 입력합니다.
App Name: 연결할 앱 이름을 입력합니다.(예: alert-appb )
Workspace: 알림 받을 Slack 워크스페이스 이름을 선택합니다.
Create App을 클릭합니다.
생성된 앱에 대한 기본 정보 화면에서 Incoming Webhooks을 선택합니다.
7. Activate Incoming Webhooks을 On으로 변경합니다.
<Incoming Webhooks> 아래쪽에 있는 Add New Webhook을 클릭하여 Webhook URL을 발급합니다.
웹훅을 위한 Slack 채널을 선택합니다.
허용을 클릭합니다.
생성된 Webhook URL을 복사하여 Flexible User License 앱에 등록합니다.
발급된 URL은 다음과 같은 형식입니다.
https://hooks.slack.com/services/TXXXXXXXX/BXXXXXXXX/XXXXXXXXXXXXXXXXXXXXXXXX
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: 알림 유형입니다. 현재는 Slack만 지원되므로 선택이 고정되어 있습니다.
Name: 웹훅을 구별할 이름을 입력합니다. 목록과 알림 메시지에 함께 표시됩니다.
Webhook URL: Slack에서 발급받은 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)에 전송 |
연결 테스트 및 저장
입력을 마쳤다면 저장 전에 Slack 연결이 정상적으로 되는지 확인합니다.
Test connection을 클릭합니다.
연결한 Slack 채널에 테스트 메시지가 도착하는지 확인합니다.
테스트 메시지가 정상적으로 수신되면 Save 버튼이 활성화됩니다.
Save를 클릭하여 설정을 저장합니다.
Test connection이 완료되기 전에는 Save 버튼이 비활성화 상태로 표시됩니다.
On This Page
웹훅 화면 둘러보기
Jira Cloud 사이트에 로그인합니다.
왼쪽 사이드 바의 앱 > Flexible User License를 선택합니다.
Flexible User License 앱의 내비게이션에서 Settings > Webhooks을 클릭합니다.
웹훅 화면에서는 등록된 웹훅 목록을 확인하고, 새 웹훅을 만들거나 기존 웹훅을 편집·삭제할 수 있습니다.
검색: 목록 위 검색창에 이름의 일부를 입력하면 결과가 필터링됩니다.
Event 필터: 특정 이벤트가 설정된 웹훅만 확인할 수 있습니다.
Name: 웹훅 이름입니다. 클릭하면 편집 화면으로 이동합니다.
Type: 알림 유형입니다. 현재는 Slack만 지원됩니다.
Last Updated: 마지막으로 수정한 날짜입니다.
Created by: 웹훅을 만든 사용자입니다.
Enabled: 토글 버튼으로 활성/비활성으로 전환할 수 있습니다.
Actions: 웹훅 삭제(Delete)를 선택할 수 있습니다.
On This Page
웹훅 편집
등록된 웹훅 목록에서 등록 정보를 수정하거나 등록된 웹훅을 삭제할 수 있습니다.
웹훅 이름 클릭: 편집 화면이 열리며, 등록한 정보를 수정할 수 있습니다.
웹훅 편집 화면에서 Incoming Webhook URL을 새로등록하거나 기타 설정 항목을 수정할 수 있습니다.
Enabled 토글을 사용하면 웹훅을 삭제하지 않고 일시적으로 비활성화할 수 있습니다. 비활성 상태에서는 어떤 이벤트가 발생해도 알림이 전송되지 않습니다.
On This Page
웹훅 삭제
웹훅 목록에서 등록된 웹훅을 삭제할 수 있습니다.
Delete: Actions 컬럼의 Delete를 클릭하면 웹훅이 삭제됩니다.
삭제할 웹훅의 Enabled를 비활성화하면, Delete 버튼이 활성화됩니다.
On This Page