Atlassian Jira 알림 연동

개요#

파일 전송 작업의 상태 변화를 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 사이트 주소를 입력합니다.

예:

https://your-domain.atlassian.net

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를 입력합니다.

예:

PROJ

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)#

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