데이터 페더레이션을 사용하여 Microsoft SharePoint Online 연결

이 페이지에서는 데이터 페더레이션을 사용하여 Microsoft SharePoint Online을 Gemini Enterprise에 연결하는 방법을 설명합니다.

페더레이션 검색을 사용하여 SharePoint 계정에서 검색하려면 다음 절차를 따르세요.

데이터 페더레이션 정보

데이터 페더레이션을 사용하면 Gemini Enterprise는 데이터를 Gemini Enterprise에 복사하는 대신 API를 사용하여 서드 파티 데이터 소스에서 정보를 직접 가져옵니다. 이 방법을 사용하면 수집을 기다릴 필요 없이 외부 데이터 소스에 즉시 액세스할 수 있습니다.

시작하기 전에

Gemini Enterprise에서 커넥터를 만들기 전에 SharePoint에 대한 보안 액세스를 사용 설정하도록 Entra 애플리케이션 등록을 설정해야 합니다.

  1. Entra에서 Gemini Enterprise를 OAuth 2.0 애플리케이션으로 등록하려면 다음을 수행하세요.

    1. Microsoft Entra 관리 센터로 이동합니다.
    2. 메뉴에서 애플리케이션 섹션을 펼치고 앱 등록을 선택합니다.
    3. 앱 등록 페이지에서 새 등록을 선택합니다.
      Entra에 새 앱 등록
      Microsoft Entra 관리 센터에 새 앱 등록
    4. 애플리케이션 등록 페이지에서 앱 등록을 만듭니다.
      조직 디렉터리에만 계정 등록
      계정 유형을 선택하고 리디렉션 URI를 입력합니다.
    5. 지원되는 계정 유형 섹션에서 조직 디렉터리의 계정만을 선택합니다.

    6. 리디렉션 URI 섹션에서 웹을 선택하고 다음 URL을 웹 콜백 URL(또는 리디렉션 URL)로 입력합니다.

      • https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html
      • https://vertexaisearch.cloud.google.com/oauth-redirect

    7. 등록을 클릭합니다. 앱이 생성됩니다.

  2. 앱의 클라이언트 ID와 보안 비밀을 얻으려면 다음을 수행하세요.

    1. 앱 페이지에서 인증서 및 보안 비밀을 선택합니다.
    2. 새 클라이언트 보안 비밀번호를 클릭합니다.
    3. 보안 비밀에 대한 설명을 입력합니다.
    4. 만료 기간을 선택합니다. 기본값을 선택하는 것이 좋습니다.
    5. 추가를 클릭합니다.
    6. 값 열에 표시된 보안 비밀(Client Secret)과 보안 비밀 ID 열에 표시된 식별자(Client ID)를 복사하여, 나중에 사용할 수 있도록 안전하게 보관합니다.

  3. 앱에 필요한 API 권한을 구성하려면 다음을 수행하세요.

    1. 앱 페이지에서 API 권한을 선택합니다.

    2. 권한 추가를 클릭합니다.

    3. API 권한 요청 페이지에서 SharePoint를 선택합니다.

    4. 위임된 권한을 선택합니다.

    5. 다음 권한을 검색하여 선택합니다.

      • Sites.Search.All

      사이트 액세스를 위해 다음 권한 중 하나를 선택합니다.

      • AllSites.Read: 사용자가 액세스 권한을 가진 모든 사이트의 문서를 검색할 수 있도록 허용합니다.
      • Sites.Selected: 더 높은 수준의 관리 제어를 제공합니다. 관리자는 사용자가 쿼리할 수 있는 사이트를 제한할 수 있지만 사용 설정하려는 각 사이트에 대해 개별적으로 액세스 권한을 부여해야 합니다. 자세한 내용은 특정 사이트 모음에 권한 부여를 참조하세요.

    6. 권한 추가를 클릭합니다.

SharePoint로 제휴 검색 커넥터 만들기

콘솔

Google Cloud 콘솔을 사용하여 Gemini Enterprise에서 SharePoint를 통해 제휴 검색을 수행하려면 다음 단계를 따르세요.

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

    Gemini Enterprise

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

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

  4. 데이터 소스 선택 페이지에서 SharePoint 제휴를 스크롤하거나 검색하여 서드 파티 소스를 연결합니다.

    데이터 스토어 만들기
    SharePoint 페더레이션 검색

  5. 인증 설정에서 다음을 수행합니다.

    1. 클라이언트 ID, 클라이언트 보안 비밀번호, 인스턴스 URL, 테넌트 ID를 입력합니다.
    2. 인증을 클릭합니다.

    3. 계속을 클릭합니다.

      enter-auth-info
      인증 정보를 입력합니다.

  6. 검색할 항목 유형을 선택합니다.

    select-region-enter-name
    항목 유형을 선택합니다.

  7. 데이터 소스의 리전을 선택합니다.

  8. 데이터 소스의 이름을 입력합니다.

    select-region-enter-name
    데이터 커넥터를 구성합니다.

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

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

사용자 승인

제휴 검색 데이터 스토어를 만들면 소스 관리 패널에 데이터 소스 중 하나로 표시될 수 있습니다. 이전에 Gemini Enterprise를 승인하지 않은 경우 데이터 소스를 선택할 수 없습니다. 대신 승인 버튼이 옆에 표시됩니다.

승인 흐름을 시작하려면 다음 단계를 따르세요.

  1. 승인을 클릭합니다. SharePoint 승인 서버로 리디렉션됩니다.
    승인 클릭
    승인을 클릭합니다.

  2. 계정에 로그인합니다.

  3. 액세스 권한 부여를 클릭합니다. 액세스 권한을 부여하면 승인 흐름을 완료하기 위해 Gemini Enterprise로 리디렉션됩니다. Gemini Enterprise가 access_token을 획득하고 이를 사용하여 서드 파티 검색에 액세스합니다.

쿼리 실행

검색어를 입력하면 다음과 같이 진행됩니다.

  • SharePoint가 승인되면 Gemini Enterprise가 SharePoint API에 쿼리를 보냅니다.
  • Gemini Enterprise는 결과를 다른 소스의 결과와 혼합하여 표시합니다.

데이터 처리

서드 파티 제휴 검색을 사용하면 쿼리 문자열이 서드 파티 검색 백엔드로 전송됩니다. 이러한 서드 파티는 쿼리를 사용자의 ID와 연결할 수 있습니다. 여러 제휴 검색 데이터 소스가 사용 설정된 경우 쿼리가 모든 데이터 소스로 전송될 수 있습니다.

데이터가 서드 파티 시스템에 도달하면 해당 시스템의 서비스 약관 및 개인정보처리방침( Google Cloud의 약관 아님)이 적용됩니다.