파일 선택 도구 인증 구성

Gemini Enterprise 어시스턴트와 채팅할 때 사용자는 파일 선택 도구를 사용하여 파일을 첨부할 수 있습니다. 어시스턴트는 로컬 파일, Google Drive의 파일, Microsoft OneDrive의 파일 등 세 가지 파일 소스를 지원합니다. 이 페이지에서는 관리자가 이 동작을 구성하는 방법을 설명합니다.

최종 사용자가 Google Drive 및 OneDrive에서 파일을 선택하도록 하려면 Google Drive 데이터 스토어 및 OneDrive 데이터 스토어를 구성할 때 설정한 데이터 스토어 구성을 재사용하여 최종 사용자가 로그인하는 방법을 제어할 수 있습니다. 이를 통해 다음을 제어할 수 있습니다.

  • 선택 도구에서 사용하는 로그인 앱 선택 도구는 기본 Google 관리 애플리케이션 대신 커넥터에서 구성하는 Microsoft Entra(이전의 Azure AD) 또는 Google 애플리케이션을 재사용할 수 있습니다.
  • OneDrive 선택 도구에서 사용하는 Microsoft Entra 테넌트 OneDrive 선택 도구는 특정 Microsoft Entra 테넌트에 사용자를 로그인시킬 수 있습니다.

파일 첨부 및 채팅에 대한 최종 사용자 환경은 파일 업로드 및 채팅을 참조하세요.

파일 선택 도구 작동 방식

Google Drive 및 OneDrive 데이터 스토어가 파일 선택 도구에 동일한 승인 구성을 사용하도록 구성한 경우 파일 선택 도구는 동일한 설정을 사용하여 사용자를 인증합니다. 다음 표에는 두 가지 컨트롤과 영향을 받는 선택 도구가 요약되어 있습니다.

컨트롤 기능 적용 대상
맞춤 로그인 앱 사용자가 파일 선택 도구를 사용하여 어시스턴트에 파일을 첨부할 때 사용자를 인증하기 위해 Gemini Enterprise는 기본 Google 관리 애플리케이션 대신 데이터 스토어의 기존 Microsoft Entra ID 또는 Google 아이덴티티 구성을 사용할 수 있습니다. Google Drive 및 OneDrive
테넌트 시행 OneDrive 선택 도구를 사용하려면 사용자가 공유 로그인 엔드포인트(/common/)가 아닌 특정 Microsoft Entra 테넌트(https://login.microsoftonline.com/{your-tenant}/...)에 로그인해야 하므로 다른 테넌트의 사용자는 인증할 수 없습니다. 테넌트는 연결된 OneDrive 커넥터에서 읽습니다. OneDrive만 해당

관리자는 커넥터를 앱에 연결하여 이 동작을 구성합니다.

구성 제공업체를 지정하면 다음 규칙이 적용됩니다.

  • 커넥터 유형당 하나의 제공업체. 한 번에 하나의 OneDrive 구성 제공업체와 하나의 Google Drive 구성 제공업체만 앱에 연결할 수 있습니다. 동일한 유형의 두 번째 커넥터를 제공업체로 표시하면 잘못된 인수 오류로 인해 거부됩니다.
  • 제공업체는 작업이 사용 설정된 커넥터여야 합니다. 구성 제공업체는 작업 또는 제휴 액세스를 지원하는 OneDrive 또는 Google Drive 커넥터여야 합니다. 수집 전용 커넥터는 구성 제공업체가 될 수 없습니다. 자세한 내용은 작업 관리를 참조하세요.

시작하기 전에

파일 선택 도구를 구성하기 전에 다음 사항을 확인하세요.

  • 관리자 액세스 검색 엔진 편집자 역할(roles/discoveryengine.editor)을 부여합니다. 이 역할은 사용자가 데이터 스토어를 만드는 데 필요합니다. 이 역할을 부여하려면 다음 단계를 따르세요.
    1. Google Cloud 콘솔에서 IAM 페이지로 이동합니다.

      IAM으로 이동

    2. 사용자 계정을 찾아 수정 수정을 클릭합니다.
    3. 사용자에게 Discovery Engine Editor 역할을 부여합니다. 자세한 내용은 IAM 역할 및 권한을 참조하세요.
  • 커스텀 OneDrive 로그인 앱. 클라이언트 ID, 클라이언트 보안 비밀번호, 테넌트 ID를 포함하여 제어하는 Microsoft Entra ID 애플리케이션과 테스트를 위해 해당 테넌트 내에 OneDrive 계정이 있는지 확인합니다. 자세한 내용은 Microsoft Identity Platform에 애플리케이션 등록을 참조하세요.
  • 구성된 데이터 스토어 OneDrive 데이터 스토어 또는 Google Drive 데이터 스토어를 구성합니다. 데이터 스토어를 구성할 때 OneDrive 데이터 스토어의 클라이언트 ID, 클라이언트 보안 비밀번호, 테넌트 ID가 포함된 인증 설정을 구성합니다. 자세한 내용은 다음을 참조하세요.
  • 데이터 스토어가 연결되었습니다. OneDrive 데이터 스토어 또는 Google Drive 데이터 스토어를 Gemini Enterprise 앱에 연결합니다. 자세한 내용은 앱에 데이터 스토어 연결을 참조하세요.

자체 로그인 앱 사용

기본적으로 선택 도구는 로그인을 위해 Google 관리 애플리케이션을 사용합니다. 하나의 커넥터를 선택 도구의 구성 제공업체로 지정하여 선택 도구에서 자체 Microsoft Entra ID 또는 Google 아이덴티티를 대신 사용하도록 할 수 있습니다.

이미 구성된 OneDrive 또는 Google Drive 데이터 스토어가 있는 경우 다음 단계를 따르세요.

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

    Gemini Enterprise

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

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

  4. 데이터 스토어를 검색하고 데이터 스토어 이름을 클릭합니다.

  5. 파라미터 보기/수정을 클릭합니다.

  6. 선택 도구 구성 제공자 옵션을 선택합니다.

  7. 저장을 클릭합니다.

Google 관리 애플리케이션을 사용하도록 변경사항 되돌리기

파일 선택 도구 인증에 기본 Google 관리 애플리케이션을 사용하도록 되돌리려면 다음 단계를 따르세요.

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

    Gemini Enterprise

  2. Google Cloud 프로젝트를 선택합니다.

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

  4. 데이터 스토어 이름을 클릭합니다.

  5. 파라미터 보기/수정을 클릭합니다.

  6. 선택 도구 구성 제공업체 필드를 지웁니다.

  7. 저장을 클릭합니다.

최종 사용자 환경

선택 도구를 구성하면 최종 사용자에게 다음과 같은 환경이 제공됩니다.

  • OneDrive의 경우 사용자에게 조직의 Microsoft 테넌트에 로그인하라는 메시지가 표시됩니다. 다른 테넌트의 계정은 거부됩니다.
  • 로그인에는 구성한 애플리케이션이 사용됩니다. 기본적으로 Google 관리 애플리케이션이 사용되지만 구성 제공업체를 설정한 경우 자체 애플리케이션이 사용됩니다.
  • 처음 로그인에 성공하면 이후 파일 선택을 위해 연결이 기억됩니다.

최종 사용자 환경에 대한 자세한 내용은 파일 업로드 및 채팅을 참조하세요.

문제 해결

증상 가능한 원인 해결 방법
커넥터를 **선택 도구 구성 제공업체** 로 표시하면 Cannot enable picker_config_provider on data connector '...' because another connector in the same engine is already the picker config provider: '...'. An engine can have at most one picker_config_provider connector; disable it on the other connector first. 오류가 발생합니다. 동일한 엔진의 다른 커넥터가 이미 선택 도구 구성 제공업체입니다. 엔진에는 최대 1개가 있을 수 있습니다. 다른 커넥터에서 **선택 도구 구성 제공업체** 매개변수를 지운 후 다시 시도하세요.
OneDrive 로그인 실패(AADSTS50020: User account 'user@domain.com' from identity provider '...' does not exist in tenant '...') 사용자 계정이 커넥터에 구성된 테넌트와 다른 Microsoft Entra 테넌트에 있습니다. 테넌트별 로그인 엔드포인트가 계정을 거부합니다. 테넌트 시행이 의도한 대로 작동합니다. 사용자가 구성된 테넌트의 계정으로 로그인하도록 하거나 커넥터의 테넌트 ID를 업데이트합니다.
OneDrive에서 공유 로그인 엔드포인트를 계속 표시합니다. 테넌트가 아직 구성되지 않았거나 변경사항이 전파되지 않았습니다. 커넥터의 테넌트 ID를 확인합니다. 구성 변경사항이 적용되는 데 최대 3분 정도 걸릴 수 있습니다. 잠시 기다린 후 다시 시도하세요.

다음 단계