Jira 데이터 센터용 웹훅 설정 방법 – Miro 도움말 센터

대상: Jira 시스템 관리자
플랜: 모든 Miro 플랜 (Jira 서버/데이터 센터 통합용 OAuth 1.0)
플랫폼: 브라우저, 데스크톱 앱 (설정 절차용)

Miro 보드의 Jira 카드가 최신 상태를 유지하려면 데이터 변경 시 Miro가 Jira로부터 메시지를 받아야 합니다. 이러한 Jira 이벤트는 웹훅을 통해 Miro로 전달됩니다.

이 가이드는 OAuth 1.0과 OAuth2.0을 사용하여 Jira 서버 및 Jira 데이터 센터를 위한 웹훅 생성 방법 두 가지를 제공합니다.

자동으로 웹훅 생성하기

Jira 카드 통합을 설정할 때, Jira Server 또는 Jira Data Center에 연결하는 경우 자동으로 웹훅 생성 옵션을 활성화 상태로 유지할 수 있습니다. 이 방법이 권장됩니다.

✏️ 자동 웹훅 생성을 위해서는 Jira 시스템 관리자 계정으로 로그인해야 합니다.

Jira 카드 설정, 2단계: "자동으로 웹훅 생성"이 활성화됨

웹훅이 자동으로 생성된 후, 고유한 이름을 부여하기 위해 Jira 웹훅 페이지로 가서 웹훅을 편집하는 것이 좋습니다. 이는 여러 Miro 팀을 Jira 인스턴스에 연결하려는 경우 특히 중요합니다.

✏️ OAuth2.0 연결의 경우 Miro 측 연결은 회사 수준에서 설정됩니다. 모든 Miro 팀에 대해 웹훅이 하나만 생성됩니다.

✏️ Miro 팀 수준에서의 OAuth 1.0 연결의 경우 각 팀에 대해 웹훅이 생성됩니다. Miro 회사 수준에서는 모든 팀에 대해 하나의 웹훅이 생성됩니다.

웹훅을 수동으로 생성하려면 다음 단계를 따르십시오.

Jira 서버/데이터 센터에 연결할 때 Miro의 Jira 카드 설정에서 웹훅 자동 생성 옵션의 체크를 해제합니다.
귀하의 조직 Jira URL을 복사해서 붙여넣고 연결 및 설정 저장을 클릭합니다.

Jira 카드 설정, 단계 2: "웹훅 자동 생성"이 비활성화됨
프롬프트가 나타나면 Jira에서 통합 연결을 허용합니다.
이 단계 이후, Miro가 웹훅 URL을 제공합니다:
Miro가 제공한 웹훅 URL

✏️ Jira 시스템 관리자가 아닌 경우, Miro가 제공한 웹훅 URL을 복사하여 아래의 지침을 통해 Jira 쪽에서 웹훅을 생성할 수 있도록 Jira 시스템 관리자에게 보내 주세요.

아래는 Miro에서 취득한 URL을 사용하여 Jira에 웹훅을 생성하는 단계입니다. 또한, Jira Server 및 Jira Cloud에 대한 공식 Atlassian 문서를 참고할 수도 있습니다 (이 문서는 Server/Data Center에 중점을 두고 있습니다).

Jira에서 웹훅 페이지로 이동하려면 Jira Administration > System > Advanced > WebHooks를 누릅니다(정확한 경로는 Jira 버전에 따라 약간 다를 수 있습니다). 또는 Jira 인스턴스 URL에 /plugins/servlet/webhooks를 추가하여 직접 링크를 사용할 수 있습니다(예: https://YourJiraInstanceName/plugins/servlet/webhooks).
웹훅 생성을 위해 웹훅 페이지 오른쪽 상단에 클릭합니다.
이름 필드에 웹훅의 설명을 입력합니다 (예: "Miro 통합 웹훅").
웹훅 상태를 활성화됨으로 설정합니다.
Miro 설정에서 복사한 웹훅 URL을 URL 필드에 붙여넣습니다.

Jira의 시스템 웹훅 구성
이벤트 섹션에서, 이슈 아래의 업데이트됨 및 삭제됨 이벤트를 선택합니다.
웹훅을 저장하려면 생성을 클릭합니다.

Jira 웹훅 이벤트 설정
Jira에서 웹훅이 생성된 후, Miro의 Jira 카드 설정의 2단계로 돌아가 Jira URL이 올바르게 입력되었는지 확인하고 연결을 클릭하세요.

이제 웹훅이 생성되어 설정되었습니다. Miro 보드의 Jira 카드는 Jira에서 변경 사항이 발생할 때 자동으로 업데이트됩니다.

만약 귀하의 조직이 조직 수준의 Jira 설정을 사용한다면, 웹훅 설정은 팀 수준 연결과 다르게 작동합니다:

- 조직 수준의 단일 웹훅: 조직 수준에서 Jira를 연결할 때, 전체 조직에 대해 단일 웹훅이 등록됩니다. 이를 통해 각 팀별로 별도의 웹훅을 가질 필요가 없어집니다.

- 웹훅 수 감소: 이전에 각 팀마다 하나의 웹훅을 가지고 있던 조직의 경우, 조직 수준 설정으로 전환하면 이를 단일 웹훅으로 통합하여 Jira 인스턴스의 부하를 줄일 수 있습니다.

- 팀 재정의는 조직 웹훅 사용: 팀이 전 세계 조직 연결을 사용할 때, 조직 수준에서 생성된 동일한 웹훅을 공유합니다.

참고: 팀 수준의 웹훅이 JQL 필터로 제한되어 있었던 경우(예: 특정 프로젝트에 대해), 조직 수준의 웹훅은 해당 JQL 필터를 모두 반영하거나 필터가 전혀 없어야 합니다. 조직 수준 설정으로 마이그레이션하기 전에 JQL 요구 사항을 검토하세요.

조직 관리자 설정에서 연결을 설정한 후 연결된 인스턴스 아래에서 웹훅 URL을 찾을 수 있습니다. 수동 웹훅을 복사하여 Jira 환경에 붙여넣으세요.