이 문서에서는 Jira 카드 통합이 어떻게 구성되어 있는지에 대한 가장 일반적인 질문에 답합니다.
Jira와 Miro 간 인증은 어떻게 작동하나요?
다음 도움말 센터 문서를 참조하세요
- Jira Server(온프레미스)
- Jira 데이터 센터(온프레미스)
-
Jira Cloud
Jira 카드 설정 페이지에서 선택하세요.- OAuth 2.0 (3LO)
Jira와 Miro 간 전송 중 데이터는 안전하게 보호되나요?
TLS 보안 프로토콜을 사용합니다. 이 프로토콜은 전송 전에 HTTP 메시지를 암호화하고 도착 시 해독합니다. 또한 Enterprise 플랜에서는 상호 TLS도 지원합니다.
상호 TLS를 지원하나요?
예, 자세히 알아보기.
Miro가 고객의 Jira 데이터를 보유하나요?
예. Miro는 보드에 추가된 카드의 데이터를 보유합니다.
보유 기간은 얼마나 되며 데이터는 어떻게 보호되나요?
OAuth 1.0(Jira Server 또는 Data Center)인 경우에도 Jira 카드 플러그인 설정 과정에서 웹훅을 구성하면 데이터가 업데이트됩니다. 보유 기간은 무제한이며 일반적인 Miro 보안 프로토콜만 적용됩니다.
Miro에서 가져오는 정보를 제한할 수 있나요?
Atlassian 문서에서 특정 필드로만 정보를 제한하는 방법에 대한 언급을 찾지 못했습니다.
Jira와 Miro 간의 데이터 흐름을 보여주는 다이어그램을 받을 수 있나요?
자세한 정보는 이 Jira 개발자 문서에서 확인할 수 있습니다. Miro는 Atlassian 문서에 따라 통합을 구현합니다.
토큰은 어떻게 처리되나요?
OAuth 1.0: 액세스 토큰만 사용합니다. 액세스 토큰은 5년 동안 유지되며 Atlassian 측에서 정책이 정해져 있어 변경할 수 없습니다. Jira 측의 웹 UI에서 토큰을 취소할 수 있습니다. 새 토큰이 발급되면 통합이 중단되며 다시 연결해야 합니다.
OAuth 2.0: 액세스 토큰은 1시간 동안 유효합니다. 리프레시 토큰은 90일 동안 유효하며, 통합을 90일 동안 사용하지 않으면 다시 인증해야 합니다.
고객의 모든 Jira 액세스에 단일 액세스 토큰을 사용하나요?
Jira 카드를 가져오거나 생성하거나 편집하려는 모든 Miro 사용자는 각자의 Jira 신원 정보를 연결해야 합니다. 앞서 언급한 모든 작업은 개인 Jira 신원 정보로만 수행할 수 있습니다.
요청 토큰, 액세스 토큰, 개인 키 및 기타 OAuth 비밀/신원 정보는 어떻게 보호되나요?
통합 중에는 액세스 토큰만 사용됩니다. 이 토큰은 데이터베이스에 안전하게 저장되며 서버 측에서만 사용됩니다.
OAuth 1.0. (Jira Server and Data Center)의 경우 authToken은 웹훅 용도로만 사용됩니다. 이는 OAuth에서 사용하는 실제 인증 토큰이 아닙니다. 요청은 암호화된 연결을 통해 전송됩니다. 비밀 키는 자동으로 생성되며 팀별로 연관됩니다.
통합에서 사용하는 엔드포인트는 무엇인가요?
POST /rest/api/2/issue - create new issue
PUT /rest/api/2/issue/id - update issue
GET /rest/api/2/user/picker?query=xx
GET /rest/api/2/myself
GET /rest/api/2/filter/favourite
GET /rest/api/2/issue/picker
GET /rest/api/2/serverInfo
GET /rest/api/2/issue/$key
GET /rest/api/2/issue/createmeta
GET /rest/api/2/issue/$key/editmeta
GET /rest/api/2/priority
GET /rest/api/2/issuetype
GET /rest/api/2/mypermissions
OAuth 1.0(Jira Server 및 Data Center)의 경우 추가로 다음을 사용합니다:
POST /rest/webhooks/1.0/webhook
Jira 카드를 Jira Datacenter에서 사용할 수 있나요?
네. Atlassian의 승인을 받았으며 이미 많은 고객이 Jira Datacenter에서 Jira 카드를 성공적으로 사용하고 있습니다. 설치 절차는 동일합니다.
Jira 시스템과 통신할 때 어떤 IP를 사용하나요?
정적 IP 주소 목록은 여기에서 확인할 수 있습니다.
이 주소들은 Jira 시스템과 통신할 때만 사용된다는 점을 참고하세요. Miro 앱의 IP는 동적이며, Miro 보드의 모든 기능(일부 Jira 카드 관련 기능 포함)이 정상적으로 동작하려면 Miro 도메인을 허용 목록에 추가하세요.
Jira를 Miro에 통합하되 Security Level이 "Private"로 설정된 Jira 이슈를 차단할 수 있나요?
아니요, 불가능합니다. Jira의 Security Level은 Miro와 연동되지 않습니다.
Jira 서버를 사용하는 경우 Miro를 Jira에 연결할 수 있나요?
Miro는 온라인 도구여서 인스턴스가 공용 인터넷에 공개되어 있을 때만 Jira에 연결할 수 있습니다.
여러 개의 Jira 인스턴스를 동시에 연결할 수 있나요?
가능합니다. 다만, Jira 인스턴스를 연결하는 것은 초기 링크를 설정하는 것이고 활성 연결은 현재 사용 중인 연결된 인스턴스를 의미한다는 점을 유의하세요. 활성 연결은 Jira Cards 앱을 열 때 Jira 카드를 어느 인스턴스에서 가져오는지와 사용자가 어떤 인스턴스에 대해 권한이 있는지를 결정합니다. 한 사용자는 동시에 하나의 활성 연결만 가질 수 있습니다. OAuth 2.0을 사용하면 사용자는 이미 인증된 연결된 인스턴스에 있는 모든 Jira 카드를 편집할 수 있습니다. 다른 인증 프로토콜을 사용하는 경우에는 팀 전체가 하나의 활성 인스턴스를 공유하며 해당 인스턴스의 카드만 가져오고 상호작용할 수 있습니다. 조직 수준에서 여러 설정을 정의하고 팀 수준에서 활성 연결을 전환할 수 있습니다.
서버에서 클라우드로의 마이그레이션 프로세스는 무엇인가요?
Jira 기본 URL은 Cloud로 마이그레이션하는 동안 변경되므로 Miro 측에서 조치를 취하지 않으면 통합이 중단됩니다. 도움이 필요하면 Miro 지원에 문의하세요.
Miro는 웹훅을 팀별, 프로젝트별, 아니면 Miro 인스턴스별로 생성하나요?
Miro 설정에서 Automatic Webhook을 활성화하면 웹훅이 자동으로 생성됩니다. Jira에서 팀 수준 권한 부여를 사용하는 경우 Miro는 팀별로 웹훅을 생성합니다. 조직 수준 권한 부여를 사용하는 경우 Miro는 조직별로 웹훅을 생성합니다.
Jira Cards 플러그인이 Next-Gen 프로젝트를 지원하나요?
예, 지원합니다.
참고로 현재 Miro 측에서는 Next-Gen 프로젝트용 Jira 카드를 생성할 때 Epic 링크/필드가 없습니다.
사용자 지정 Jira 필드가 지원되나요?
예, 대부분의 기본 유형 사용자 지정 필드를 지원합니다. 만약 복잡한 데이터 유형 필드가 있는 경우 지원되지 않을 수 있으며 보드에서 Jira 카드를 업데이트하거나 생성할 때 예기치 않은 동작을 일으킬 수 있습니다.
다른 Jira 인스턴스로 전환하면 기존 Jira 카드에는 어떤 일이 발생하나요?
현재 Jira에서 이슈를 한 프로젝트에서 다른 프로젝트로 이동하면 Miro 측에서는 더 이상 업데이트되지 않습니다.
우회 방법으로는 Jira 이슈 URL을 복사(Ctrl/Cmd+C)해 Miro 보드에 붙여넣기(Ctrl/Cmd+V)할 것을 권장합니다. 이렇게 하면 Jira 카드에 새 값이 표시되며 자동으로 업데이트됩니다.
보드가 다른 Miro 팀으로 이동되면 보드의 Jira 카드에는 어떤 영향이 있나요?
Jira 카드는 보드에 그대로 남아 있지만 아무도 수정할 수 없습니다(대상 팀에 동일한 Jira 인스턴스가 설정되어 있더라도).
카드를 클릭하면 다음 메시지가 표시됩니다: “Jira 카드를 다른 계정에서 가져왔습니다”. 카드를 편집 가능하게 하려면 보드에 다시 가져오세요.
Jira 카드 통합에 추가 비용이 있나요?
Jira 카드는 Starter, Business, Education, Enterprise 등 모든 유료 플랜과 Education 플랜에서 추가 비용 없이 사용 가능합니다.
사용자가 보드의 모든 Jira 카드를 접근할 수 있나요?
Jira 카드 통합의 권한 설정은 사용자가 접근 권한이 있는 Jira 프로젝트에서만 카드를 생성·편집할 수 있도록 보장합니다.
모든 Miro 보드의 위젯은 보드 접근 권한이 있는 모든 사용자에게 보이므로, 어떤 사용자가 Jira 신원 정보가 없거나 적절한 신원 정보가 없는 경우 보드에서는 접힌 상태의 Jira 카드(제목 및 일부 필드만 표시)를 볼 수 있을 뿐, 카드를 펼쳐 전체 내용을 확인하거나 수정할 수는 없습니다.
Atlassian이 Jira Server에 대한 지원을 중단했나요?
예, Atlassian은 2024년 2월부로 Jira Server에 대한 지원을 중단했습니다.
Miro 플래너/Jira 카드는 Jira의 사용자 지정 필드인 사용자 지정 이슈 유형 및 사용자 지정 종속성을 지원하나요?
예, 둘 다 지원됩니다. Jira에서 사용자 지정 이슈 유형과 사용자 지정 종속성 필드가 설정되어 있고 그리고 해당 Jira 인스턴스에 Miro 플래너가 인증되어 있다면 이 사용자 지정 필드는 플래너에서 사용 가능합니다.
Miro는 Jira Data Center에서 OAuth 2.0을 지원하나요?
예. 자세한 내용은 OAuth 2.0을 사용해 Jira Data Center에 연결하기를 참조하세요.
Jira 이슈를 테이블과 타임라인으로 어떻게 가져오나요?
하나 또는 여러 개의 Jira 카드를 테이블이나 타임라인으로 직접 끌어서 놓을 수 있습니다. 현재로서는 이 방법만 지원됩니다.
테이블에서 Jira와 연결되는 필드는 무엇인가요?
Jira 시스템 필드:
- 제목
- 설명
- 종료일(Jira의 마감일)
- 담당자
- 상태
사용자 지정 Jira 필드: - Jira 필드 추가로 추가한 모든 사용자 지정 필드와 자동으로 매핑되는 다음 필드: 시작일, Estimate. 테이블에 사용자 지정 필드를 추가하려면 테이블 상단의 더하기(+) 버튼을 클릭하고 Jira 필드 추가를 선택하세요. 그런 다음 동기화할 사용자 지정 필드를 선택하세요.
테이블에서 어떤 필드가 Jira와 동기화되지 않나요?
셀을 클릭하면 어떤 필드가 Jira와 동기화되는지 확인할 수 있습니다. 동기화되는 필드에는 Jira 로고가 표시됩니다. 그 외의 모든 필드는 Miro에만 저장되며 Jira와 동기화되지 않습니다.
위에서 지원되는 다섯 가지 Jira 필드 중 테이블이나 타임라인에서 필드를 편집할 수 없는 이유는 무엇인가요?
해당 필드가 Jira의 편집 화면에 없을 수 있습니다.
해당 필드가 편집 화면에 있는지 확인하는 쉬운 방법은 다음과 같습니다:
Miro에서 Jira 카드의 측면 패널을 엽니다. 측면 패널에 해당 필드가 있는지 확인하세요. 필드가 없으면 Jira의 편집 화면에 그 필드를 추가해야 합니다.
일부 드문 경우에는 Jira에서 필드를 편집할 수 있지만 Jira의 편집 화면에는 표시되지 않는 경우가 있습니다. 이 경우 해당 필드는 Miro에서 편집할 수 없습니다.
편집할 수 없는 필드가 Start date 또는 Estimate인가요? 그렇다면:
해당 필드가 Jira에 없거나 편집 화면에 누락되어 있을 수 있습니다(이전 항목 참조)
시작일이나 추정은 Jira에서 사용자 지정 필드이므로 매핑 문제가 있을 수 있습니다.
다음 규칙에 따라 이 필드들을 매핑합니다:
- 시작일: 다음 이름의 필드를 확인합니다: Start Date, StartDate, Target Start
- 추정: 다음 이름의 필드를 확인합니다: Story Points, Story point estimate, Story Point, StoryPoints, StoryPoint
- 위에 나열된 이름 중 하나로 시작일 또는 추정 필드 이름이 지정되어 있지 않으면 편집이 작동하지 않는 이유일 수 있습니다.
Miro의 테이블 또는 타임라인에서 시작일이나 추정 필드를 편집해도 작동하지 않거나 Jira에서 잘못된 필드가 업데이트되는 이유는 무엇인가요?
현재 Jira의 Start Date 및 Estimate 필드는 자동 매핑에 의존하고 있습니다. 이 필드들은 Jira에서 사용자 지정 필드여서, Jira 구성에서 위에 언급한 기준과 일치하는 필드가 여러 개 있을 수 있습니다.
우리는 위에 나열된 필드명 순서에 따라 첫 번째로 일치하는 필드를 선택합니다:
예를 들어, 한 Jira 이슈에 Story Points와 Story point estimate 필드가 모두 있는 경우, 위 목록 기준에 따라 먼저 일치하는 필드인 Story Points를 매칭합니다. 따라서 테이블에서 Estimate 필드를 변경하면 Jira의 Story Points 필드가 업데이트되며, Story point estimate 필드는 업데이트되지 않습니다.
현재로서는 이 문제에 대한 우회 방법이 없습니다. 이 문제가 발생하면 지원팀에 피드백을 보내주세요. 더 발전된 필드 매핑 기능을 개발할 때 요구 사항을 더 잘 파악하는 데 도움이 됩니다.
테이블이나 타임라인에 서로 다른 두 Jira 인스턴스의 Jira 카드를 가져올 수 없는 이유는 무엇인가요?
현재 테이블/타임라인당 하나의 Jira 인스턴스만 지원합니다. Jira 카드가 테이블/타임라인으로 가져오면, 해당 테이블/타임라인은 그 특정 Jira 인스턴스에 연결됩니다.
모든 Jira 레코드를 삭제해도 원래의 Jira 인스턴스와의 연결은 유지됩니다. 다른 Jira 인스턴스의 카드를 가져오려면 새 테이블/타임라인을 만들어야 합니다.
테이블이나 타임라인에서 Jira 레코드의 상태 및 담당자 필드를 볼 수 없거나 편집할 수 없는 이유는 무엇인가요?
현재 Jira의 상태 및 담당자 필드는 테이블과 타임라인에서 지원되지 않습니다. 사용자 기대를 관리하고 혼동과 잠재적 데이터 손실을 피하기 위해 이 필드들을 테이블과 타임라인에서 끄기로 했습니다. 해당 필드와 그 내용은 Jira에 존재하지만 테이블이나 타임라인에는 표시되지 않습니다.
측면 패널을 사용해 Jira 카드에서 해당 필드를 직접 편집할 수 있습니다. 테이블이나 타임라인의 행을 캔버스로 드래그하면 Jira 카드가 다시 나타납니다.
자세한 정보: