Jira Cloud 대상
Panther 콘솔에서 Jira Cloud를 알러트 대상으로 구성하기
개요
대상(Destinations)은 룰, 정책, 시스템 상태 알림 및 룰 오류로부터 알러트를 수신하는 통합입니다. Panther는 알러트를 수신할 대상으로 Jira 구성을 지원합니다.
알러트가 Jira 대상으로 전달되면 지정된 프로젝트와 지정된 담당자(assignee)로 버그, 스토리 또는 작업이 생성됩니다. Panther 알러트와 해당 Jira 이슈 간에 상태 업데이트, 담당자 및 코멘트를 한 방향 또는 양방향으로.
이 페이지에서는 Jira Cloud 대상을 설정하는 방법을 설명합니다. 다음을 참조하세요: 여기에서 Jira Data Center에 대한 지침.
단방향 동기화 vs 양방향 동기화
Panther의 Jira 알러트 대상에서는 담당자, 상태 및/또는 코멘트에 대해 단방향 동기화 또는 양방향 동기화를 활성화할 수 있습니다.
단방향 동기화 (Panther > Jira): Panther 알러트에서 상태나 담당자가 업데이트되거나 코멘트가 생성되면 동일한 상태, 담당자 또는 코멘트 변경이 해당 Jira 이슈에도 적용됩니다.
양방향 동기화: 단방향 동기화 기능에 더하여, Panther 알러트가 생성한 Jira 이슈에서 상태나 담당자가 업데이트되거나 코멘트가 생성 또는 업데이트되면 동일한 상태, 담당자 또는 코멘트 변경이 해당 Panther 알러트에도 적용됩니다.
Jira Cloud 대상을 설정할 때 다음 사항에 유의하세요:
다음 작업이 가능합니다:
단방향 동기화로 여러 Jira Cloud 대상을 설정할 수 있습니다(같은 또는 다른 Jira 테넌트의 동일 또는 다른 Jira 프로젝트와 연결 가능).
양방향 동기화 하나와 단방향 동기화 하나 이상을 함께 설정할 수 있습니다(같은 또는 다른 Jira 테넌트의 동일 또는 다른 Jira 프로젝트와 연결 가능).
권장하지 않는 구성:
다른 Jira 테넌트 내의 서로 다른 프로젝트에 연결된 여러 Jira Cloud 대상을 양방향 동기화로 설정하는 것은 권장하지 않습니다. 이 구성은 동기화의 무한 루프를 유발할 수 있습니다.
불가능한 구성:
같은 Jira 테넌트 내의 서로 다른 프로젝트에 연결된 여러 Jira Cloud 대상을 양방향 동기화로 설정할 수 없습니다. 이 구성은 동기화의 무한 루프를 유발합니다.
하나의 Jira Cloud 대상을 양방향 동기화로 설정하여 여러 Jira 프로젝트에 연결할 수 없습니다.
Panther에서 Jira 알러트 대상을 설정하는 방법
사전 요구 사항
양방향 동기화 전제 조건
양방향 동기화를 활성화하려면 먼저 Panther Cloud Sync 앱을 Atlassian 인스턴스에 설치해야 하며, 이를 통해 Panther가 Panther가 생성한 Jira 이슈에 대한 업데이트를 수신할 수 있습니다. Panther가 생성하지 않은 이슈에 대한 업데이트는 수신되지 않습니다.
Panther Cloud Sync를 설치하려면:
페이지에서 Panther Cloud Sync 페이지인 경우 JSON 로그를 업로드했다면 클릭하세요 앱 가져오기(Get app).
에서 이 앱을 설치할 사이트 선택, Panther 양방향 동기화를 활성화하려는 Jira 인스턴스를 선택하세요.
를 선택하고 Panther가 설치된 계정 ID를 입력하십시오. 설치(Install).
이 앱의 구성은 Panther에서 Jira 알러트 대상을 구성한 후에 완료됩니다.
담당자(Assignees)의 단방향 또는 양방향 동기화 전제 조건
단방향 또는 양방향 담당자 동기화를 활성화할 계획이라면, Panther 알러트가 생성한 Jira 이슈에 배정될 조직의 각 사용자는 Jira에 설치된 앱에 자신의 이메일을 표시 가능하도록 설정해야 합니다. 이들 각 사용자는 아래 절차를 완료해야 합니다:
Atlassian 콘솔에서 프로필 및 가시성(Profile and visibility) 계정 설정 내 탭을 방문하세요.
을 클릭하세요. 연락처(Contact) 섹션의 명령을 실행하세요.
이메일 주소 항목에 대해, 누가 볼 수 있나요?(Who can see this?) 값을 누구나(Anyone).
1단계: Jira API 키 생성
(이 API 키를 생성하는 사용자) 당신은 Panther가 Jira에서 작업(예: 이슈 생성, 담당자/상태/코멘트 업데이트)을 수행할 때 해당 작업을 수행한 행위자로 표시됩니다.
Atlassian 계정에 로그인하고 다음으로 이동하세요: API 토큰 관리 페이지(API Token management page).
를 선택하고 Panther가 설치된 계정 ID를 입력하십시오. API 토큰 생성(Create API Token), 설명 레이블을 추가한 다음 클릭하세요 Python 함수를 입력한 다음:
를 선택하고 Panther가 설치된 계정 ID를 입력하십시오. 복사 그리고 토큰을 안전한 장소에 보관하세요.
참고: 토큰은 민감한 정보이므로 다시 볼 수 없습니다.
2단계: Panther에서 Jira 알러트 대상 구성
Panther 콘솔의 왼쪽 탐색 바에서 클릭하세요 구성 > 알러트 대상.
를 선택하고 Panther가 설치된 계정 ID를 입력하십시오. +첫 번째 대상 추가.
이미 대상(Destinations)을 생성한 경우, 새로 만들기 페이지 오른쪽 상단에서 새 대상을 추가하려면 클릭하세요.
를 선택하고 Panther가 설치된 계정 ID를 입력하십시오. Jira Cloud.
양식을 작성하세요:
표시 이름: 설명적인 이름을 입력하세요.
조직 도메인(Organization Domain): 조직의 Jira 도메인을 입력하세요.
예: https://example.atlassian.net.
이슈 유형(Issue Type): Jira의 이슈 유형을 입력하세요. 버그(Bug), 스토리(Story), 작업(Task) 또는 사용자 정의 유형일 수 있습니다.
프로젝트 키(Project Key): 조직 내의 프로젝트 식별자를 입력하세요. 이 값은 Jira의 프로젝트 설정 페이지에서 찾거나 조직의 Jira 프로젝트를 찾아
키(key)열에서 확인할 수 있습니다.이메일(Email): 해당 Jira API 키로 새 이슈를 생성하고 삭제할 수 있는 권한이 있는 Jira 사용자의 이메일 주소를 입력하세요.
Jira API 토큰(Jira API Token): 이 문서의 이전 단계에서 생성한 API 토큰을 입력하세요.
심각도 수준: 이 대상으로 전송할 알러트의 심각도 수준을 선택하세요.
기본 알러트 유형(Default Alert Types): 이 대상으로 전송할 알러트 유형을 선택하세요.
로그 유형: 기본적으로 모든 로그 유형으로부터의 알러트를 전송합니다. 특정 로그 유형에서만 알러트를 전송하려면 여기서 로그 유형을 지정하세요.
수동 발송 허용: 이 토글을 ON으로 설정하면 이 대상에 대해 알러트를 수동으로 전송 할 수 있습니다.
일반 구성 동기화 옵션(Syncing Options) 섹션에서 다음 항목 각각에 대해 선택하세요:
알러트 상태(Alert Status):
동기화 안함(Do not sync): Panther에서 알러트 상태에 대한 업데이트는 해당 Jira 이슈에 반영되지 않으며, 그 반대도 마찬가지입니다.
단방향(One-Way): Panther 콘솔에서 알러트 상태가 변경되거나 Slack 봇, 또는 Panther API, 해당 Jira 이슈의 상태도 업데이트됩니다.
Panther에서 이루어진 모든 알러트 상태 변경은 관련 Jira 이슈에 코멘트로도 추가됩니다.
Jira 프로젝트 워크플로에서 사용자 정의 전환 규칙이 있는 경우 Panther가 티켓을 다음 상태로 전환하지 못할 수 있습니다. 모든 Jira 상태가 다른 모든 Jira 상태에서 전환 가능하도록 구성되어야 합니다. 이는 해당 Jira 프로젝트의 워크플로 설정에서 구성할 수 있습니다.
양방향(Two-Way): 위에 설명된 단방향 기능에 더하여, Jira 이슈의 상태가 업데이트되면 해당 Panther 알러트의 상태도 업데이트됩니다.
담당자(Assignee):
동기화 안함(Do not sync): Panther의 알러트 담당자에 대한 업데이트는 해당 Jira 이슈에 반영되지 않으며, 그 반대도 마찬가지입니다.
단방향(One-Way): Panther 알러트의 담당자가 업데이트되면(패너 콘솔에서 또는 Panther API), 해당 Jira 이슈의 담당자도 업데이트됩니다.
Panther 알러트와 Jira 이슈의 담당자는 이메일 주소로 매칭됩니다. Panther 계정에 연결된 이메일 주소가 Jira에서 발견되지 않으면(존재하지 않거나 전제 조건에 설명된 대로 표시되지 않은 경우), Jira 이슈에 대한 업데이트는 수행되지 않습니다.
현재 Panther의 Slack 봇 에서 알러트 담당자에 대한 업데이트는 연결된 Jira 이슈로 동기화되지 않습니다.
양방향(Two-Way): 위에 설명된 단방향 기능에 더하여, Jira 이슈의 담당자가 업데이트되면 일치하는 이메일 주소를 가진 Panther 사용자가 있는 한 담당자도 Panther 알러트에 업데이트됩니다.
코멘트(Comments):
동기화 안함(Do not sync): Panther의 알러트에 남긴 코멘트는 해당 Jira 이슈에 반영되지 않으며, 그 반대도 마찬가지입니다.
단방향(One-Way): Panther 알러트에 코멘트가 게시되면(패너 콘솔에서 또는 Panther API), 해당 코멘트는 해당 Jira 이슈에도 게시됩니다.
Panther에서 알러트에 게시된 코멘트가 해당 Jira 이슈로 동기화될 때, 코멘트 텍스트 앞에 "[Panther user] commented on Panther:"가 추가됩니다.
Panther에서 Jira로 코멘트를 동기화할 때 Panther는 원래 형식을 유지하려고 시도하여 코멘트가 동일하게 보이도록 합니다. 드문 경우 변환 제한으로 인해 내용 손실 없이 형식이 다르게 보일 수 있습니다.
양방향(Two-Way): 위에 설명된 단방향 기능에 더하여, Jira 이슈에 코멘트가 게시되면 해당 코멘트는 Panther 알러트에도 게시됩니다.
Jira 이슈에 게시된 코멘트가 해당 Panther 알러트로 동기화될 때, 코멘트 텍스트 앞에 "[Jira user] commented on Jira:"가 추가됩니다.
Jira 이슈의 코멘트가 편집되면 Panther 알러트의 코멘트도 편집됩니다.
Panther에서의 코멘트 형식에는 몇 가지 제한이 있습니다. 참조: Panther에서의 코멘트 형식(Comment formatting in Panther) 을 참조하세요.
를 선택하고 Panther가 설치된 계정 ID를 입력하십시오. 계속.
3단계: Jira 이슈 속성 구성
페이지에서 Jira 이슈 속성 구성(Configure Jira Issue Properties) 페이지에서 양식을 작성하세요:
담당자 ID(Assignee ID): 이슈가 배정될 사용자를 선택하세요.
이 드롭다운 필드에 표시되는 사용자는 귀하의 Jira 인스턴스에서 가져옵니다.
심각도 수준에 따라 이슈에 라벨을 지정하고 우선순위를 설정: 알러트의 심각도에 따라 Jira에서 라벨과 우선순위를 적용하려면 이를 활성화하세요. 비활성화한 경우에도 전역적으로(심각도 기준이 아닌) 라벨과 우선순위를 설정할 수 있습니다. 이 드롭다운에서 사용 가능한 라벨과 우선순위는 귀하의 Jira 인스턴스에서 가져옵니다. 만약 라벨(Labels) 드롭다운에서 새 라벨을 생성하면 해당 라벨은 귀하의 Jira 인스턴스에도 생성됩니다.
값이 켜기: 각 심각도 수준에 대해 라벨(Labels) 와 우선순위(Priority).
값이 OFF: Panther가 생성하는 모든 Jira 이슈에 대해 라벨(Labels) 와 우선순위(Priority) 을 지정하세요.
4단계: Panther/Jira 동기화 구성
(단방향 또는 양방향 상태 동기화를 활성화한 경우에만) 상태 동기화(Status Syncing) 페이지에서 Panther 알러트 상태를 Jira에서 사용하려는 해당 상태에 매핑하세요.
를 선택하고 Panther가 설치된 계정 ID를 입력하십시오. 변경사항 저장(Save Changes).
(알러트 상태, 담당자 또는 코멘트에 대해 양방향 동기화를 활성화한 경우에만) 양방향 동기화(Two-Way Sync) 페이지에서 Panther 인스턴스 URL(Panther Instance URL) 와 API 토큰 을 복사하여 안전한 장소에 보관하세요. 다음 단계에서 필요합니다. API 토큰은 다시 표시되지 않습니다.
를 선택하고 Panther가 설치된 계정 ID를 입력하십시오. 계속.
5단계(양방향 동기화 전용): Panther Cloud Sync 앱 설정 마무리
상태, 담당자 또는 코멘트에 대해 양방향 동기화를 활성화하지 않았다면 이 단계는 건너뛸 수 있습니다.
Jira 콘솔에서 다음으로 이동하세요: 설정 > 앱(Apps)을 클릭한 다음 앱 관리(Manage apps).
에서 사용자 설치 앱(User-installed apps)인 경우 JSON 로그를 업로드했다면 클릭하세요 Panther Cloud Sync 섹션을 확장하세요.
를 선택하고 Panther가 설치된 계정 ID를 입력하십시오. 구성.
에서 Panther 애플리케이션 구성(Panther Application Configuration), 다음 필드의 값을 입력하세요:
Panther 인스턴스 URL(Panther Instance URL): Panther에서 이전 단계에서 생성한 Panther 인스턴스 URL(Panther Instance URL) 값을 입력하세요.
Panther 시크릿(Panther Secret): Panther에서 이전 단계에서 생성한 API 토큰 값을 입력하세요.
추적되는 Jira 프로젝트(Tracked Jira Project): Panther와 동기화하려는 프로젝트를 선택하세요. 이 프로젝트는 Panther에 입력한 프로젝트 키와 일치해야 합니다.
를 선택하고 Panther가 설치된 계정 ID를 입력하십시오. "Resource": "<secret ARN>".
6단계: Panther에서 Jira 알러트 대상 설정 마무리
Panther의 대상 구성의 마지막 페이지에서 선택적으로 클릭할 수 있습니다 테스트 알러트 전송(Send Test Alert) 로 테스트 페이로드를 사용해 통합을 테스트할 수 있습니다. 완료되면 클릭하세요 설정 완료.
Jira 알러트 대상 문제 해결에 대한 정보는 다음 KB 문서를 참조하세요: Panther에서 Jira 알러트 대상 문제 해결 가이드(Guide to Troubleshooting Jira Alert Destinations in Panther).
Panther에서의 코멘트 형식(Comment formatting in Panther)
코멘트에 대한 양방향 동기화가 활성화되어 있고 Jira 이슈의 코멘트가 생성 또는 업데이트되면 표나 이미지와 같은 고급 형식은 Panther에서의 표현에서 제거됩니다.
Panther에서 지원되는 코멘트 형식은 다음을 포함합니다:
굵게(Bold)
기울임(Iitalic)
취소선(Strikethrough)
링크(Links)
코드 블록(Code blocks)
단락 및 줄 바꿈(Paragraphs and line breaks)
인용문(Quotes)
글머리 기호 목록(Bulleted lists)
번호 매기기 목록(Numbered lists)
알러트 컨텍스트 형식(Alert Context Formatting)
사용자를 사용할 것이며, alert_context payload는 JSON입니다 예쁘게 출력되어(pretty printed) JIRA의 네이티브 형식을 사용합니다. 또한 Panther는 룰 ID(Rule ID) 와 알러트 ID(Alert ID) 필드를 티켓 설명에 노출하여 자동화 지원을 개선합니다.
요청 본문 페이로드는 아래 예와 유사합니다:
Panther가 전송하는 요청 헤더는 다음 형식입니다:
대상(Destinations)에 대한 추가 정보
알러트 라우팅 순서, 대상 수정 또는 삭제, 워크플로 자동화에 대한 자세한 내용은 Panther 문서를 참조하세요: 대상(Destinations).
마지막 업데이트
도움이 되었나요?