Microsoft 365 구성

이 페이지에서는 Microsoft 365 데이터 스토어를 만들기 전에 서드 파티 애플리케이션을 설정하고 구성하는 방법을 설명합니다.

인증 및 권한 설정

Microsoft 365 커넥터는 Microsoft Identity Platform에 대해 OAuth 2.0 승인 코드 플로우를 사용하여 최종 사용자로 로그인합니다. 모든 Microsoft Graph 권한이 위임되므로 커넥터는 로그인한 사용자가 이미 도달할 수 있는 데이터에만 도달할 수 있습니다. 다음 두 가지 방법 중 하나로 인증을 구성할 수 있습니다.

  • Google관리형 OAuth(OAuth 2.0(Google 관리형), 기본값): 커넥터는Google 에서 등록하고 관리하는 멀티테넌트 Microsoft Entra 애플리케이션을 사용합니다. 애플리케이션을 등록하거나 테넌트 ID, 클라이언트 ID 또는 클라이언트 보안 비밀번호를 입력하지 않습니다. Google관리형 OAuth 사용을 참조하세요.
  • 자체 앱 사용(OAuth 2.0(자체 앱 사용)): 자체 Microsoft Entra 애플리케이션을 등록하고, 사용 설정하려는 작업에 대한 Microsoft Graph 권한을 부여하고, Gemini Enterprise에 테넌트 ID, 클라이언트 ID, 클라이언트 보안 비밀번호를 입력합니다. 조직에서 애플리케이션과 권한을 직접 제어해야 하거나, 고정 IP 이그레스가 필요하거나, 테넌트가 미국 정부 클라우드에 있는 경우 이 옵션을 선택합니다. Microsoft Entra 앱 등록을 참조하세요.

Google관리 OAuth 사용

OAuth 2.0(Google 관리)을 사용하면 데이터 스토어를 만들기 전에 Microsoft Entra에서 아무것도 만들지 않습니다. 사용자가 커넥터를 승인하면 Microsoft는 사용 설정된 작업에 필요한 Microsoft Graph 권한에 동의하도록 요청합니다. 전체 목록은 Microsoft API 권한 구성을 참조하세요.

이러한 권한 중 일부와 일부 테넌트 동의 정책은 Microsoft Entra 관리자가 조직을 대신하여 동의해야 합니다. 커넥터를 승인할 때 사용자에게 관리자 승인 필요 메시지가 표시되면 관리자가 Google관리형 애플리케이션에 테넌트 전체 동의를 부여해야 합니다. 자세한 내용은 Microsoft 문서의 애플리케이션에 테넌트 전체 관리자 동의 부여를 참조하세요.

Google관리형 OAuth를 사용할 때는 다음 사항에 유의하세요.

  • Google관리형 애플리케이션은 상용 Microsoft 클라우드에 등록되므로 Microsoft 365 환경 유형을 표준으로 설정합니다. GCC High 또는 DoD의 테넌트의 경우 OAuth 2.0(자체 앱 사용)을 사용합니다.
  • 공유 애플리케이션은 고객별 IP 허용 목록을 전달할 수 없으므로 고정 IP 이그레스를 사용할 수 없습니다.

이 섹션의 나머지 부분은 OAuth 2.0(자체 앱 사용)에만 적용됩니다.

Microsoft 365 커넥터용 Microsoft Entra 앱 등록

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

  1. Microsoft Entra 관리 센터로 이동합니다.

  2. 탐색 메뉴에서 Entra ID를 펼치고 앱 등록을 선택합니다.

  3. 앱 등록 페이지에서 새 등록을 클릭합니다.

  4. 애플리케이션 등록 페이지에서 다음을 수행합니다.

    1. 이름 필드에 앱 이름을 입력합니다.
    2. 지원되는 계정 유형 섹션에서 이 조직 디렉터리의 계정만을 선택합니다.
    3. 리디렉션 URI 섹션에서 다음을 수행합니다.
      1. 플랫폼 목록에서 웹을 선택합니다.
      2. 리디렉션 URI 필드에 https://vertexaisearch.cloud.google.com/oauth-redirect를 입력합니다.
    4. 등록을 클릭합니다. Microsoft Entra에서 앱을 만들고 앱의 개요 페이지를 표시합니다.

클라이언트 ID와 클라이언트 보안 비밀번호 가져오기

  1. 클라이언트 ID를 가져오려면 다음 단계를 따르세요.

    1. 앱 탐색 메뉴에서 개요를 선택합니다.
    2. 애플리케이션(클라이언트) ID를 복사합니다.
  2. 앱의 클라이언트 보안 비밀번호를 가져오려면 다음을 수행합니다.

    1. 앱 탐색 메뉴에서 인증서 및 보안 비밀을 선택합니다.
    2. 새 클라이언트 보안 비밀번호를 클릭합니다.
    3. 클라이언트 보안 비밀 창에서 다음을 수행합니다.
      1. 설명 필드에 보안 비밀에 대한 설명을 입력합니다.
      2. 만료 목록에서 만료 기간을 선택합니다.
      3. 추가를 클릭합니다.
    4. 값 열에서 클라이언트 보안 비밀번호를 복사합니다.

테넌트 ID 가져오기

테넌트 ID는 Microsoft Entra 관리 센터의 개요 페이지에 있는 테넌트 ID 상자에서 찾을 수 있습니다.

Microsoft API 권한 구성하기

OAuth 2.0(자체 앱 사용)을 사용하는 경우 사용 설정하려는 작업에 대해 앱에 위임된 Microsoft Graph 권한을 부여합니다. OAuth 2.0(Google 관리)을 사용하는 경우 이러한 권한을 직접 추가하지 않습니다. 사용자가 커넥터를 승인할 때 권한에 동의하라는 메시지가 표시됩니다.

각 작업에 필요한 권한은 지원되는 작업 테이블의 필요한 권한 열에 나열됩니다. 또한 모든 연결에는 User.Read 및 offline_access가 필요합니다.

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

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

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

  3. API 권한 요청 페이지에서 Microsoft Graph를 선택한 후 위임된 권한을 선택합니다.

  4. User.Read, offline_access, 사용 설정하려는 각 작업에 대해 나열된 권한을 검색하고 선택합니다.

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

Sovereign Cloud 및 Government Cloud

테넌트가 표준 Microsoft 클라우드에 없는 경우 데이터 스토어를 만들 때 다음 두 가지를 모두 설정합니다. 미국 정부를 통해 로그인하려면 해당 클라우드에 등록된 앱과 함께 OAuth 2.0(자체 앱 사용)이 필요합니다.

  • 인증 설정 섹션의 Microsoft 365 환경 유형은 로그인 엔드포인트를 선택합니다. 표준은 login.microsoftonline.com를 사용하고 미국 정부는 login.microsoftonline.us를 사용합니다.

  • Microsoft 365 클라우드 환경: 고급 옵션 섹션에서 Microsoft Graph 엔드포인트를 선택합니다. 표준/GCC는 https://graph.microsoft.com를 사용하고, GCC High는 https://graph.microsoft.us를 사용하고, DoD는 https://dod-graph.microsoft.us를 사용합니다.

문제 해결

이 섹션에서는 Microsoft Entra 애플리케이션을 구성한 후 발생할 수 있는 오류와 해결 방법을 설명합니다.

HTTP 403으로 작업 실패

HTTP 403을 반환하는 작업에는 일반적으로 권한이 누락되어 있습니다. 작업에 필요한 권한에 동의했는지, 필요한 경우 관리자 동의가 부여되었는지, 작업이 사용 설정된 후 연결이 다시 승인되었는지 확인합니다. OAuth 2.0(자체 앱 사용)을 사용하는 경우 Microsoft Entra 앱 등록에서 권한을 부여하는지 확인합니다. 기존 갱신 토큰에는 발급 시 동의한 범위만 포함됩니다.

메일 검색에서 MailboxNotEnabledForRESTAPI 반환

이 오류는 Microsoft Graph를 통해 편지함에 연결할 수 없음을 의미합니다. 이 오류는 사서함이 하이브리드 Exchange 배포에서 온프레미스로 호스팅되거나, 사서함이 비활성 상태이거나 소프트 삭제된 경우, 또는 테넌트 또는 디렉터리가 일치하지 않는 경우에 발생합니다. 이 문제를 해결하려면 사서함이 Exchange Online에서 호스팅되는지 확인하세요. 자세한 내용은 Microsoft 문서의 MailboxNotEnabledForRESTAPI 해결 방법을 참조하세요.