Microsoft SharePoint 데이터 스토어 설정

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

시작하기 전에

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

  1. 검색 엔진 편집자 역할(roles/discoveryengine.editor)을 부여합니다. 이 역할은 사용자가 데이터 스토어를 만드는 데 필요합니다. 이 역할을 부여하려면 다음 단계를 따르세요.

    1. Google Cloud 콘솔에서 IAM 페이지로 이동합니다.

      IAM으로 이동

    2. 사용자 계정을 찾아 수정 수정을 클릭합니다.
    3. 사용자에게 Discovery Engine Editor 역할을 부여합니다. 자세한 내용은 IAM 역할 및 권한을 참조하세요.

  2. Gemini Enterprise를 Microsoft Entra ID에 OAuth 2.0 애플리케이션으로 등록하고 다음 사용자 인증 정보를 획득합니다.

    • 클라이언트 ID

    • 클라이언트 보안 비밀번호

    • 테넌트 ID

    • 인스턴스 URI

  3. Microsoft SharePoint 관리자의 동의를 받아 Microsoft API 권한을 구성합니다.

Microsoft SharePoint 데이터 스토어 만들기

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

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

    Gemini Enterprise

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

  3. 탐색 메뉴에서 데이터 스토어를 클릭합니다.

  4. 데이터 스토어 만들기를 클릭합니다.

  5. 소스 섹션에서 Microsoft SharePoint를 검색하고 선택을 클릭합니다.

  6. 데이터 섹션에서 다음을 수행합니다.

    1. 커넥터 모드 섹션에서 연결 모드로 제휴 검색 또는 데이터 수집을 선택합니다.

    2. 계속을 클릭합니다.

    3. 인증 설정 섹션에서 선택한 연결 모드에 따라 인증을 구성합니다.

      1. 필요한 경우 다음 인증 세부정보를 제공합니다.
        • 클라이언트 ID: 조직의 Microsoft Entra ID에 등록된 애플리케이션의 고유 식별자입니다.
        • 클라이언트 보안 비밀번호: Microsoft Entra ID의 OAuth 2.0 애플리케이션 등록 프로세스 중에 생성된 보안 키입니다.
        • 테넌트 ID: Microsoft Entra 관리 센터에 있는 조직의 고유 식별자입니다.
        • 인스턴스 URI: Microsoft SharePoint 인스턴스의 기준 URL입니다(예: https://{your-domain}.sharepoint.com).
        • Microsoft SharePoint 환경 유형: Microsoft 365 테넌트를 호스팅하는 환경을 선택합니다.
          • 표준 상업용 Microsoft 365 또는 Government Community Cloud (GCC)에 연결하는 경우 Standard (기본값)를 선택합니다.
          • Microsoft 365 US Government 소버린 클라우드 (GCC High 또는 DoD)에 연결하는 경우 미국 정부를 선택합니다.

        자세한 내용은 클라이언트 사용자 인증 정보 가져오기를 참조하세요.

      • 제휴 사용자 인증 정보 인증 방법으로 데이터 수집을 선택한 경우 주체 식별자를 복사하여 데이터 수집을 위한 제휴 사용자 인증 정보를 추가합니다.

        • 주체 식별자: 사용할 서비스 계정의 고유 ID입니다.

      • 제휴 검색을 선택한 경우 로그인을 클릭하고 서드 파티 로그인을 완료합니다.

    4. 계속을 클릭합니다.

    5. 제휴 검색을 선택한 경우 대상 섹션이 표시됩니다. 사이트의 기준 URL을 입력합니다.

    6. 계속을 클릭합니다.

    7. 고급 옵션 섹션에서 Microsoft 365 클라우드 환경을 선택합니다.

      • Microsoft 365 US Government 인스턴스에 연결하는 경우 GCC, GCC High 또는 DoD와 같이 해당 인스턴스와 일치하는 옵션을 선택합니다.
      • 그렇지 않으면 기본값인 Global을 유지합니다.

    8. 제휴 검색을 선택한 경우 고급 옵션 섹션에서 포함하거나 제외할 Microsoft SharePoint 사이트 또는 특정 경로를 지정하여 검색 및 작업의 범위를 세부적으로 조정할 수 있습니다. 포함된 경로 내에서만 데이터를 변이하거나 검색할 수 있습니다. 범위 외 데이터 요청은 실패하거나 결과를 반환하지 않습니다.

      Google Cloud 콘솔 또는 API를 사용하여 데이터 스토어에 필터를 추가할 수 있습니다.

      콘솔

      참고: 사이트를 여러 개 입력하는 경우 각 URL을 쉼표로 구분합니다. CSV 파일에서 URL 목록을 직접 복사하여 붙여넣을 수도 있습니다.

      1. 사이트 필터 섹션에서 다음을 수행합니다.
        • 필터 유형을 선택합니다(검색에 포함 또는 검색에서 제외).
        • 사이트 URL 필터 필드에 필터링할 정확한 Microsoft SharePoint 사이트 URL을 https://{your-tenant}.sharepoint.com/sites/{your-site-name} 형식으로 입력합니다.

          참고: 정확한 사이트 URL을 입력하세요. 이 특정 필드에서 하위 경로, 폴더 또는 문서 라이브러리가 지원되지 않습니다.

      2. 경로 필터 섹션에서 다음을 수행합니다.
        • 필터 유형을 선택합니다(검색에 포함 또는 검색에서 제외).
        • 경로 필터 필드에 전체 SharePoint 경로를 입력합니다.

          참고: 이 필드는 https://{your-tenant}.sharepoint.com/sites/{your-site-name}/{your-folder-name}/ 형식의 하위 경로, 폴더, 문서 라이브러리를 지원합니다. 지정된 경로 아래의 콘텐츠는 필터링됩니다.

      REST

      데이터 스토어를 만들 때 필터를 추가하려면 setUpDataConnector 메서드를 호출합니다.

      curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json" \
        -H "X-Goog-User-Project: PROJECT_ID" \
        "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
        -d '{
        "collectionId": "COLLECTION_ID",
        "collectionDisplayName": "COLLECTION_DISPLAY_NAME",
        "dataConnector": {
            "dataSource": "sharepoint_federated_search",
            "params": {
            "client_id": "CLIENT_ID",
            "client_secret": "CLIENT_SECRET",
            "instance_uri": "INSTANCE_URI",
            "tenant_id": "TENANT_ID",
            "FILTER_TYPE": {
                "FILTER_KEY": [
                "FILTER_VALUE1",
                "FILTER_VALUE2"
                ]
            }
            },
            "entities": [
            {
                "entityName": "file"
            }
            ],
            "refreshInterval": "7200s",
            "connectorType": "THIRD_PARTY_FEDERATED",
            "connectorModes": [
            "FEDERATED"
            ]
        }
        }'

      다음을 바꿉니다.

      • PROJECT_ID: 프로젝트의 ID입니다.
      • ENDPOINT_LOCATION: API 요청의 멀티 리전입니다. 다음 값 중 하나를 지정합니다.
        • 미국 멀티 리전의 경우 us
        • EU 멀티 리전의 경우 eu
        • 전역 위치의 경우 global
        자세한 내용은 데이터 스토어의 멀티 리전 지정을 참조하세요.
      • LOCATION: 데이터 스토어의 멀티 리전입니다(global, us 또는 eu).
      • COLLECTION_ID: 데이터 스토어의 고유 ID입니다.
      • COLLECTION_DISPLAY_NAME: 데이터 스토어의 표시 이름입니다.
      • CLIENT_ID: SharePoint 인증의 클라이언트 ID입니다.
      • CLIENT_SECRET: SharePoint 인증을 위한 클라이언트 보안 비밀번호입니다.
      • INSTANCE_URI: SharePoint의 인스턴스 URI입니다.
      • TENANT_ID: SharePoint의 테넌트 ID입니다.
      • FILTER_TYPE: Microsoft SharePoint 데이터 스토어에 추가된 필터의 유형입니다. 자세한 내용은 필터 유형을 참고하세요.
      • FILTER_KEY: 필터의 키로, 데이터의 필드에 해당합니다. 자세한 내용은 필터 키를 참고하세요.
      • FILTER_VALUES: 지정된 FILTER_KEY에 대해 필터링할 값입니다.

    필터 유형 및 필터 추가에 대한 자세한 내용은 Microsoft SharePoint 데이터 스토어에 필터 추가를 참고하세요.

  7. 계속을 클릭합니다.

    1. 검색할 항목(제휴 검색을 선택한 경우) 또는 동기화할 항목(데이터 수집을 선택한 경우) 섹션에서 다음 단계를 따르세요.
      1. 필요한 항목을 모두 선택합니다.
      2. 제휴 검색을 선택한 경우 다음 단계로 진행합니다.
      3. 데이터 수집을 선택한 경우 다음 단계를 계속 진행합니다.
        1. 선택사항: 특정 프로젝트를 동기화하려면 다음 단계를 따르세요.
          1. 필터를 클릭합니다.
          2. 색인에서 항목을 필터링하려면 색인에서 제외 체크박스를 선택하고, 색인에 포함되도록 하려면 색인에 포함 체크박스를 선택합니다.
          3. 키를 입력합니다. 각 키를 입력한 후 Enter 키를 누릅니다.
          4. 저장을 클릭합니다.
        2. 동기화 일정을 구성하려면 다음 단계를 따르세요.
          1. 동기화 빈도 목록에서 동기화 빈도를 선택합니다.
            • 항목 및 ID 데이터의 전체 동기화를 별도로 예약하려면 전체 동기화 섹션에서 메뉴를 펼친 후 커스텀 옵션을 선택합니다.
          2. 증분 동기화 빈도 목록에서 증분 동기화 빈도를 선택합니다. 자세한 내용은 동기화 일정을 참조하세요.

  8. 계속을 클릭합니다.

  9. 작업 섹션에서 다음을 수행합니다.

    1. 제휴 검색을 선택한 경우:
      1. 사용 설정할 Microsoft SharePoint 작업 선택에서 카테고리의 작업을 선택하여 커넥터에 사용 설정합니다.

    2. 데이터 수집을 선택한 경우:

      1. 인증 설정 섹션에서 선택한 연결 모드에 따라 인증을 구성합니다.

        1. 필요한 경우 다음 인증 세부정보를 제공합니다.

          • 클라이언트 ID: 조직의 Microsoft Entra ID에 등록된 애플리케이션의 고유 식별자입니다.
          • 클라이언트 보안 비밀번호: Microsoft Entra ID의 OAuth 2.0 애플리케이션 등록 프로세스 중에 생성된 보안 키입니다.
          • 테넌트 ID: Microsoft Entra 관리 센터에 있는 조직의 고유 식별자입니다.
          • 인스턴스 URI: Microsoft SharePoint 인스턴스의 기준 URL입니다(예: https://{your-domain}.sharepoint.com).

          자세한 내용은 클라이언트 사용자 인증 정보 가져오기를 참조하세요.

      2. 계속을 클릭합니다.

      3. 대상 섹션에 사이트의 기준 URL을 입력합니다.

      4. 계속을 클릭합니다.

      5. 사용 설정할 Microsoft SharePoint 작업 선택에서 카테고리의 작업을 선택하여 커넥터에 사용 설정합니다.

  10. 계속을 클릭합니다.

    작업 목록을 관리하려면 작업 관리를 참고하세요.

  11. 데이터 스토어 만들기 흐름에 고급 옵션 섹션이 표시되면 이 섹션에서 고정 IP 주소 사용 설정 체크박스를 선택할 수 있습니다. 이렇게 하면 데이터 저장소에서 소스 시스템의 허용 목록에 적합한 아웃바운드 트래픽에 고정된 IP 주소 집합을 사용합니다. 자세한 내용은 고정 IP 이그레스 구성을 참고하세요.

  12. 구성 섹션에서 다음을 수행합니다.

    1. 멀티 리전 목록에서 데이터 커넥터의 위치를 선택합니다.
    2. 데이터 커넥터 이름 필드에 커넥터 이름을 입력합니다.
    3. us 또는 eu를 위치로 선택한 경우 암호화 설정을 구성합니다.
      • 선택사항: 단일 리전 키를 구성하지 않은 경우 설정 페이지로 이동을 클릭하여 구성합니다. 자세한 내용은 서드 파티 커넥터용 단일 리전 키 등록을 참조하세요.
      • Google관리 암호화 키 또는 Cloud KMS 키를 선택합니다.
      • Cloud KMS 키를 선택한 경우 다음 단계를 따르세요.
        • 키 관리 유형 목록에서 적절한 유형을 선택합니다.
        • Cloud KMS 키 목록에서 키를 선택합니다.
      자세한 내용은 고객 관리 암호화 키를 참조하세요.

  13. 계속을 클릭합니다.

  14. 결제 섹션에서 일반 가격 또는 구성 가능한 가격을 선택합니다. 자세한 내용은 프로젝트의 결제 상태 확인 및 라이선스를 참조하세요.

  15. 만들기를 클릭합니다. Gemini Enterprise는 데이터 스토어를 만들고 데이터 스토어 페이지에 데이터 스토어를 표시합니다.

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

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

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

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

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

Microsoft SharePoint 항목 만들기 업데이트 삭제 권한 변경
첨부파일
댓글
이벤트
파일
페이지

데이터 스토어의 실시간 동기화를 사용 설정하려면 다음 단계를 따르세요.

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

    Gemini Enterprise

  2. 탐색 메뉴에서 데이터 스토어를 클릭합니다.

  3. 실시간 동기화를 사용 설정할 Microsoft SharePoint 데이터 스토어의 이름을 클릭합니다.

  4. 데이터 스토어 데이터 페이지에서 커넥터 상태가 활성으로 변경될 때까지 기다립니다.

  5. 실시간 동기화 필드에서 보기/수정을 클릭합니다.

  6. 실시간 동기화를 사용 설정하려면 실시간 동기화 사용 설정 전환 버튼을 클릭합니다.

  7. 클라이언트 보안 비밀 필드에 값을 입력합니다. 이 값은 Microsoft SharePoint 웹훅 이벤트를 확인하는 데 사용됩니다. 20자(영문 기준) 문자열을 사용하는 것이 좋습니다.

  8. 저장을 클릭합니다.

    실시간 동기화 필드가 실행 중으로 변경될 때까지 기다립니다.

데이터 처리 및 쿼리 실행

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

쿼리 실행

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

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

데이터 처리

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

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

다음 단계