기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Atlassian Jira Cloud 통합
Atlassian Jira Cloud 작업 커넥터를 사용하여 자연어를 통해 Amazon Quick에서 직접 Jira 문제, 프로젝트, 스프린트 및 사용자를 생성, 업데이트, 검색 및 관리할 수 있습니다.
이 통합을 설정하려면 두 단계가 필요합니다. 먼저 Atlassian 개발자 콘솔에서 OAuth 2.0(3LO) 앱을 생성하고 해당 권한을 구성합니다. 그런 다음 Amazon Quick에서 통합을 생성하고 Atlassian 앱에 연결합니다. Amazon Quick에서 지원하는 인증 방법에 대한 자세한 내용은 섹션을 참조하세요인증 방법.
시작하기 전 준비 사항
통합을 설정하기 전에 다음 사항이 있는지 확인합니다.
-
Atlassian Jira Cloud.
-
Atlassian 개발자 콘솔
에 액세스하여 OAuth 앱을 생성하거나 관리합니다. -
구독 요구 사항은 섹션을 참조하세요콘솔에서 통합 설정.
Atlassian 개발자 콘솔 구성
사용자 인증(3LO)을 사용하려는 경우 Amazon Quick을 구성하기 전에 Atlassian 개발자 콘솔에서 OAuth 2.0 앱을 생성합니다. Amazon Quick 콘솔로 이동하기 전에 다음 단계를 모두 완료합니다.
서비스 인증(API 키)만 사용하려는 경우이 섹션을 건너뛰고 로 진행할 수 있습니다Amazon Quick에서 통합 설정.
OAuth 2.0(3LO) 앱에 대한 자세한 내용은 Atlassian 개발자 설명서의 OAuth 2.0(3LO) 앱을
OAuth 2.0(3LO) 앱 생성
Amazon Quick은 Atlassian OAuth 2.0(3LO) 앱을 사용하여 사용자를 대신하여 Atlassian Cloud 제품을 인증합니다. Amazon Quick을 구성하기 전에 Atlassian 개발자 콘솔에서이 앱을 생성합니다.
-
Atlassian 개발자 콘솔
을 열고 Atlassian 계정으로 로그인합니다. -
생성을 선택한 다음 OAuth 2.0 통합을 선택합니다.
-
이름에와 같이 통합을 설명하는 이름을 입력합니다
.your-app-nameconnector -
Atlassian 개발자 약관을 검토하고 수락합니다.
-
생성(Create)을 선택합니다.
권한 구성
OAuth 2.0 앱을 생성한 후 Amazon Quick이 Atlassian 제품과 상호 작용하는 데 필요한 API 권한을 추가합니다.
-
Atlassian 개발자 콘솔의 앱에서 왼쪽 탐색 창에서 권한을 선택합니다.
-
Atlassian 제품의 API(예: Jira API 또는 Confluence API)를 찾아 추가를 선택합니다. API가 추가되면 버튼이 구성으로 변경됩니다.
-
구성을 선택합니다. 범위 페이지가 Classic 범위 및 세분화된 범위 탭과 함께 열립니다.
-
클래식 범위 탭에서 범위 편집을 선택합니다. 필요한 클래식 범위를 선택하고 저장을 선택합니다.
-
세분화된 범위 탭을 선택한 다음 범위 편집을 선택합니다. 필요한 세분화된 범위를 선택하고 저장을 선택합니다.
통합에 필요한 특정 범위는 다음 범위 섹션을 참조하세요.
API 권한 구성
Jira Cloud 작업 통합을 위해 OAuth 2.0 앱에 다음 범위를 추가합니다.
클래식 범위
클래식 범위 탭에서 범위 편집을 선택하고 다음 범위를 선택합니다.
| Scope | 설명 |
|---|---|
read:jira-work |
Jira 프로젝트를 읽고 데이터를 발급하고, 문제를 검색하고, 첨부 파일 및 작업 로그와 같은 문제와 관련된 객체를 검색합니다. |
manage:jira-project |
프로젝트 설정을 생성 및 편집하고 새 프로젝트 수준 객체(예: 버전 및 구성 요소)를 생성합니다. |
manage:jira-configuration |
Jira 관리 작업(예: 프로젝트 및 사용자 지정 필드 생성, 워크플로 보기, 문제 링크 유형 관리)을 수행합니다. |
read:jira-user |
사용자 이름, 이메일 주소, 아바타를 포함하여 사용자가 액세스할 수 있는 Jira의 사용자 정보를 봅니다. |
write:jira-work |
Jira에서 문제를 생성 및 편집하고, 사용자로서 의견을 게시하고, 작업 로그를 생성하고, 문제를 삭제합니다. |
manage:jira-webhook |
동적으로 선언된 Jira 웹후크를 가져오고, 등록하고, 새로 고치고, 삭제합니다. |
세분화된 범위
세분화된 범위 탭을 선택한 다음 범위 편집을 선택합니다. 검색 창을 사용하여 아래 범위를 찾습니다. 예를 들어를 검색sprint:jira-software하여 스프린트 관련 범위를 찾습니다.
| Scope | 설명 |
|---|---|
read:board-scope:jira-software |
보드 구성을 읽습니다. |
read:sprint:jira-software |
스프린트 정보를 읽습니다. |
write:sprint:jira-software |
스프린트를 생성하고 수정합니다. |
delete:sprint:jira-software |
스프린트를 삭제합니다. |
write:board-scope:jira-software |
보드 구성을 관리합니다. |
read:project:jira |
프로젝트 세부 정보를 읽습니다. |
권한 부여 구성
Atlassian이 앱을 승인한 후 사용자를 Amazon Quick로 다시 리디렉션할 수 있도록 콜백 URL을 설정합니다.
-
Atlassian 개발자 콘솔의 앱에서 왼쪽 탐색 창에서 권한 부여를 선택합니다.
-
OAuth 2.0(3LO) 옆에 있는 추가를 선택합니다.
-
콜백 URLs를 입력합니다
https://.region.quicksight.aws.amazon.com/sn/oauthcallbackregion을와 같이 Amazon Quick 인스턴스가 배포된 AWS 리전으로 바꿉니다us-east-1. -
변경 사항 저장을 선택합니다.
자격 증명 기록
Atlassian 개발자 콘솔에서 나가기 전에 다음 값이 있는지 확인합니다. Amazon Quick 구성에 필요합니다.
-
Atlassian 개발자 콘솔의 앱에서 왼쪽 탐색 창에서 설정을 선택합니다.
-
인증 세부 정보에서 클라이언트 ID 및 보안 암호 값을 복사합니다.
| 값 | 찾을 수 있는 위치 |
|---|---|
| 클라이언트 ID입니다 | 설정 페이지, 인증 세부 정보 아래 |
| Secret | 설정 페이지, 인증 세부 정보 아래 |
Amazon Quick에서 통합 설정
인증 자격 증명을 준비한 후 Amazon Quick에서 통합을 생성합니다.
-
Amazon Quick 콘솔에서 통합을 선택합니다.
-
추가 기능 탭을 선택합니다.
-
작업에 대한 새 앱 통합 설정에서 Atlassian Jira Cloud를 찾아 추가(더하기 "+") 버튼을 선택합니다.
-
통합 생성 마법사에서 다음 필드를 입력합니다.
-
이름 - Jira 통합에 대한 설명 이름입니다.
-
설명(선택 사항) -이 연결을 사용하는 방법에 대한 참고 사항입니다.
-
연결 유형 - 퍼블릭 네트워크를 선택합니다.
-
-
인증 설정에서 인증 방법을 선택하고 필수 필드를 입력합니다.
-
사용자 인증에서 다음 필드를 구성합니다.
기본 URL - API 호출을 위한 Jira 인스턴스 URL입니다. 이는 사용자가 로그인하는 URL과 동일하지 않습니다. 와 유사합니다
https://api.atlassian.com/ex/jira/. 인스턴스 ID를 찾으려면 로 이동합니다yourInstanceIdhttps://.your-domain.atlassian.net/_edge/tenant_info클라이언트 ID - Atlassian OAuth 앱의 설정 페이지에 있는 클라이언트 ID입니다.
클라이언트 보안 암호 - Atlassian OAuth 앱의 설정 페이지의 보안 암호입니다.
토큰 URL -
https://auth.atlassian.com/oauth/token권한 부여 URL -
https://auth.atlassian.com/authorize리디렉션 URL -이 필드는 Amazon Quick 콜백 URL로 미리 채워집니다.
-
서비스 인증에서 다음 필드를 구성합니다.
API 키 - Jira API 토큰입니다.
기본 URL - API 호출을 위한 Jira 인스턴스 URL입니다.
이메일 - 연결된 사용자 계정 이메일입니다.
-
-
Create and continue를 선택합니다.
-
(선택 사항) 통합 공유 페이지에서 통합을 공유할 사용자를 선택합니다.
중요
Jira Cloud는 API 토큰이 취소되거나 잘못 구성된 경우에도 HTTP 200 성공 응답을 반환할 수 있습니다. 자세한 내용은 JRACLOUD-82932
사용 가능한 작업
통합을 설정한 후 다음 작업을 사용할 수 있습니다.
| 작업 | 설명 |
|---|---|
| 첨부 파일 추가 | 문제에 첨부 파일을 추가합니다. |
| 설명 추가 | 새 설명을 추가합니다. |
| 문제 상태 변경 | 문제의 작업 상태를 변경합니다. |
| 문제 생성 | 새 문제 또는 하위 작업을 생성합니다. |
| 프로젝트 생성 | 새 프로젝트를 생성합니다. |
| 스프린트 생성 | 프로젝트에서 스프린트를 생성합니다. |
| 설명 삭제 | 주석을 제거합니다. |
| 문제 삭제 | 프로젝트에서 문제를 삭제합니다. |
| 프로젝트 삭제 | 프로젝트를 제거합니다. |
| 스프린트 삭제 | 프로젝트에서 스프린트를 삭제합니다. |
| 문제 편집 | 문제를 수정합니다. |
| 사용자 찾기 | Jira 사용자를 검색합니다. |
| 모든 레이블 가져오기 | 모든 레이블을 봅니다. |
| 모든 사용자 가져오기 | 모든 Jira 사용자를 나열합니다. |
| 첨부 파일 콘텐츠 가져오기 | 첨부 파일의 내용을 봅니다. |
| 설명 가져오기 | 문제 설명을 봅니다. |
| 문제 가져오기 | 프로젝트의 문제에 대한 세부 정보를 봅니다. |
| 프로젝트의 문제 유형 가져오기 | 프로젝트 문제 유형을 봅니다. |
| 우선 순위 가져오기 | 문제 우선 순위를 봅니다. |
| 프로젝트 가져오기 | 프로젝트 세부 정보를 봅니다. |
| 스프린트 가져오기 | 프로젝트의 스프린트 세부 정보를 봅니다. |
| 문제를 백로그로 이동 | 문제를 백로그로 이동합니다. |
| 문제를 스프린트 및 순위로 이동 | 스프린트에 문제를 할당합니다. |
| 문제 검색 | 문제를 검색합니다. |
| 프로젝트 검색 | 표시되는 프로젝트를 찾습니다. |
| 검색 상태 | 문제 상태를 검색합니다. |
| 설명 업데이트 | 주석을 편집합니다. |
| 프로젝트 업데이트 | 프로젝트를 수정합니다. |
| 스프린트 업데이트 | 스프린트 세부 정보를 업데이트합니다. |
참고
사용할 수 있는 작업은 Jira Cloud 인스턴스에 구성된 권한과 인증 방법에 따라 달라집니다.
관리 및 문제 해결
통합을 편집, 공유 또는 삭제하려면 섹션을 참조하세요기존 통합 관리.
인증 문제
-
잘못된 앱 구성 - Atlassian Developer Console의 OAuth 앱에 필요한 범위가 포함되어 있고 리디렉션 URI가 Amazon Quick 구성과 일치하는지 확인합니다.
-
만료되거나 취소된 API 토큰 - 서비스 인증을 사용하는 경우 API 토큰이 만료되거나 취소되지 않았는지 확인합니다. 알려진 Jira Cloud 동작(JRACLOUD-82932
)으로 인해 잘못된 토큰을 사용해도 통합이 성공적으로 연결되는 것처럼 보일 수 있습니다. -
잘못된 기본 URL - API 호출의 기본 URL이 Jira Cloud 로그인 URL과 동일하지 않습니다. API URL 형식인를 사용하고 있는지 확인합니다
https://api.atlassian.com/ex/jira/. 인스턴스 ID를 찾으려면 로 이동합니다yourInstanceIdhttps://.your-domain.atlassian.net/_edge/tenant_info
일반적인 오류 메시지
-
Access denied. You do not have permission to perform this action- 인증된 사용자에게 Jira Cloud에 필요한 권한이 없습니다. Jira Cloud 관리자에게 문의하여 적절한 권한을 확인하고 부여합니다. -
OAuth 2.0 authorization failed- Atlassian 개발자 콘솔과 Amazon Quick 모두에서 클라이언트 ID, 클라이언트 보안 암호 및 OAuth 범위가 올바르게 구성되었는지 확인합니다.