Jira 카드와 Jira 애드온의 발생 가능한 문제

Jira Cards 앱이 설치되었지만, Miro 팀은 Jira에 연결되어 있지 않습니다.

설치 가이드를 따르세요: Jira 카드를 설정 및 제거하는 방법 팀 관리자가 아닌 경우, 관리자에게 요청하세요. 

Jira에 대한 요청 실패: 타임아웃이 발생했습니다 / 알 수 없는 호스트 / 연결 거부됨

Jira는 귀사의 인트라넷에서만 액세스할 수 있습니다(잘못된 IP 주소를 사용하여 Jira 시스템과 통신하고 있습니다).

우리의 통합이 필요한 액세스 수준을 제공하도록 허용 목록에 IP 주소, 도메인 및 하위 도메인을 추가하세요. 

Jira Server를 사용 중이고 이전 버전을 사용하는 경우, Dark Features가 Miro에 대한 접근을 차단하지 않는지 다시 확인하세요.

OAuth 1.0에 적용됩니다. (Jira Server & 데이터 센터)만.

당신의 Jira에서 애플리케이션 링크가 올바르게 구성되지 않았습니다

- 링크 또는 웹훅 설정에서 몇 가지 단계를 놓쳤습니다

- Jira 카드를 설정하는 대신 Jira 애드온을 설치했습니다.

Jira 카드 통합을 처음부터 설치해보세요.

웹훅을 수동으로 생성한 경우 자동으로 생성해보세요.

OAuth 1.0에 적용됩니다. (Jira Server & Data Center)만.

Jira 인스턴스에서 애플리케이션 링크가 제대로 구성되지 않았거나 토큰이 만료되었습니다. 애플리케이션 링크를 확인하고 통합을 다시 연결하세요.

Jira의 애플리케이션 링크가 재구성되었습니다

토큰이 만료되었습니다

토큰이 취소되었습니다

애플리케이션 링크가 올바르게 구성되었는지 확인하고 Miro를 Jira 카드에 다시 연결해보세요.

보안이 엄격하게 보호된 Jira를 사용하거나 프록시를 사용하는 경우, 통합에 필요한 액세스 수준을 제공하기 위해 허용 목록">우리의 IP 주소, 도메인, 하위 도메인을 허용 목록에 추가해야 합니다. 

Jira Server를 사용 중이고 구버전인 경우, Miro의 접근을 차단하는 Dark Features가 없는지 다시 확인하세요.

OAuth 1.0에 해당합니다. (Jira Server & Jira 데이터 센터)만.

앱 링크는 URL, 소비자 키, 소비자 이름, 공개 키 외에 더 많은 값을 요구합니다.

구성 메뉴의 인증 발신 탭을 보고 있습니다.

- 입력 인증으로 전환하세요. 아웃고잉 인증은 구성 설정이 필요하지 않습니다.

- 단계를 건너뛸 수 없는 경우, 임시 값을 추가하세요. 애플리케이션 링크 목록 페이지에서 편집 Miro 카드 링크를 클릭하고 임시 값을 삭제하면 나중에 제거할 수 있습니다. 

OAuth 1.0에 적용 가능. (Jira Server 및 데이터 센터)만.

JIRA URL이 유효하지 않습니다 /
Jira 베이스 URL 입력 /
잘못된 요청입니다. 역직렬화합니다.

Jira가 비공개 네트워크에 있거나 회사 방화벽이 외부 네트워크 연결을 차단합니다.

NAT Gateway IP 주소(및 포트)를 허용 목록에 추가하기. 
*당사의 IP 주소를 nslookup으로 확인하면 결과에 부하 분산기의 주소가 표시되며, 이는 시간이 지남에 따라 달라질 수 있습니다.

프록시를 사용하세요 / 외부 및 내부 Jira URL이 일치하지 않습니다.

접근할 수 있는 주소로 Jira URL 필드를 반드시 입력해야 합니다. 따라서, 우리에게 액세스할 수 있도록 역방향 프록시를 구성하거나 Atlassian 가이드</span>의 단계를 따르세요. 이 솔루션을 사용하면 외부 및 내부 URL이 다른 경우에도 통합이 Jira와 Miro 사이의 요청을 성공적으로 연결하고 전달할 수 있습니다.
프록시 서버에서 시간 초과 값을 연장할 수도 있습니다. 이 링크를 통해 자세히 알아보세요.
엔드포인트 목록은 여기에서 찾을 수 있습니다. Jira 카드 자주 묻는 질문

SSL 인증서에 문제가 있습니다(자체 서명된 인증서는 지원되지 않습니다).

Jira 서버에서 활성 SSL 인증서를 확인하세요. 이 도구가 유용할 수 있습니다: Jira URL을 입력하고 연결 검사 결과를 확인하세요.
예: 인증서가 올바른 경우(인증서가 녹색)라도 서버 인증서 체인이 불완전할 수 있습니다(키 교환이 노란색), 따라서 시스템에서는 인증서를 업데이트해야 한다는 응답을 받습니다.
이슈를 해결하려면 이 사이트를 참조하세요.

Jira가 SSO(통합 로그인) 하에 있으며, 수신 인증이 올바르게 구성되지 않았습니다 오류도 발생할 수 있습니다.

통합의 연결 요청에 SSO(통합로그인) 프로세스가 적용되지 않도록 확인하세요. 이를 달성하려면 다음 엔드포인트를 SSO(통합 로그인) 프로세스에서 제외해야 합니다:

POST {JIRA_URL}/plugins/servlet/oauth/요청-토큰
POST {JIRA_URL}/plugins/servlet/oauth/access-token
GET {JIRA_URL}/rest/api/2/serverInfo

설치 중 예기치 않은 동작

Jira 버전 6.4 이하를 사용합니다.

이 Jira 버그로 인해 우리의 카드는 해당 버전에서 작동하지 않습니다. Jira를 최신 버전으로 업데이트해주세요.

앱 인증에 실패했습니다. 앱을 다시 인증해보세요.

일시적인 연결 손실. 클릭해 연결을 다시 시도하세요. 

OAuth 1.0에 적용 가능. (Jira Server 및 데이터 센터)만.

Jira 오류: 웹훅 'Miro'을(를) 만들 권한이 없습니다.

Jira에서 관리자 권한이 없습니다. Jira 관리자에게 요청하여 역할을 관리자 역할로 업그레이드하여 통합을 설정할 수 있도록 하세요.

Jira 요청 실패: PKIX 경로 구축 실패: 요청한 대상에 대한 유효한 인증 경로를 찾을 수 없습니다

서버 인증서에 일부 문제가 있습니다.
 
솔루션으로서, IT 부서에 연락하여 귀하의 측에서 인증서를 확인하도록 요청할 것을 권장합니다 (웹 서버를 다시 로드하고 인증서가 공개적으로 신뢰받는지 확인 등).

Miro를 통해 Jira에서 승인할 수 없음.
오류: 예외 
(예: io.netty.handler.timeout.ReadTimeoutException)

Jira 인프라 설정이 잘못되어 HTTP/2 프로토콜 지원을 나타내지만 이를 사용할 때 데이터 전송이 이루어지지 않을 수 있습니다. 웹 서버의 설정 파일에서 HTTP/2 설정을 확인해 올바르게 설정되었는지 확인하세요.

필요한 경우, 문제 해결 될 때까지 서버 구성에서 HTTP/2 지원을 임시로 꺼서 하위 호환성과 서비스를 중단 없이 유지하세요.

Jira 카드가 업데이트되지 않습니다

OAuth 1.0에 적용 가능. (Jira 서버 및 데이터 센터)만 해당.

수동 웹훅을 사용 중입니다.

통합을 끄고 자동 웹훅을 사용해 다시 연결하세요. 자동 웹훅이 정상적으로 작동하면 수동 웹훅이 잘못 구성되었음을 의미합니다.

또한, Jira 카드에 웹훅을 설정하는 방법을 참조하세요. 

OAuth 1.0 및 OAuth 2.0에 적용 가능함 (Jira Server 및 데이터 센터).

자동 웹훅을 사용 중인 경우 첫 번째 문제 해결 단계는 통합을 다시 연결하는 것입니다. 그래도 도움이 되지 않는다면, Jira 카드가 더 이상 업데이트되지 않는 몇 가지 이유가 있을 수 있습니다. 예를 들면:

- Miro 보드가 다른 팀으로 이동되었거나 백업을 통해 다운로드되었습니다.

Jira 이슈가 한 프로젝트에서 다른 프로젝트로 Jira 측에서 이동되었습니다

Jira 이슈가 있는 프로젝트에 액세스할 수 없습니다.

- (Enterprise 한정) 보드 소유자가 비활성화되었거나 제한된 무료 라이선스를 보유하고 있습니다

- (OAuth1.0 전용) 현재 브라우저에서 사용 중인 Jira 인스턴스와 동일한 Jira 인스턴스에 Jira 카드가 있지 않습니다

OAuth 1.0에 적용 가능 (Jira Server & 데이터 센터) 전용.

Jira 카드가 귀하 쪽에서 변경 없이 업데이트가 중단됐고, 재연결을 시도할 때 당신의 Jira에 있는 애플리케이션 링크가 제대로 구성되지 않았습니다.

오류 메시지는 승인 오류로 인해 Miro가 연결된 Jira 요청을 할 수 없을 때 나타날 수 있습니다.승인 오류.</span> 사용자가 통합을 설정한 후 <span>토큰을 취소하거나, Jira에서 발급된 토큰의 수명이 짧게 설정되었을 경우, 해당 시간이 지나면 토큰이 단순히 무효화되고, Miro가 Jira에 접근할 수 있는 새로운 유효 인증 토큰을 얻기 위해 다시 연결해야 합니다.

카드 편집 옵션이 빈 창을 반환합니다

OAuth 1.0에 적용 가능. (Jira 서버 및 데이터 센터)만.

Jira 버전을 사용합니다. 7.6 이상

보안상의 이유로 Atlassian에서는 iFrame에 콘텐츠 임베드를 허용하지 않을 수 있으며, 이는 Jira 카드 편집을 위한 팝업 창에도 영향을 미칠 수 있습니다. 이 지침을 해결 방법으로 사용할 수 있습니다.

Jira 카드를 추가할 수 없습니다

OAuth 1.0에 적용 가능 (Jira 서버 및 데이터 센터) 전용.

수동 웹훅을 생성했으며 설정 정보를 저장하지 않았습니다.

Jira URL 필드가 Miro 설정에서 입력되어 있는지 확인하세요. 연결을 클릭하세요

편집 아이콘이 표시되지 않습니다

OAuth 1.0에 적용 가능. (Jira 서버 및 데이터 센터)만.

Jira 서버 버전 7.6 이상을 사용합니다.

이 버전의 보안 업데이트로 인해 편집 아이콘이 표시되지 않을 수 있습니다.

해당 Jira 이슈를 프로필에서 편집할 수 없습니다.

Jira 측에서 이슈를 열어 놓은 상태에서 편집 모드에 액세스할 수 있는지 확인하세요.

메시지를 받습니다. 로그인되어 있지 않으며 게스트로 선택된 이슈에 대한 작업을 수행할 수 있는 권한이 없습니다. 로그인해 주세요

우리의 통합 방식이 쿠키를 사용하기 때문에 이 페이지에서 Jira에 로그인할 수 없을 수도 있습니다.

다른 브라우저 탭에서 Jira에 로그인하세요.
브라우저에서 타사 쿠키가 허용되어 있는지 확인하세요.

귀하의 Jira는 SSO(통합로그인) 아래 있으며, IdP가 iframe을 통한 인증을 허용하지 않습니다.

Miro 데스크톱 앱에서 작업 중이라면, miro.com의 Miro 브라우저 버전으로 전환할 것을 권장합니다.

특정 프로젝트를 선택할 때 Miro에서 Jira 카드를 변환하거나 생성할 수 있는 옵션이 없습니다.

- 이슈 유형 필드에 데이터가 없습니다.

변환/생성 버튼이 비활성 상태입니다.

Jira에서 프로젝트에 액세스할 수 없습니다. 액세스 권한을 받을 수 있는지 확인하세요.

Jira 이슈를 만들 수 없습니다 Jira 카드를 변환/생성하려고 할 때: 

Jira 이슈를 생성할 수 있는 권한이 없습니다.

Jira 관리자에게 문의하여 필요한 권한을 요청하세요. 다음과 같이 표시됩니다:

일부 사용자 지정 필드가 Jira 이슈로 변환/Jira 이슈 편집 메뉴에 표시되지 않습니다.

Jira 이슈를 만들 수 없습니다. 필수 필드(...)는 지원되지 않습니다Miro 내에서 Jira 이슈를 만들 때 오류 발생

보드에서 Jira 카드 선택기의 필드가 활성화되어 있지 않습니다.

인앱에서 Jira 선택기를 사용해 사용자 지정 필드를 설정하려면 이 가이드의 단계를 따르세요.

카드에 표시할 필드 선택 옵션에 Jira의 사용자 지정 필드가 나타나지 않는 경우, Jira 인스턴스의 프로젝트에 설정된 일부 스크린이 Miro에서 필드를 차단할 수 있습니다.

프로젝트 설정 > 화면 > 기본 화면 스키마로 이동하여 필요한 필드가 허용되었는지 확인하세요.

Miro는 복잡한 데이터 유형 필드를 지원하지 않습니다.

Miro는 기본 사용자 지정 필드는 지원하지만 복잡한 필드는 지원하지 않습니다. Jira 카드 필드 구성 및 지원되지 않는 필드 제거

Jira 카드를 편집하거나 생성할 때 보고자를 선택할 수 없습니다

Jira의 생성 메타데이터에는 보고자 필드가 없습니다: 선택한 프로젝트의 Jira 생성화면에서 해당 필드를 사용할 수 없습니다.

프로젝트 설정 > 스크린으로 이동하여 생성 스크린에 보고자 필드가 있는지 확인합니다.

선택한 프로젝트에서 이슈의 보고자를 설정할 수 있는 권한이 없습니다. 

Jira 관리자에게 문의해 액세스 수준을 확인하고, 선택한 프로젝트에서 Reporter 필드를 설정/변경할 권한이 있는지 확인하세요. 이를 위해, Jira에 로그인한 후, 설정 > 이슈 > 권한 스키마로 이동하고, 작성자 수정 필드를 확인해야 합니다 (또한 애플리케이션 액세스 추가: 로그인한 사용자 목록에 없는 경우:

감사 추적을 위해 보고자 필드는 편집할 수 없으며, 이슈를 생성한 사람으로 설정됩니다.

필드를 사용할 수 없는 것은 예상된 동작입니다.

일부 필드는 카드의 편집 모드에서 표시되지만 Jira 카드가 보드에 나타나지 않습니다.

Miro가 Jira로부터 업데이트를 받지 못합니다.

• 다른 네트워크로 전환
• 통합을 다시 연결하세요.

OAuth 1.0에 적용 가능. (Jira Server 및 데이터 센터)만.

Jira를 사용할 수 없습니다 Jira 카드 앱 설정 오류

1. 팀 관리자에게 통합을 끄고 다시 연결해달라고 요청하세요.

2. Jira가 방화벽, 보안 방해 요소 등으로 보호되어 있어 Miro에서 접근할 수 없습니다.

Miro와 Jira 간에 Jira 카드가 동시에 동기화된다면, 귀하의 Jira가 우리에게 웹훅을 보낼 수 있다는 의미입니다. 그래서 보드의 업데이트를 볼 수 있습니다.

해결책으로, IT 부서와 이슈에 대해 논의하고 Miro가 적절히 허용되었는지 다시 확인하도록 요청하는 것을 추천합니다. 

Jira Server를 사용 중이고 버전이 오래된 경우, Dark Features가 Miro에 대한 접근을 차단하지 않는지 다시 확인하세요.

OAuth 1.0에 적용 가능. (Jira Server 및 데이터 센터)만 해당.

Jira 웹훅 이슈 Jira 카드 앱 설정에서 오류

- Jira 측에서 웹훅을 변경/삭제했습니다
- Miro가 Jira에서 '잘못된 요청' 응답을 받았습니다.

보드에 Ctrl + V(Windows의 경우)/Cmd + V(Mac의 경우)를 사용해 Jira 이슈 링크를 붙여넣을 때, 이는 URL로 붙여넣어지며 Jira 카드로 변환되지 않습니다.

보드를 아직 로드하고 있습니다. 더 큰 보드나 이미지가 크거나 PDF 문서가 있는 보드에서 발생할 수 있습니다.

보드를 열고 보드가 완전히 로드될 때까지 적어도 10초를 기다려주세요. 그런 다음 링크를 다시 붙여넣어 보세요.

보드의 Jira 카드에 설명이 표시되지 않습니다.

카드 세부 정보를 보려면 카드를 클릭하고 확장을 선택해 보드의 사이드바에서 카드 세부 정보를 확인하세요. 

0개의 일치하는 스프린트 중 0개 표시

1. 활성화된 스프린트나 예정된 스프린트가 없는 경우(모두 종료되었거나 완료됨) 발생합니다.

2. Jira의 필터에 프로젝트가 포함되지 않았습니다. 보드 필터에 필요한 프로젝트를 JQL에 추가하세요. 그렇게 하면 스프린트가 Jira와 Miro 모두에 표시됩니다.

OAuth 1.0에 적용됩니다. (Jira 서버 및 데이터 센터)만.

SSL 연결 실패

이 오류는 Miro가 Jira에 접근할 수 없음을 의미합니다.

Miro 팀 관리자에게 연락해 Jira 카드 설정의 Jira 기본 URL 필드에 연결할 수 있는 주소가 포함되어 있는지 확인해 달라고 요청하세요.

Jira에서 사용자 탐색 권한을 글로벌 수준으로 설정했는지 확인하세요. 전역 권한 관리 방법에 대해 자세히 알아보세요. 

유감스럽게도, 저희 플러그인이 쿠키를 사용하기 때문에 Jira에서 이 페이지에서는 로그인할 수 없습니다.

다른 브라우저 탭에서 Jira에 로그인하세요.

애드온 페이지에서 설치 버튼을 클릭한 후 다음 오류가 발생할 수 있습니다:

잠깐 연결이 끊겼습니다.

이 경우, 1분 후에 설치를 다시 시도하세요.

Jira 애드온 설정 중 또는 설정 후 일부 단계에서 다음 페이지로 넘어갈 수 없습니다.

쿠키나 캐시에서 문제가 발생하여 프로세스가 중단되었습니다.

브라우저의 메모리에서 도메인 atlassian.com을 지우고 다시 시도하세요.

성공적인 설치 후 Miro에 등록되지 않은 Jira 사용자는 첨부된 보드 대신 Miro 로그인 메뉴를 보게 됩니다.

Jira 정책이 일부 플러그인 기능을 차단합니다. 

안타깝게도 이 동작은 최근 Jira API 업데이트로 인해 발생하며 현재 수정할 수 없습니다.

Addon은 인증 정보를 기억하지 못하고 매번 로그인을 요청합니다.  

Jira 이슈에 보드를 추가하려고 하면 '죄송합니다. 통합을 사용할 수 없습니다'라는 오류가 보드 선택기에 표시됩니다.

브라우저에서 타사 쿠키가 차단되었습니다.

해결책으로, 브라우저에서 쿠키를 활성화하는 방법에 대한 지침을 따르세요. 이 문제는 주로 Mozilla와 Safari에서 발생하며, 이들의 새로운 보안 정책 때문입니다.
Safari의 경우, 이 솔루션도 도움이 될 수 있습니다.