주의
Jira Server의 최신 버전(8.14.0 이상)은 API 토큰을 사용하여 Jira Server REST API에 액세스하는 것을 지원합니다. 여기에 설명된 더 복잡한 설정을 피하기 위해 가능하면 API 토큰을 사용하는 것이 좋습니다. Jira Server 버전을 확인하십시오 .
이 통합을 구성하려면 Jira 관리자여야 합니다. 계속 진행하기 위해 적절한 권한이 있는지 확인하려면 Jira 설정 메뉴(톱니 아이콘, 프로필 및 설정 메뉴 아이콘 옆의 오른쪽 상단에 있음)를 찾아 거기에 애플리케이션 옵션이 있는지 확인하십시오. 설정 메뉴 또는 응용 프로그램 옵션이 없으면 통합을 구성할 수 없습니다.
이 통합을 위해서는 Jira Server 인스턴스가 공개적으로 액세스 가능한 URL에 있어야 합니다.
New Relic CodeStream은 Atlassian의 게시된 REST API를 사용하여 Jira Server와 통합할 수 있습니다. CodeStream이 Jira Server 설치와 통합되도록 하려면 CodeStream 애플리케이션 링크를 설정하십시오. 이 애플리케이션 링크는 사용자가 CodeStream에 자격 증명을 입력할 필요 없이 Jira Server 계정에 대해 인증할 수 있는 통로 역할을 합니다.
Jira Server는 클라이언트 인증을 위해 OAuth 표준(버전 1.0a)을 사용합니다. 참고로 Atlassian 문서 를 참조하십시오.
그러나 해당 페이지의 전체 지침을 따를 필요는 없습니다. 관련 지침은 명확성을 위해 여기에서 복제 및 단순화되었습니다.
애플리케이션 링크와 함께 사용할 공개/비공개 키 쌍을 생성하려면 openssl
명령줄 도구가 필요합니다.
공개/개인 키 쌍 생성
터미널에서 다음 단계에 따라 openssl
을 사용하여 공개/비공개 키 쌍을 생성합니다.
1024비트 개인 키 생성:
openssl genrsa -out jira_privatekey.pem 1024X509 인증서 생성:
openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365인증서와 함께 적합하다고 생각되는 정보를 입력하십시오.
비공개 키(PKCS8 형식)를
jira_privatekey.pcks8
파일로 추출합니다.openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8인증서에서
jira_publickey.pem
파일로 공개 키를 추출합니다.openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pem
애플리케이션 링크 생성
다음 단계에 따라 Jira Server 내에서 애플리케이션 링크를 생성하십시오.
Jira에서 Jira 설정 (오른쪽 상단의 톱니바퀴 아이콘)으로 이동하여 애플리케이션 을 클릭합니다. 필요한 경우 관리자 암호를 입력합니다. 그런 다음 왼쪽 사이드바의 통합 아래에서 애플리케이션 링크 를 선택합니다.
연결하려는 애플리케이션의 URL 입력 이라고 표시된 곳에 원하는 URL을 입력합니다(예:
http://example.com/
. 그런 다음 새 링크 만들기 를 클릭합니다.다음으로 시작하는 경고가 표시될 수 있습니다. 입력한 URL에서 응답이 수신되지 않았습니다 . 경고는 무시해도 됩니다. 계속 을 클릭합니다.
여기 보이는 대로 또는 원하는 대로 양식을 작성하십시오. 여기에 입력된 데이터는 들어오는 링크 만들기 가 선택되어 있는지 확인하는 것을 제외하고는 실제로 중요하지 않습니다. 응용 프로그램 이름 은 링크를 식별하는 데 가장 적합한 이름이 될 수 있습니다. 그런 다음 계속 을 클릭합니다.
다음 대화 상자에서 소비자 키 에 대해 원하는 고유 문자열을 입력합니다. 보안이나 인코딩이 필요하지 않으며 기억하기 쉬운 것만 있으면 됩니다. 여기에 입력한 내용을 기록해 두십시오. CodeStream에서 Jira Server와의 통합을 설정할 때 필요합니다. 소비자 이름 에는 "CodeStream 앱"과 같이 의미 있는 모든 것을 입력할 수 있습니다. 올바르게 작성해야 하는 중요한 필드는 공개 키 입니다. 1단계에서 생성한 jira_publickey.pem 파일 내용의 전체 텍스트를 복사합니다. 이것을 공개 키 필드에 붙여넣고 계속 을 클릭하십시오.
이제 생성한 애플리케이션 링크가 다음과 같이 표시되어야 합니다.
CodeStream에서 통합 설정
이제 생성한 애플리케이션 링크를 사용하여 팀을 위해 CodeStream에서 Jira Server로의 통합을 설정할 준비가 되었습니다. CodeStream에 가입했고 IDE에서 확장 프로그램이 열려 있다고 가정합니다.
CodeStream에서 왼쪽 상단의 사용자 이름 옆에 있는 메뉴를 클릭하여 통합 패널로 이동합니다. 그런 다음 Issue Providers 아래에서 Jira Server 를 클릭합니다.
Jira Server 통합과 함께 API 토큰을 사용하지 않을 것이므로 조직에서 여기에서 설명하는 OAuth 방법을 사용하여 Jira Server를 구성 하려면 조직에서 Jira Server 이전 버전을 사용하는 경우 여기를 클릭하십시오 .
양식을 작성하시오:
Jira Server 기본 URL 의 경우 내부 네트워크에 알려진 Jira Server 설치에 액세스하는 데 사용되는 URL을 http(s)://host:port 형식으로 입력합니다.
Consumer Key[소비자 키]의 경우 위의 2단계에서 애플리케이션 링크를 만들 때 입력한 소비자 키를 사용합니다. 그런 다음 위의 1단계에서 생성한 개인 키의 전체 내용을 PCKS8 형식으로 복사합니다. 파일 이름은 jira_privatekey.pcks8이어야 합니다. 해당 내용을 Private Key[개인 키] 필드에 붙여넣은 다음 Submit[제출을]클릭하십시오.
그런 다음 애플리케이션 링크를 사용하여 계정에 대한 액세스를 승인하는 Jira Server 인스턴스로 이동합니다. 완료되면 IDE로 돌아가면 다음과 유사한 내용이 표시됩니다.
이제 조직에 대한 통합이 설정되었으므로 다른 사용자는 위에 설명된 프로세스를 거칠 필요가 없습니다. 조직의 다른 사용자는 사용 가능한 다른 통합과 함께 Jira Server(호스트에서 지정)와의 통합을 볼 수 있습니다. 이 통합을 시작하려면 마지막 단계에서 했던 것처럼 다른 사용자가 CodeStream 애플리케이션 링크가 자신의 계정에 액세스하도록 허용하기만 하면 됩니다.