Jira Cloud 대상
Panther 콘솔에서 Jira Cloud를 경고 대상으로 구성하기
개요
대상(Destinations)은 규칙, 정책, 시스템 상태 알림 및 규칙 오류로부터 알림을 수신하는 통합입니다. Panther는 알림을 수신할 대상으로 Jira를 구성하는 것을 지원합니다.
알림이 Jira 대상으로 전달되면 지정된 프로젝트에 지정된 담당자와 함께 버그, 스토리 또는 작업이 생성됩니다. Panther 알림과 해당하는 Jira 이슈 간에 상태 업데이트, 담당자 및 댓글을 한 방향 또는 양방향으로 동기화하도록 선택할 수 있습니다.
이 페이지는 Jira Cloud 대상을 설정하는 방법을 설명합니다. 다음을 참조하세요 여기의 Jira Data Center에 대한 지침.
단방향 동기화 vs. 양방향 동기화
Panther의 Jira 알림 대상에서는 담당자, 상태 및/또는 댓글에 대해 단방향 동기화 또는 양방향 동기화를 활성화할 수 있습니다.
단방향 동기화 (Panther > Jira): Panther 알림에서 상태나 담당자가 업데이트되거나 댓글이 생성되면 해당 Jira 이슈에서도 동일한 상태, 담당자 또는 댓글 변경이 이루어집니다.
양방향 동기화: 단방향 동기화 기능에 추가하여, Panther 알림이 생성한 Jira 이슈에서 상태나 담당자가 업데이트되거나 댓글이 생성 또는 업데이트되면 해당 Panther 알림에도 동일한 상태, 담당자 또는 댓글 변경이 적용됩니다.
Jira Cloud 대상을 설정할 때 다음 사항에 유의하세요:
다음은 가능합니다:
단방향 동기화로 여러 Jira Cloud 대상을 설정(같은 또는 다른 Jira 테넌트의 동일하거나 다른 Jira 프로젝트에 연결)하는 것이 가능합니다.
단일 Jira Cloud 대상을 양방향 동기화로 설정하고, 하나 이상의 Jira Cloud 대상을 단방향 동기화로 설정(같은 또는 다른 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 페이지활성화되어 있다면, 클릭하세요 앱 가져오기.
아래 이 앱을 설치할 사이트 선택에서 Panther 양방향 동기화를 활성화하려는 Jira 인스턴스를 선택하세요.
클릭 설치.
Panther에서 Jira 알림 대상을 구성한 후 이 앱 구성을 완료하게 됩니다.
담당자(assignee)에 대한 단방향 또는 양방향 동기화 전제 조건
단방향 또는 양방향 담당자 동기화를 활성화할 계획이라면 Panther 알림으로 생성된 Jira 이슈에 할당될 조직의 각 사용자는 Jira에서 설치된 앱에 자신의 이메일을 사용 가능한 상태로 만들어야 합니다. 각 사용자는 아래 절차를 완료해야 합니다:
Atlassian 콘솔에서 다음을 방문하세요 프로필 및 가시성 계정 설정 내의 탭.
을 클릭하세요 연락처 섹션.
이메일 주소에 대해 이 항목을 볼 수 있는 사람은 누구인가요? 값을 모두(Anyone).
1단계: Jira API 키 생성
Atlassian 계정에 로그인하고 다음으로 이동하세요 API 토큰 관리 페이지.
클릭 API 토큰 생성에서 설명적인 라벨을 추가하고 Create:
클릭 복사 를 클릭한 다음 토큰을 안전한 장소에 저장하세요.
참고: 토큰은 민감한 정보이며 이후에 다시 볼 수 없습니다.
2단계: Panther에서 Jira 알림 대상 구성
Panther 콘솔의 왼쪽 탐색 바에서 클릭하세요 구성 > 경고 대상.
클릭 +첫 번째 대상을 추가하세요.
이미 대상을 생성한 경우, 새 대상을 추가하려면 새로 만들기 페이지 오른쪽 상단을 클릭하세요.
클릭 Jira Cloud.
양식을 작성하십시오:
표시 이름: 설명적인 이름을 입력하세요.
조직 도메인(Organization Domain): 조직의 Jira 도메인을 입력합니다.
예: https://example.atlassian.net.
이슈 유형(Issue Type): Jira의 이슈 유형을 입력합니다. 이는 Bug, Story, Task 또는 사용자 정의 유형일 수 있습니다.
프로젝트 키(Project Key): 조직 내 프로젝트 식별자를 입력합니다. 이는 Jira의 프로젝트 설정 페이지에서 찾거나 조직의 Jira 프로젝트 를 찾아
키열을 확인하여 찾을 수 있습니다.이메일(Email): 해당 Jira API 키로 새 이슈를 생성 및 삭제할 권한이 있는 Jira 사용자 이메일 주소를 입력하세요.
Jira API 토큰: 이 설명서의 이전 단계에서 생성한 API 토큰을 입력하세요.
경고의 심각도는 탐지의: 이 대상으로 보낼 알림의 심각도 수준을 선택하세요.
기본 알림 유형: 이 대상으로 보낼 알림 유형을 선택하세요.
로그 유형: 기본적으로 모든 로그 유형의 알림을 전송합니다. 특정 로그 유형에서만 알림을 전송하려면 여기에서 로그 유형을 지정하세요.
다음 동기화 옵션(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로 댓글을 동기화할 때 원본 형식을 유지하려고 시도하여 댓글이 동일하게 보이도록 합니다. 드문 경우지만 변환 제한으로 인해 내용 손실 없이 형식이 달라질 수 있습니다.
양방향(Two-Way): 위에서 설명한 단방향 기능에 추가하여 Jira 이슈에 댓글이 게시되면 해당 댓글이 Panther 알림에도 게시됩니다.
Jira 이슈에 게시된 댓글이 해당 Panther 알림으로 동기화될 때, 댓글 텍스트 앞에는 "[Jira user] commented on Jira:"가 추가됩니다.
Jira 이슈의 댓글이 편집되면 Panther 알림의 댓글도 편집됩니다.
Panther에서의 댓글 형식에는 몇 가지 제한이 있습니다. 다음을 참조하세요 Panther에서의 댓글 형식 를 참조하세요.
클릭 계속.
3단계: Jira 이슈 속성 구성
페이지에서 Jira 이슈 속성 구성 페이지에서 양식을 작성하세요:
담당자 ID(Assignee ID): 이슈가 할당될 사용자를 선택하세요.
이 드롭다운 필드에 표시되는 사용자는 귀하의 Jira 인스턴스에서 가져옵니다.
심각도 수준에 따라 이슈에 라벨을 추가하고 우선순위 지정: Panther의 알림 심각도에 따라 Jira에서 라벨 및 우선순위를 적용하려면 이를 활성화하세요. 비활성화된 경우에도 전역적으로(즉, 심각도 기반이 아닌 방식으로) 라벨과 우선순위를 설정할 수 있습니다. 이 드롭다운에 표시되는 라벨 및 우선순위는 귀하의 Jira 인스턴스에서 가져옵니다. 만약 라벨(Labels) 드롭다운에서 새 라벨을 생성하면 해당 라벨이 귀하의 Jira 인스턴스에도 생성됩니다.
다음으로 설정된 경우 켜기: 각 심각도 수준에 대해 라벨(Labels) 와 우선순위(Priority).
다음으로 설정된 경우 OFF: Panther가 생성하는 모든 Jira 이슈에 대해 라벨(Labels) 와 우선순위(Priority) 를 지정하세요.
4단계: Panther/Jira 동기화 구성
(알림 상태의 단방향 또는 양방향 동기화를 활성화한 경우에만)에서 상태 동기화(Status Syncing) 페이지에서 Panther 알림 상태를 Jira에서 사용하려는 해당 상태에 매핑하세요.
클릭 변경 사항 저장(Save Changes).
(알림 상태, 담당자 또는 댓글에 대해 양방향 동기화를 활성화한 경우에만)에서 양방향 동기화(Two-Way Sync) 페이지에서 Panther 인스턴스 URL(Panther Instance URL) 와 API 토큰 을 복사하여 안전한 장소에 저장하세요. 다음 단계에서 필요합니다. API 토큰은 다시 표시되지 않습니다.
클릭 계속.
5단계(양방향 동기화 전용): Panther Cloud Sync 앱 설정 마무리
Jira 콘솔에서 다음으로 이동하세요 설정 > 앱(Apps)을 클릭한 다음 앱 관리(Manage apps).
아래 사용자 설치 앱(User-installed apps)활성화되어 있다면, 클릭하세요 Panther Cloud Sync 섹션을 확장하세요.
클릭 구성.
아래 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에 입력한 Project Key와 일치해야 합니다.
클릭 저장.
6단계: Panther에서 Jira 알림 대상 설정 마무리
Panther의 대상 구성 최종 페이지에서 선택적으로 클릭하세요 테스트 알림 전송 테스트 페이로드를 사용하여 통합을 테스트합니다. 완료되면 클릭하세요 설정 완료.
Panther에서의 댓글 형식
댓글에 대해 양방향 동기화가 활성화되어 있고 Jira 이슈의 댓글이 생성되거나 업데이트되면 표나 이미지와 같은 고급 형식은 Panther에서의 댓글 표현에서 제거됩니다.
Panther에서 지원되는 댓글 형식에는 다음이 포함됩니다:
굵게(Bold)
기울임(Italics)
취소선(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) 필드는 더 나은 자동화 지원을 위해 티켓 설명에 표시됩니다.
요청 본문(payload)은 아래 예와 유사합니다:
Panther가 전송하는 요청 헤더는 다음 형식입니다:
알림 라우팅 순서, 대상 수정 또는 삭제, 워크플로 자동화에 대한 자세한 내용은 Panther 문서를 참조하세요:
대상 대상.
Last updated
Was this helpful?