이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Confluence Cloud 데이터 스토어 설정

이 페이지에서는 데이터 스토어를 만들고 Confluence Cloud를 Gemini Enterprise에 연결하는 방법을 설명합니다.

시작하기 전에

Confluence Cloud 제휴 연결을 설정하기 전에 다음 사항을 확인하세요.

검색 엔진 편집자 역할 (roles/discoveryengine.editor)을 부여합니다. 이 역할은 사용자가 데이터 스토어를 만드는 데 필요합니다. 이 역할을 부여하려면 다음 단계를 따르세요.
1. Google Cloud 콘솔에서 IAM 페이지로 이동합니다.
  IAM으로 이동
2. 사용자 계정을 찾아 수정 수정 아이콘을 클릭합니다.
3. 사용자에게 Discovery Engine Editor 역할을 부여합니다. 자세한 내용은 IAM 역할 및 권한을 참고하세요.
Google Gemini Enterprise에서 데이터 소스 액세스 제어를 적용하고 데이터를 보호하려면 ID 공급업체를 구성하세요.
Confluence Cloud 커넥터를 설정하려면 새로운 중앙 집중식 Atlassian 사용자 관리 모델을 사용해야 합니다. 원래 모델을 사용하는 경우 계속하기 전에 사용자 관리를 마이그레이션해야 합니다. 자세한 내용은 사이트 관리자 역할을 참고하세요.
OAuth 2.0 앱을 만들고, 클라이언트 ID와 보안 비밀번호를 가져오고, Confluence Cloud 관리자의 동의를 받아 최소 애플리케이션 권한을 구성합니다.
선택사항: 설정에서 이메일 공개 상태를 제한하는 경우에도 Confluence Cloud에서 사용자 이메일 주소를 가져오려면 Confluence 사이트 관리자 권한으로 Confluence Cloud용 사용자 ID 접근자 앱을 설치한 다음 사용자 이메일 주소를 안전하게 가져오도록 구성합니다. 이메일 주소에 이미 공개적으로 액세스할 수 있으면 이 앱을 설치하지 않아도 됩니다.

참고: Atlassian에서 사용자 인터페이스 요소를 업데이트하고 있으며 이 문서에 언급된 일부 요소의 이름이 변경되고 있습니다 (예: 제품이 앱으로 이름이 변경됨). 자세한 내용은 Atlassian 관리 용어 '제품'에서 '앱'으로 변경을 참고하세요.

Confluence Cloud 데이터 스토어 만들기

Confluence Cloud 데이터 스토어를 만들려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 Gemini Enterprise 페이지로 이동합니다.

Gemini Enterprise
Google Cloud 프로젝트를 선택하거나 만듭니다.

참고: 통합 흐름에 액세스하려면 프로젝트가 허용 목록에 있어야 합니다.
탐색 메뉴에서 데이터 스토어를 클릭합니다.
데이터 스토어 만들기를 클릭합니다.
소스 섹션에서 Confluence Cloud를 검색하고 선택을 클릭합니다.
데이터 섹션에서 다음을 수행합니다.
1. 커넥터 모드 섹션에서 연결 모드로 데이터 수집 또는 제휴 검색을 선택합니다.
2. 계속을 클릭합니다.
3. 인증 설정 섹션에서 선택한 연결 모드에 따라 인증을 구성합니다.
  1. 데이터 수집을 선택한 경우:
    1. 인증 방법으로 OAuth 2.0 클라이언트 사용자 인증 정보 또는 API 토큰을 선택합니다.
    2. OAuth 2.0 클라이언트 사용자 인증 정보를 선택하는 경우 다음 세부정보를 입력합니다.
      - 클라이언트 ID
      - 클라이언트 보안 비밀번호
      - 인스턴스 URI
      - 인스턴스 ID
    3. API 토큰을 선택한 경우 다음 세부정보를 입력합니다.
      - 인스턴스 URI
      - 사용자 계정
      - API 토큰
  2. 제휴 검색을 선택한 경우:
    1. OAuth 2.0 클라이언트 사용자 인증 정보만 적용 가능한 방법입니다. 다음 세부정보를 제공합니다.
      - 클라이언트 ID
      - 클라이언트 보안 비밀번호
      - 인스턴스 URI
  사용자 인증 정보에 대한 자세한 내용은 Confluence Cloud 구성을 참고하세요.
  1. 로그인을 클릭하고 Atlassian 로그인을 완료합니다.
4. 계속을 클릭합니다.
5. 대상 섹션에 Confluence Cloud 엔드포인트의 URL을 입력합니다.
6. 계속을 클릭합니다.
7. 동기화할 항목 (데이터 수집을 선택한 경우) 또는 검색할 항목 (제휴 검색을 선택한 경우) 섹션에서 다음 단계를 따르세요.
  1. 필요한 항목을 모두 선택합니다.
  2. 선택사항: 특정 프로젝트를 동기화하려면 다음 단계를 따르세요.
    1. 필터를 클릭합니다.
    2. 색인에서 항목을 필터링하려면 색인에서 제외를 선택하고, 색인에 포함되도록 하려면 색인에 포함을 선택합니다.
    3. 스페이스 키를 입력합니다. 스페이스 키를 누른 후 Enter 키를 누릅니다.
    4. 저장을 클릭합니다.
  3. 데이터 수집을 선택한 경우 동기화 일정을 구성하려면 다음 단계를 따르세요.
    1. 동기화 빈도 목록에서 동기화 빈도를 선택합니다.
      - 항목 및 ID 데이터의 전체 동기화를 별도로 예약하려면 전체 동기화 섹션에서 메뉴를 펼친 후 맞춤 옵션을 선택합니다.
    2. 증분 동기화 빈도 목록에서 증분 동기화 빈도를 선택합니다.
  자세한 내용은 동기화 일정을 참고하세요.
계속을 클릭합니다.
구성 섹션에서 다음을 수행합니다.
1. 멀티 리전 목록에서 데이터 커넥터의 위치를 선택합니다.
2. 데이터 커넥터 이름 필드에 커넥터 이름을 입력합니다.
3. US 또는 EU를 위치로 선택한 경우 암호화 설정을 구성합니다.
  - 선택사항: 단일 리전 키를 구성하지 않은 경우 설정 페이지로 이동을 클릭하여 구성합니다. 자세한 내용은 서드 파티 커넥터용 단일 리전 키 등록을 참고하세요.
  - Google관리 암호화 키 또는 Cloud KMS 키를 선택합니다.
  - Cloud KMS 키를 선택한 경우 다음 단계를 따르세요.
    - 키 관리 유형 목록에서 적절한 유형을 선택합니다.
    - Cloud KMS 키 목록에서 키를 선택합니다.
  자세한 내용은 고객 관리 암호화 키를 참고하세요.
계속을 클릭합니다.
결제 섹션에서 일반 가격 또는 구성 가능한 가격을 선택합니다. 자세한 내용은 프로젝트의 결제 상태 확인 및 라이선스를 참고하세요.
만들기를 클릭합니다. Gemini Enterprise는 데이터 스토어를 만들고 데이터 스토어 페이지에 데이터 스토어를 표시합니다.

데이터 스토어 페이지에서 데이터 스토어 이름을 클릭하여 상태를 확인합니다. 데이터 스토어 상태가 생성 중에서 활성으로 변경되면 Confluence Cloud 커넥터를 사용할 수 있습니다.

Confluence Cloud로 생성된 수집 커넥터의 경우 동기화가 시작되면 데이터 스토어 상태가 생성 중에서 실행 중으로 전환됩니다. 수집이 완료되면 활성으로 변경되어 데이터 스토어가 완전히 구성되었음을 나타냅니다. 데이터 볼륨에 따라 수집에 몇 시간이 걸릴 수 있습니다.

데이터 스토어를 만든 후 앱을 만들고, Confluence Cloud 데이터 스토어에 연결하고, 쿼리를 실행하기 전에 Gemini Enterprise가 Confluence Cloud에 액세스하도록 승인합니다.

데이터 수집을 위한 실시간 동기화 사용 설정

실시간 동기화는 문서 항목만 동기화하며 ID 항목과 관련된 데이터는 동기화하지 않습니다. 다음 표는 실시간 동기화가 지원되는 문서 이벤트를 보여줍니다.

Confluence 항목	만들기	업데이트	삭제	권한 변경
Spaces
페이지
블로그
첨부파일
댓글
화이트보드

Confluence Cloud 데이터 스토어를 만든 후 20분이 지나면 실시간 동기화를 사용 설정합니다. Confluence 데이터 소스의 실시간 동기화를 사용 설정하려면 다음 단계를 따르세요.

웹훅 URL 생성

Gemini Enterprise 페이지로 이동하고 탐색 메뉴에서 데이터 스토어를 클릭합니다.
Confluence 데이터 스토어를 선택합니다.
실시간 동기화 행에서 보기/수정을 클릭합니다.
실시간 동기화 파라미터 보기 및 수정 대화상자에서 다음을 수행합니다.
1. 실시간 동기화를 사용 설정하려면 실시간 동기화 사용 설정 전환 버튼을 클릭합니다.
2. 클라이언트 보안 비밀 필드에 clientsecret과 같은 자리표시자 값을 입력합니다.
3. 저장을 클릭합니다.
실시간 동기화 상태가 Running으로 변경되면 보기/수정을 클릭합니다.
실시간 동기화 파라미터 보기 및 수정 대화상자에서 다음을 수행합니다.
1. 웹훅 URL을 복사합니다.
2. 닫기를 클릭합니다.

API를 사용하여 이벤트 구독

Confluence에서 실시간 업데이트를 받으려면 POST 요청을 사용하여 특정 이벤트를 구독해야 합니다. API 호출을 하려면 Confluence에서 인증 및 권한을 설정하는 데 사용한 것과 동일한 관리자 계정을 사용하여 데이터 스토어를 만드세요.

      curl -X POST \
        INSTANCE_URL/wiki/rest/webhooks/1.0/webhook \
        -H "Content-Type: application/json" \
        -u "USERNAME:API_TOKEN" \
        -d '{
          "name": "SUBSCRIPTION_NAME",
          "url": "LISTENER_URL",
          "events": [
            "EVENT_TYPE_1",
            "EVENT_TYPE_2"
          ],
          "active": true
        }'

INSTANCE_URL: Atlassian Cloud 사이트의 기본 웹 주소입니다.
USERNAME: Atlassian Cloud 사용자 이름입니다.
API_TOKEN: Atlassian 계정에서 생성된 API 토큰입니다. 자세한 내용은 Confluence에서 API 토큰 설정을 참고하세요.
SUBSCRIPTION_NAME: 이벤트 구독의 고유한 이름입니다.
LISTENER_URL: 데이터 스토어에서 실시간 동기화(RTS)가 사용 설정된 후 Google Cloud 콘솔에서 복사한 웹훅 URL입니다.

EVENT_TYPE: 구독하려는 이벤트 유형입니다. 첨부파일, 블로그 게시물, 페이지, 스페이스, 댓글의 이벤트를 생성, 업데이트, 삭제하도록 구독할 수 있습니다.

사용자는 다음 이벤트를 구독할 수 있습니다.

space_created
space_updated
page_created
page_updated
attachment_created
attachment_updated
comment_created
comment_updated
blog_created
blog_updated

명령어 및 결과 예시

curl -X POST \
    https://cymbalgroup.atlassian.net/wiki/rest/webhooks/1.0/webhook \
    -H "Content-Type: application/json" \
    -u "admin1:######" \
    -d '{
      "name": "Cymbal_DCT",
      "events": [
        "attachment_created",
        "attachment_updated"
      ],
      "url": "https://rt-server-a-jx3m2-uw.a.run.app/webhook",
      "active": true
    }'

{
"name": "Cymbal_DCT",
"url": "https://cymbalgroup.atlassian.net/wiki/rest/webhooks/1.0/webhook",
"description": " Webhook for Cymbal DCT group to fetch attachments.",
"excludeBody": false,
"filters": {},
"events": [
    "attachment_created",
    "attachment_updated",
],
"enabled": true,
"self": https://rt-server-a-jx3m2-uw.a.run.app/webhook,
"lastUpdatedUser": "Cymb_389",
"lastUpdatedDisplayName": "Ariel",
"lastUpdated": 1752095647212
}

API 오류 코드

이 표에는 사용자가 웹훅을 만들 때 발생하는 일반적인 API 오류 코드가 나와 있습니다.

오류 클래스	오류 코드	오류 메시지	문제 해결
`403`	`FORBIDDEN`	현재 사용자에게 Confluence 사용 권한이 없습니다.	관리자 계정의 유효한 토큰과 올바른 API 엔드포인트를 사용해야 합니다.

데이터 처리 및 쿼리 실행

이 섹션에서는 Gemini Enterprise가 쿼리를 관리하는 방법과 연합 데이터 스토어 사용의 개인 정보 보호 영향을 설명합니다.

쿼리 실행

Confluence Cloud를 승인하고 Gemini Enterprise에 검색어를 전송하면 다음과 같은 결과가 표시됩니다.

Gemini Enterprise는 검색어를 Atlassian API로 직접 전송합니다.
Gemini Enterprise는 결과를 연결된 다른 데이터 소스의 결과와 혼합하여 종합적인 검색 결과를 표시합니다.

데이터 처리

서드 파티 제휴 검색을 사용할 때는 다음 데이터 처리 규칙이 적용됩니다.

쿼리 문자열이 서드 파티 검색 백엔드 (Atlassian API)로 전송됩니다.
이러한 서드 파티는 쿼리를 사용자의 ID와 연결할 수 있습니다.
여러 제휴 검색 데이터 소스가 사용 설정된 경우 쿼리가 모든 데이터 소스로 전송될 수 있습니다.
데이터가 서드 파티 시스템에 도달하면 해당 시스템의 서비스 약관 및 개인정보처리방침이 적용됩니다.

다음 단계

Confluence Cloud 데이터를 쿼리하는 사용자 인터페이스를 제공하려면 앱을 만들고 Confluence Cloud 데이터 스토어에 연결하세요.
앱을 설정한 후 검색 결과가 표시되는 방식을 미리 보려면 검색 결과 가져오기를 참고하세요.
데이터 스토어의 알림을 사용 설정하려면 서드 파티 데이터 스토어의 알림 구성을 참고하세요.