Integrate Atlassian Jira Notifications

개요

파일 전송 작업의 상태 변화를 Jira 이슈로 자동 생성하려면 Atlassian Jira 알림을 연동할 수 있습니다.

연동을 완료하면 전송이 시작(Started), 완료(Completed), 실패(Failed) 되는 등 지정한 이벤트가 발생할 때마다 지정한 Jira 프로젝트에 이슈가 자동으로 생성됩니다.

전체 과정은 ① Jira API Token 발급 → ② 제품에서 알림 설정 두 단계로 진행됩니다.

준비 사항

시작하기 전에 다음 사항을 확인하세요.

Jira API Token 발급

Jira로 알림을 받으려면 Atlassian 계정에서 API Token을 발급받습니다.

발급된 API Token은 계정 이메일과 함께 Jira 인증에 사용됩니다.

Step 1. API Token 페이지 접속

https://id.atlassian.com/manage-profile/security/api-tokens 에 접속합니다.

비밀번호 또는 외부 계정으로 로그인한 경우 이메일로 전송되는 일회용 코드로 본인 확인을 요청받을 수 있습니다.

Step 2. API Token 생성

Create API token을 클릭합니다.

토큰 이름(예: INNORIX Notifications)을 입력한 뒤 만료 기간(1~365일)을 선택하고 토큰을 생성합니다.

만료일이 지나면 토큰이 만료되어 알림 연동이 중단되므로, 만료 전에 새로운 토큰을 발급하여 교체해야 합니다.

Step 3. API Token 복사

Copy to clipboard를 클릭하여 API Token을 복사합니다.

API Token은 비밀번호와 같은 정보입니다. 값을 알고 있는 사람은 해당 계정 권한으로 Jira에 접근할 수 있으므로 공개 저장소나 외부 문서에 노출되지 않도록 주의합니다.

생성 창을 닫으면 Token을 다시 확인할 수 없으므로 안전한 위치에 보관하고, 유출되거나 분실한 경우에는 기존 Token을 폐기(Revoke)한 뒤 새로 발급합니다.

확인 사항

• ✔ API Token이 생성되었습니다.
• ✔ API Token을 안전하게 복사하여 보관했습니다.

Jira 알림 설정

발급받은 API Token과 계정 정보를 제품의 알림 설정에 입력합니다.

Notifications 설정 창을 열면 아래와 같은 화면이 표시됩니다.

Step 1. Jira Instance URL 입력

Jira Instance URL 항목에 사용 중인 Jira 사이트 주소를 입력합니다.

예:

Step 2. Username / Email 입력

Username / Email 항목에 API Token을 발급한 Atlassian 계정의 이메일을 입력합니다.

이 계정은 대상 프로젝트에 이슈를 생성할 권한이 있어야 합니다.

Step 3. API Token 입력

API Token 항목에 복사한 API Token을 붙여넣습니다.

Step 4. Project Key 입력

Project Key 항목에 이슈를 생성할 프로젝트의 Project Key를 입력합니다.

예:

Project Key는 프로젝트 설정 또는 기존 이슈 번호(예: PROJ-123)에서 확인할 수 있습니다.

Step 5. 알림 이벤트 선택

Events 항목에서 알림을 받을 이벤트를 선택합니다.

여러 개를 선택할 수 있으며, 선택한 이벤트가 발생할 때만 Jira 이슈가 생성됩니다.

Step 6. 설정 저장

입력을 마쳤으면 Add를 클릭하여 연동을 저장합니다.

확인 사항

• ✔ Jira Instance URL이 입력되었습니다.
• ✔ Username / Email이 입력되었습니다.
• ✔ API Token이 입력되었습니다.
• ✔ Project Key가 입력되었습니다.
• ✔ 알림받을 이벤트가 선택되었습니다.

연동 확인

설정이 정상적으로 동작하는지 확인합니다.

Step 1. 테스트 이벤트 발생

실제 전송 작업을 실행하거나 선택한 이벤트 중 하나를 발생시킵니다.

Step 2. Jira 프로젝트 확인

지정한 Jira 프로젝트에 새로운 이슈가 생성되었는지 확인합니다.

확인 사항

• ✔ Jira 프로젝트에 이슈가 생성되었습니다.
• ✔ 발생한 이벤트가 정확하게 기록되었습니다.

설정 완료

설정을 저장하면 연동이 적용됩니다.

이후 선택한 이벤트가 발생할 때마다 지정한 Jira 프로젝트에 새로운 이슈가 자동으로 생성됩니다.

문제 해결 (Troubleshooting)

이슈가 생성되지 않는 경우 아래 항목을 확인하세요.