이 페이지에서는 데이터 스토어를 만들고 Jira Data Center를 Gemini Enterprise에 연결하는 방법을 설명합니다.
시작하기 전에
연결을 설정하기 전에 다음 단계를 따르세요.
검색 엔진 편집자 역할 (
roles/discoveryengine.editor)을 부여합니다. 이 역할은 사용자가 데이터 스토어를 만드는 데 필요합니다. 이 역할을 부여하려면 다음 단계를 따르세요.- Google Cloud 콘솔에서 IAM 페이지로 이동합니다.
- 사용자 계정을 찾아 수정 수정 아이콘을 클릭합니다.
- 사용자에게
Discovery Engine Editor역할을 부여합니다. 자세한 내용은 IAM 역할 및 권한을 참조하세요.
인증 설정 및 클라이언트 사용자 인증 정보 가져오기의 단계를 완료하여 클라이언트 ID와 클라이언트 보안 비밀번호를 가져오고 권한을 설정합니다.
Jira Data Center 인스턴스에서 비공개 IP를 사용하는 경우 Jira Data Center 인스턴스에 대해 Private Service Connect 프로듀서 서비스를 게시합니다. Private Service Connect를 사용하여 Gemini Enterprise를 자체 호스팅 데이터 소스에 연결하는 방법에 관한 자세한 내용은 자체 호스팅 데이터 소스 소개를 참고하세요.
데이터 수집 연결 모드를 사용하는 경우 다음 추가 요구사항을 충족해야 합니다.
액세스 제어 목록 (ACL) 정보를 가져올 수 있는 Jira 시스템 관리자 권한이 있는지 확인합니다.
Jira에서 문제 수준 보안을 설정한 경우 Jira Data Center용 권한 접근자 플러그인을 설치하세요. 이 플러그인은 Gemini Enterprise에 REST 엔드포인트를 제공합니다. 이러한 엔드포인트를 통해 Gemini Enterprise는 스페이스 권한 세부정보, 콘텐츠 제한, 라이선스가 부여된 사용자의 이메일 주소를 가져올 수 있습니다. 이 정보는 Gemini Enterprise 검색 환경 내에서 올바른 권한이 적용되도록 하는 데 사용됩니다.
Jira 데이터 센터 데이터 스토어 만들기
Jira Data Center 데이터 스토어를 만들려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 Gemini Enterprise 페이지로 이동합니다.
Google Cloud 프로젝트를 선택하거나 만듭니다.
탐색 메뉴에서 데이터 스토어를 클릭합니다.
데이터 스토어 만들기를 클릭합니다.
소스 섹션에서 Jira Data Center를 검색하고 선택을 클릭합니다.
데이터 섹션에서 다음을 수행합니다.
- 커넥터 모드 섹션에서 데이터 수집 또는 제휴 검색을 선택합니다.
- 계속을 클릭합니다.
인증 설정 섹션에서 선택한 연결 모드에 따라 인증을 구성합니다.
인증 세부정보를 제공합니다.
제휴 검색의 경우 다음 세부정보를 제공합니다.
인스턴스 URI: Jira 데이터 센터 인스턴스의 기준 URL입니다(예:
https://jira.yourcompany.com).클라이언트 ID: Jira Data Center에 등록된 OAuth 애플리케이션의 고유 식별자입니다.
클라이언트 보안 비밀: 요청을 인증하기 위한 클라이언트 보안 비밀이 포함된 Secret Manager 보안 비밀입니다.
이러한 사용자 인증 정보를 획득하려면 인증 설정 및 클라이언트 사용자 인증 정보 획득을 참고하세요.
데이터 수집의 경우 사용자 이름 및 비밀번호, 개인 액세스 토큰 또는 API 토큰 인증 방법 중 하나를 선택한 다음 필요한 세부정보를 입력합니다.
계속을 클릭합니다.
대상 유형 목록에서 공개 또는 비공개를 선택합니다.
- 공개 대상 유형을 선택한 경우 도메인 URL에 공개 URL을 입력합니다. 인스턴스 URI와 일치해야 합니다.
비공개 대상 유형을 선택한 경우 다음 정보를 입력합니다.
- 서비스 연결: Private Service Connect 서비스 연결을 입력합니다. 이를 얻으려면 Jira Data Center 인스턴스에 대해 Private Service Connect 프로듀서 서비스를 게시해야 합니다.
- Private Service Connect 서비스 연결의 리전이 데이터 스토어의 리전과 다른 경우 PSC 전역 액세스 사용 설정 체크박스를 선택합니다.
- 도메인 URL이 있는 인스턴스의 경우:
- 선택사항: 기본 도메인 이름: 기본 도메인을 입력합니다.
- 도메인 URL: 도메인 URL을 입력합니다. 인스턴스 URI와 일치해야 합니다.
- 선택사항: 대상 포트: 대상 포트를 입력합니다.
- 도메인 URL이 없는 인스턴스의 경우:
- 대상 포트: 대상 포트를 입력합니다.
계속을 클릭합니다.
선택사항: 고급 옵션을 클릭합니다.
제휴 검색을 선택한 경우 다음을 수행합니다.
SSL 설정 체크박스를 사용 설정한 경우 비공개, 공개 또는 보안되지 않음에서 신뢰 모델을 선택한 다음 필수 필드를 구성합니다. 신뢰 모델에 대한 자세한 내용은 신뢰 모델을 참고하세요.
- 공개: Jira 데이터 센터 인스턴스에서 공개적으로 신뢰할 수 있는 CA에서 발급한 인증서를 사용하는 경우 이 옵션을 사용합니다.
- 비공개: Jira Data Center 인스턴스에서 비공개 또는 내부 CA로 서명된 인증서를 사용하는 경우 이 옵션을 사용합니다.
- Insecure: 이 옵션은 인증서 유효성 검사를 우회합니다. 연결이 보안 위험에 노출될 수 있으므로 프로덕션 환경에서는 권장되지 않습니다.
다음 필드는 모든 신뢰 모델에 공통적으로 적용됩니다.
- 키 저장소 클라이언트 인증서: PEM 형식의 클라이언트 인증서입니다. 예를 들면
-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----입니다. - 키 저장소 클라이언트 비공개 키: PEM 형식의 클라이언트 인증서 비공개 키입니다.
- 키 저장소 클라이언트 비공개 키 암호: 클라이언트 비공개 키의 암호입니다(해당하는 경우).
비공개 신뢰 모델에는 다음 추가 세부정보가 필요합니다.
- 비공개 인증서: PEM 형식의 비공개 CA 공개 인증서입니다.
데이터 수집을 선택한 경우 다음을 수행합니다.
- 고정 IP 주소 사용 설정 체크박스를 선택합니다. 데이터 저장소를 만든 후 동기화 실행이 성공하려면 등록된 고정 IP를 허용 목록에 추가해야 합니다.
- 최대 QPS 필드에 초당 Jira Data Center 데이터 저장소로 전송되는 최대 쿼리 수를 지정합니다.
- 맞춤 필드 사용 설정 체크박스를 선택합니다. 사용 설정된 경우 데이터 스토어는 Jira 데이터 센터에서 맞춤 필드를 가져옵니다.
- 필요한 경우 프록시 설정 및 SSL 설정 체크박스를 선택하여 사용 설정합니다.
계속을 클릭합니다.
검색할 항목(제휴 검색을 선택한 경우) 또는 동기화할 항목(데이터 수집을 선택한 경우) 섹션에서 다음 단계를 따르세요.
- 필요한 항목을 모두 선택합니다.
- 제휴 검색을 선택한 경우 다음 단계로 진행합니다.
데이터 수집을 선택한 경우 다음 단계를 계속 진행합니다.
- 선택사항: 특정 프로젝트를 동기화하려면 다음 단계를 따르세요.
- 필터를 클릭합니다.
- 색인에서 항목을 필터링하려면 색인에서 제외 체크박스를 선택하고, 색인에 포함되도록 하려면 색인에 포함 체크박스를 선택합니다.
- 키를 입력합니다. 각 키를 입력한 후 Enter 키를 누릅니다.
- 저장을 클릭합니다.
동기화 일정을 구성하려면 다음 단계를 따르세요.
- 동기화 빈도 목록에서 동기화 빈도를 선택합니다.
- 항목 및 ID 데이터의 전체 동기화를 별도로 예약하려면 전체 동기화 섹션에서 메뉴를 펼친 후 커스텀 옵션을 선택합니다.
- 증분 동기화 빈도 목록에서 증분 동기화 빈도를 선택합니다.
자세한 내용은 동기화 일정을 참고하세요.
- 동기화 빈도 목록에서 동기화 빈도를 선택합니다.
- 선택사항: 특정 프로젝트를 동기화하려면 다음 단계를 따르세요.
계속을 클릭합니다.
구성 섹션에서 다음을 수행합니다.
- 멀티 리전 목록에서 데이터 커넥터의 위치를 선택합니다.
- 데이터 커넥터 이름 필드에 커넥터 이름을 입력합니다.
US또는EU를 위치로 선택한 경우 암호화 설정을 구성합니다.- 선택사항: 단일 리전 키를 구성하지 않은 경우 설정 페이지로 이동을 클릭하여 구성합니다. 자세한 내용은 서드 파티 커넥터용 단일 리전 키 등록을 참조하세요.
- Google관리 암호화 키 또는 Cloud KMS 키를 선택합니다.
- Cloud KMS 키를 선택한 경우 다음 단계를 따르세요.
- 키 관리 유형 목록에서 적절한 유형을 선택합니다.
- Cloud KMS 키 목록에서 키를 선택합니다.
계속을 클릭합니다.
결제 섹션에서 일반 가격 또는 구성 가능한 가격을 선택합니다. 자세한 내용은 프로젝트의 결제 상태 확인 및 라이선스를 참조하세요.
계속을 클릭합니다.
만들기를 클릭합니다. Gemini Enterprise는 데이터 스토어를 만들고 데이터 스토어 페이지에 데이터 스토어를 표시합니다.
비공개 대상 유형을 선택하고 Private Service Connect 생산자 서비스를 구성하여 선택한 프로젝트에 대한 연결 수락 (명시적 승인)을 선택한 경우 다음 단계를 따르세요.
Google Cloud 콘솔에서
Private Service Connect을 검색하고 Private Service Connect 페이지로 이동합니다.게시된 서비스 탭을 클릭합니다.
Jira Data Center 데이터 스토어에 해당하는 Private Service Connect 서비스의 이름을 클릭합니다.
연결된 프로젝트 섹션에서 데이터 스토어의 Gemini Enterprise 테넌트 프로젝트 옆에 있는 체크박스를 선택한 다음 프로젝트 수락을 클릭합니다. Gemini Enterprise 테넌트 프로젝트 ID는
-tp로 끝납니다.
Private Service Connect 내 서비스 세부정보 페이지에서 프로젝트 수락을 클릭할 때까지 데이터 스토어 상태가 데이터 스토어 페이지에서 생성 중으로 유지됩니다. 프로젝트 수락을 클릭하면 데이터 스토어 상태가 활성으로 변경됩니다.
데이터 스토어의 상태를 확인하려면 데이터 스토어 페이지에서 다음 단계를 따르세요.
- 데이터 스토어 목록에서 새로 만든 데이터 스토어로 이동하고 상태가 활성으로 변경될 때까지 모니터링합니다.
- 데이터 스토어 상태가 생성 중에서 활성으로 변경되면 Jira Data Center 커넥터를 사용할 수 있습니다.
데이터 스토어를 만든 후 다음 단계를 따르세요.
- 앱 만들기
- Jira Data Center 데이터 스토어에 연결합니다.
- 쿼리를 실행하기 전에 Gemini Enterprise를 Jira Data Center에 승인합니다.
검색을 수행하는 데 필요한 권한에 대한 자세한 내용은 필수 권한을 참고하세요.
데이터 처리 및 쿼리 실행
이 섹션에서는 Gemini Enterprise가 쿼리를 관리하는 방법과 제휴 데이터 스토어 사용의 개인 정보 보호 영향을 설명합니다.
쿼리 실행
Jira Data Center를 승인하고 Gemini Enterprise에 검색어를 전송하면 다음과 같은 결과가 표시됩니다.
- Gemini Enterprise는 검색어를 Jira Data Center API로 직접 전송합니다.
- Gemini Enterprise는 결과를 연결된 다른 데이터 소스의 결과와 혼합하여 종합적인 검색 결과를 표시합니다.
데이터 처리
서드 파티 제휴 검색을 사용할 때는 다음 데이터 처리 규칙이 적용됩니다.
- 쿼리 문자열이 서드 파티 검색 백엔드 (Jira Data Center API)로 전송됩니다.
- 이러한 서드 파티는 쿼리를 사용자의 ID와 연결할 수 있습니다.
- 여러 제휴 검색 데이터 소스가 사용 설정된 경우 쿼리가 모든 데이터 소스로 전송될 수 있습니다.
- 데이터가 서드 파티 시스템에 도달하면 해당 시스템의 서비스 약관 및 개인정보처리방침이 적용됩니다.
다음 단계
- Jira Data Center 데이터를 쿼리하는 사용자 인터페이스를 제공하려면 앱을 만들고 Jira Data Center 데이터 스토어에 연결하세요.
- 앱을 설정한 후 검색 결과가 표시되는 방식을 미리 보려면 검색 결과 가져오기를 참조하세요.
- 데이터 스토어의 알림을 사용 설정하려면 서드 파티 데이터 스토어의 알림 구성을 참고하세요.