해당 대상: Jira Cloud, Jira Server(온프레미스), Datacenter(LDAP로 보호됨 포함)
설정 기준: Miro 팀 관리자 및 프로젝트 관리 권한이 있는 Jira 시스템 관리자
✏️ Miro에서는 2025년 7월 1일부터 OAuth1.0 인증 방법을 더 이상 지원하지 않습니다. OAuth1.0은 Jira에서 사용되지 않는 인증 프로토콜이며 사용해서는 안 됩니다. 이 변경 사항은 OWASP에서 권장하는 보안 모범 사례에 따라 OAuth2.0으로 전환하는 과정의 일부입니다. 지속적인 지원과 Miro 서비스와의 호환성을 보장하기 위해 사용자는 OAuth2.0으로 전환하는 것이 권장됩니다.
Jira에서 Miro 구성
⚠️ 기술적인 문제가 발생하면 발생 가능한 문제 및 해결 방법에 관한 문서를 참조하세요.
💡 Jira 카드에 대해 더 알아보려면 Jira 카드 FAQ와 Jira 카드에 웹훅을 설정하는 방법 문서를 참조하세요.
✏️ 참고로 사용 중인 Jira 버전에 따라 Jira 메뉴가 다를 수 있지만, 일반적인 흐름은 동일해야 합니다. 아래 지침은 Atlassian 지원에서도 확인할 수 있습니다.
단계 1 - 애플리케이션 링크
먼저 애플리케이션 링크를 생성하고 설정하세요.
-
Jira 설정 > 제품 > 통합 > 애플리케이션 링크 > 링크 만들기</strong>로 이동하세요.
Jira 버전에 따라 Jira 인터페이스가 다를 수 있습니다
-
직접 애플리케이션 링크를 선택하고 애플리케이션 URL 필드에 https://miro.com/을 입력하세요.
중요: 정확히 이 형식으로 URL을 입력해야 합니다. 계속을 클릭하세요.
링크 생성
- 다음 메뉴에서 계속을 다시 클릭하기만 하면 됩니다.
-
검토 링크 메뉴에서 URL이 여전히 https://miro.com/으로 정확한지 다시 확인하고 원하는 애플리케이션 이름을 입력하세요. 아래로 스크롤한 후, 하단에서 <span>접속 링크 생성 상자를 체크합니다. 나머지 필드를 건너뛰고 계속 을 클릭하세요.
애플리케이션 이름 필드만 작성해야 합니다
- 여기서 Miro 값 필드를 볼 수 있습니다. 값을 받으려면 Miro에 로그인하세요.
- 처리 메시지가 잠시 동안 표시됩니다.
링크 생성의 마지막 단계
Atlassian 측의 단계가 완료되었습니다. 링크는 애플리케이션 링크 목록에 표시됩니다.
2단계 - 연결
Miro에서 Jira 카드 설정으로 돌아가 두 가지 옵션 중 하나를 선택하세요: 웹훅을 수동으로 생성하거나 자동으로 생성하세요. 수동으로 선택하려면 옵션의 체크를 해제하세요. 더 많은 정보는 이 문서에서 확인하세요. 플러그인에 큰 업데이트가 있을 경우를 대비해 자동 웹훅을 사용하는 것을 적극 권장합니다, 이렇게 하면 웹훅을 다시 설정할 필요가 없습니다.
마지막으로 Jira URL을 입력하고 연결을 클릭하세요.
Jira 카드 연결
Jira URL을 얻으려면 Jira 인스턴스의 기본 URL을 복사하세요. 다음의 포맷을 수용합니다:
https://name.domain/
https://name.domain:port/
https://IPaddress/
https://IPaddress:port/
Jira URL이 승인되지 않는 경우, 이 문서를 참조하세요. 또한 Miro가 Jira에 필요한 접근 권한을 가졌는지도 확인해 연결을 설정하세요.
이제 Jira 인스턴스가 Miro 팀과 연결되었습니다.
⚠️ Atlassian은 2024년 2월부터 Jira Server에 대한 지원을 중단하지만, Miro는 향후 지속적으로 Jira Server에 대한 Jira 카드 통합 지원을 제공할 것입니다.
-
https://your-jira-server/plugins/servlet/applinks/listApplicationLinks로 이동합니다. "애플리케이션 링크"가 선택되지 않은 경우 클릭하세요.
Jira Server 애플리케이션 링크
-
Create link을 클릭합니다. "Atlassian 제품"을 선택하고 애플리케이션 URL인 "https://miro.com"을 입력하세요. 계속을 클릭하세요.
애플리케이션 URL 구성
- "애플리케이션 연결" 대화 상자로 이동됩니다. 애플리케이션 이름 (예: Miro Jira 카드)을 추가하고, 애플리케이션 유형으로 "일반 애플리케이션"을 선택합니다.
"링크 생성 위치:" 아래에 Jira 애플리케이션 URL이 표시되고, "이 애플리케이션으로:" 아래에 https://miro.com이 표시되어야 합니다. 계속하기를 클릭합니다.애플리케이션 세부 정보 연결 설정
- 링크 구성이 처리됩니다. 작업이 완료되면 Jira Server의 "애플리케이션 링크" 영역에서 새 링크가 표시됩니다.
Jira Server에 구성된 애플리케이션
- 다음으로 애플리케이션 세부 정보를 구성해야 합니다. 애플리케이션 세부 정보를 편집하려면 애플리케이션의 연필 아이콘을 클릭하세요.
- 구성 대화 상자에서 수신 인증 옵션을 클릭합니다. Consumer Key, Consumer Name, Public Key를 입력하고 선택적으로 설명을 추가합니다.
- 수신 인증 옵션 끝까지 스크롤하여 저장을 클릭하세요. 인증 상태가 이제 확인되었으며, 이 Jira 서버를 Miro 내에서 Jira 카드와 함께 사용할 수 있습니다. Miro 측에서 "Jira Server"와 "OAuth 1.0"을 선택하세요.
사용자 승인
통합이 연결된 후 각 사용자들은 개인적인 Jira 프로필을 연결하여 적절한 권한을 설정해야 합니다. 이는 각 사용자가 Miro에서의 접근 권한이 귀하의 Jira 인스턴스와 정확히 동일하게 보장됩니다. 최종 사용자가 처음으로 Jira 카드를 가져오거나 편집하려고 할 때, 개인 신원 정보를 사용해 Jira에 로그인하라는 요청을 받게 됩니다.
완료된 후에는 사용자가 화이트보드에 카드를 추가할 수 있습니다. Jira에서 변경된 모든 사항은 보드의 Jira 카드에 반영됩니다.
사용자에게 Jira 신원 정보가 없고, 카드가 추가된 보드에 대한 액세스 권한이 있을 경우, 카드의 제목, 이슈 유형, 우선순위, 담당자, 그리고 Jira 카드에 표시되도록 설정된 모든 속성을 볼 수 있습니다. 그러나 승인하지 않으면 카드를 확장해 다른 속성을 보거나 편집할 수 없습니다. 사용자가 Jira 신원 정보를 연결하지 않으면 담당자 아바타가 표시되지 않고 카드의 전반적인 모습이 달라집니다.
여러 Miro 팀에서 하나의 Jira 인스턴스 사용하기
카드는 팀 수준 또는 조직 수준에서 설치할 수 있습니다. 여러 팀이 있는 경우, 각 팀에 대해 설정 절차를 반복하지 않도록 조직 수준의 설정을 활용할 수 있습니다. 기존 애플리케이션 링크는 모든 팀에서 사용됩니다.
팀이나 조직을 Jira 인스턴스에 연결하면, 해당 Miro 팀이나 조직을 위한 새 웹훅이 Jira 웹훅에 생성됩니다. 웹훅을 생성하면 업데이트 요청을 위한 채널이 설정됩니다.
조직 수준의 설정을 지정하면, 이미 연결된 팀은 현재 설정을 유지합니다. 하지만 언제든지 조직 수준 설정으로 전환할 수 있습니다.
추가로, 필요한 경우 팀이 조직 수준 설정을 재정의하여 다른 Jira 인스턴스에 연결할 수 있습니다.
여러 팀 수준 연결을 기본 조직 수준 연결로 마이그레이션하려는 Enterprise 고객이라면, 계정 팀에 문의하세요.
⚠️ 여러 팀을 개별적으로 연결하려면, 각 팀의 웹훅에 고유한 이름을 지정할 것을 권장합니다. Jira 웹훅 페이지로 이동해 새로 생성된 각 웹훅을 편집하세요.
여러 Jira 인스턴스를 하나의 Miro 팀에 연결하는 것은 지원되지 않습니다.
플러그인 끄기
팀 수준 통합을 위해 팀 설정 > 앱 및 통합 > Jira 카드로 이동하세요. 그런 다음 팀에서 제거를 선택합니다.
조직 수준의 통합에서 Jira 앱 사용을 제한하려면 회사 설정 > 앱 > 앱 관리 > Jira 카드로 이동하세요. 그런 다음 토글을 끄기 위치로 이동하세요.
⚠️ 조직에서 Jira를 끄면 모든 Enterprise 팀의 사용자가 Jira 카드를 사용할 수 없습니다. 앱 관리 및 제한에 대해 더 알아보려면 앱 관리를 참조하세요.
추가 정보: Jira 카드 사용 방법을 참조하세요.