관리자용: Jira용 Lucid 카드 구성

실시간 동기화를 위한 Jira Cloud 인스턴스 설정

다음 단계를 완료하려면 Jira 및 Lucidspark 관리자 권한이 모두 필요합니다. 이 통합을 설정하는 관리자에게 Lucidspark 라이선스가 있어야 합니다. 또한 Jira 서비스 계정 또는 Jira 관리자 계정을 사용하는 것을 권장합니다.

Lucid와의 실시간 동기화를 위해 Jira Cloud 인스턴스를 설정하려면 계정 관리자가 Lucid에서 다음 단계를 완료하면 됩니다. 

1. Lucid Home Page에서 탐색 메뉴 왼쪽 하단에 있는 관리자를 클릭합니다.
2. 왼쪽 메뉴에서 앱 통합 을 클릭합니다. 
3. 드롭다운에서 Lucidspark를 선택합니다.
4. Jira Cloud용 Lucid 카드 타일을 찾아 설정을 클릭합니다.
5. 새 인스턴스 추가를 선택합니다.
   

Jira Cloud 설정 페이지가 열리면 다음 단계를 따르세요.

1. '권한 부여 대상' 드롭다운 메뉴에서 Lucidspark용 Jira 인스턴스를 선택합니다.
2. 수락 을 클릭합니다.
   
3. Jira 인스턴스 자격 증명으로 인증하려면 연결 을 클릭합니다.
4. 제출을 선택합니다.

이제 실시간 동기화를 위해 통합이 설정되었습니다. 

Jira Data Center 인스턴스 활성화

아래 단계에 따라 Jira Data Center 인스턴스를 설정하세요. 새 통합에는 OAuth 2.0 사용을 권장합니다. 이전에 Application Links(OAuth 1.0)를 사용하여 계정을 연결했다면 전환할 필요가 없으며, 기존 연결은 계속 작동합니다. OAuth 1.0에 대한 지원이 필요한 경우 이 커뮤니티 게시물을 참조하세요.

이 섹션에 표시된 Jira 메뉴는 Jira Data Center 버전에 따라 다를 수 있지만, 일반 설정 프로세스는 동일합니다.

Lucid 서버에서 Jira 인스턴스 액세스 가능 여부 확인

외부 공개용 DNS를 설정하고 아래에 나열된 고정 IP로부터의 인바운드 요청을 허용해야 합니다.

FedRAMP 환경을 사용하는 경우 아래 나열된 고정 IP로부터의 인바운드 및 아웃바운드 요청을 허용해야 합니다.

OAuth 2.0을 사용하여 Lucidspark를 Jira Data Center에 연결

다음 단계를 완료하려면 Lucidspark 라이선스 외에도 Jira 및 Lucidspark 관리자 권한이 모두 필요합니다.

1단계: Jira Data Center에서 OAuth 2.0 애플리케이션 만들기

다음과 같이 Jira Data Center 인스턴스에서 인바운드 OAuth 2.0 애플리케이션 링크를 만듭니다.

1. Jira에서 Jira 설정으로 이동하세요.
2. 애플리케이션으로 이동합니다.
3. 애플리케이션 링크를 선택하세요.
4. 링크 만들기를 선택합니다.
5. “수신” 방향의 외부 애플리케이션을 선택하세요.
6. 계속을 선택합니다.
7. 애플리케이션 이름을 설정합니다.
   • 선택하는 이름은 “Lucidspark”와 같이 Jira용 Lucid 카드 기능을 나타내는 이름이어야 합니다.
   • 리디렉션 URL을 'https://lucid.app/jiradatacenter/oauth2/callback'으로 설정합니다.
8. 애플리케이션 권한에 ADMIN을 포함하도록 설정합니다.
9. 생성된 클라이언트 ID와 클라이언트 시크릿을 저장 및 복사합니다.

2단계: Lucid에서 연결 구성

1. Lucid에서 홈페이지 왼쪽 하단 모서리에 있는 메뉴에서 관리자를 선택합니다.
2. 왼쪽 메뉴에서 앱 통합을 선택합니다.
3. 드롭다운 메뉴에서 Lucidspark를 클릭합니다.
4. 'Jira Data Center용 Lucid 카드' 타일을 찾습니다.
5. 타일에서 설정을 클릭합니다(이전에 통합을 설정하지 않은 경우 설치).
6. 새 인스턴스 추가 (또는 이전에 통합을 설정하지 않은 경우 설정 시작)를 선택합니다.
7. 리디렉션 URL이 Jira의 애플리케이션 링크에서 구성한 내용과 일치하는지 확인합니다.
8. Jira에서 클라이언트 ID 및 클라이언트 시크릿을 입력합니다.
9. Jira Data Center 인스턴스 URL을 입력합니다.
   • 예를 들어 “https://jira.yourcompany.com”과 같이 표시될 수 있어요.
   • 인바운드 트래픽이 인스턴스에 도달하기 전에 차단하도록 리버스 프록시를 구성한 경우, 해당 리버스 프록시의 URL을 제공하면 됩니다. 해당 리버스 프록시는 여기에 나열된 당사 IP로부터의 인바운드 트래픽을 허용해야 합니다.

3단계: 연결 승인하기

1. OAuth 2.0 인증 흐름을 시작하려면 활성화를 클릭하세요.

액세스 승인을 위해 Jira Data Center 인스턴스로 리디렉션됩니다. 승인 후 Lucid로 다시 리디렉션됩니다. 이제 실시간 동기화를 위한 통합 설정이 완료되었습니다.

관리자 설정이 완료되면 최종 사용자는 자신의 Jira 자격 증명으로 인증하여 Lucidspark에서 Jira 이슈를 가져오고 생성할 수 있습니다. 각 사용자는 처음 연결할 때 Jira Data Center 동의 화면으로 리디렉션됩니다.

Jira로 SSO 인증을 사용하는 계정의 경우

Lucid의 서버를 Jira Data Center 인스턴스에 연결할 수 있어야 합니다. Jira Data Center 인스턴스가 SSO 제공업체에 의해 보호되는 경우 문제가 발생할 수 있습니다. SSO는 브라우저에서 사용자를 인증하도록 설계되어 있어, API 호출을 하는 백엔드 서비스로는 완료하기 어려운 경우가 많기 때문입니다.

이 문제를 해결하는 방법은 사용 중인 SSO 및 네트워크 설정에 따라 다릅니다. Lucid의 서버 간 트래픽이 SSO 차단을 우회하도록 SSO 또는 네트워크 인프라를 구성해야 합니다. 일반적인 방법으로는 SSO 계층에서 경로 기반 예외 처리를 적용하거나 Lucid 트래픽이 SSO를 완전히 우회하도록 라우팅하는 것이 있습니다. 

SSO와 함께 OAuth 1.0 사용하기

OAuth 1.0 Application Links의 경우, 이 커뮤니티 게시물에서 Atlassian 해결 방법을 확인하세요.

실시간 동기화를 위한 Atlassian Government Cloud 인스턴스 설정

다음 단계를 완료하려면 Jira 및 Lucidspark 관리자 권한이 모두 필요합니다. 이 통합을 설정하는 관리자에게 Lucidspark 라이선스가 있어야 합니다. 또한 Jira 관리자 계정을 사용하는 것을 권장합니다.

Atlassian Government Cloud 인스턴스를 Lucid와 실시간 동기화하도록 설정하려면 계정 관리자가 Lucid에서 다음 단계를 완료하면 됩니다. 

1. Lucid Home Page에서 탐색 메뉴 왼쪽 하단에 있는 관리자를 클릭합니다.
2. 왼쪽 메뉴에서 앱 통합을 클릭합니다. 
3. 드롭다운에서 Lucidspark를 선택합니다.
4. 새 Atlassian Government Cloud 인스턴스 추가를 클릭합니다.
5. 권한을 검토하고 수락을 클릭하세요.

이제 실시간 동기화를 위해 통합이 설정되었습니다. 

자주 하는 질문(FAQ)

필수 사항이 아닌데도 관리자로서 Jira Cloud 또는 Atlassian Government Cloud 통합을 활성화해야 하는 이유가 있나요?
2023년 1월부터 Lucidspark는 웹훅을 사용하여 Jira에서 데이터를 동기화합니다. 이번 업데이트를 통해 보드는 Jira에서 실시간으로 업데이트를 수신할 수 있습니다. Lucidspark는 이 문서에 설명된 통합 설정 단계를 통해 일회성 인증을 완료한 후에만 웹훅을 생성하고 관리합니다. 사용자가 이러한 단계를 완료하기 전에 통합을 개별적으로 설치하면 통합은 작동하지만, 카드는 실시간이 아닌 약 2분마다 Jira에서 업데이트를 동기화합니다.

Jira Data Center에서 Lucid 카드 통합을 설정하는 동안 오류 메시지가 나타나면 어떻게 해야 하나요?
Jira Data Center 통합을 설정할 때 애플리케이션 오류가 발생하면 이 Jira Data Center용 Lucid 카드 구성 시 발생하는 일반적인 오류 해결을 위한 팁 커뮤니티 게시물을 참조하세요.

이 통합은 어떻게 작동하며 어떤 권한이 필요한가요?
이 통합의 작동 방식과 사용자 또는 관리자 Jira 자격 증명 보유 여부에 따른 권한에 대한 자세한 설명은 Jira용 Lucid 카드 기술 FAQ 리소스를 참조하세요. 이 리소스에는 관리자 자격 증명 사용 방법, 웹훅과 그 이점, Jira 데이터 보호 방법에 대한 심층적인 내용이 포함되어 있습니다.

Atlassian Government Cloud 인스턴스에서 Jira용 Lucid 카드 통합을 설정하려고 할 때 왜 lucid.app으로 리디렉션되나요?
lucid.app으로 리디렉션되는 것을 방지하려면 Jira용 Lucid 카드 통합을 설정하기 전에 SSO를 사용하여 Atlassian Government Cloud 인스턴스에 로그인해야 합니다.

리소스

이 통합 기능을 성공적으로 사용하는 데 도움이 필요하면 아래 추가 리소스를 참조하세요. 리소스는 영어로만 제공됩니다.

커뮤니티 게시물

Jira 문제 해결: Lucid에서 필드를 편집할 수 없음 - 오류 메시지 “Edit not supported”
Jira 문제 해결: 동적 테이블에 다른 언어가 열로 추가됨

이 문서에 관한 피드백 공유