외부 콘텐츠 커넥터에 대한 Microsoft SharePoint Online 사이트 컬렉션 액세스 구성

커넥터에 대해 등록된 OAuth 2.0 앱에 SharePoint API FullControl 권한을 부여하여 커넥터가 사이트 컬렉션을 크롤링할 수 있도록 허용 Microsoft SharePoint Online 합니다.

시작하기 전에

관리자 권한으로 PowerShell을 실행하여 시스템에서 상승된 PowerShell 세션을 Windows 열 수 있는 권한이 있어야 합니다.

Windows 시스템에 PnP PowerShell 모듈이 설치되어 있어야 합니다. 이 모듈에 대한 자세한 내용은 Learn 사이트 및 PnP PowerShell 사이트의 MicrosoftPnP PowerShell 개요 문서를 참조하세요.

주:

PowerShell 세션에서 Get-Command -Module PnP.PowerShell 을 실행하여 PnP PowerShell 모듈이 설치되어 있는지 확인할 수 있습니다. 이 cmdlet은 모듈이 설치된 경우 설치된 PnP PowerShell 별칭 및 cmdlet 목록을 반환합니다. cmdlet이 결과를 반환하지 않으면 모듈이 설치되지 않은 것입니다.

PnP PowerShell에 사용하려면 Entra ID 애플리케이션이 등록되어 있어야 합니다. 이 Entra ID 애플리케이션에는 다음 API 권한이 부여되어야 합니다.

• Microsoft 그래프 API의 Sites.FullControl.All 애플리케이션 권한
• AllSites.SharePoint API에서 위임된 권한 읽기

이 애플리케이션을 등록하고 API 권한을 부여하는 방법에 대한 자세한 내용은 PnP PowerShell 사이트에서 PnP PowerShell과 함께 사용할 Entra ID 애플리케이션 등록 문서를 참조하세요.

주:

Entra ID 애플리케이션을 사용하면 PnP PowerShell을 사용하여 사이트 컬렉션에 Microsoft SharePoint Online 연결할 수 있습니다. 외부 콘텐츠 커넥터용 Microsoft SharePoint Online 으로 구성된 OAuth 2.0 앱과는 다릅니다.

필요한 역할: 없음

이 태스크 정보

이 작업은 커넥터에 대해 등록된 OAuth 2.0 앱을 구성할 때 Sites.FullControl.All 권한 대신 Sites.Selected SharePoint API 권한을 지정하는 Microsoft SharePoint Online 경우에만 필요합니다.

주:

OAuth 2.0 앱 구성 프로세스에 대한 자세한 내용은 다음 문서를 참조하십시오 외부 콘텐츠 인덱싱을 위해 구성 Microsoft SharePoint Online.

기본적으로 소스 시스템 관리자는 커넥터에 대해 등록된 OAuth 2.0 앱에 Sites.FullControl.All SharePoint API 권한을 부여합니다 Microsoft SharePoint Online . 이 권한을 사용하면 커넥터가 모든 원본 시스템 사이트 모음의 모든 콘텐츠 유형에 대한 콘텐츠, 메타데이터 및 보안 정보를 읽을 수 있습니다.

조직의 보안 관행에서 Sites.FullControl.All 권한 부여를 허용하지 않는 경우 대신 OAuth 2.0 애플리케이션에 Sites.Selected SharePoint API 권한을 부여할 수 있습니다. 이 권한이 부여되면 커넥터는 Microsoft SharePoint Online OAuth 2.0 앱에 FullControl 권한이 있는 사이트 컬렉션에 대한 콘텐츠, 메타데이터 및 보안 정보만 읽을 수 있습니다.

원본 시스템 관리자는 커넥터가 Microsoft SharePoint Online 크롤링할 수 있도록 할 각 사이트 모음에 대해 FullControl 권한을 부여해야 합니다. 커넥터가 사이트 모음을 크롤링하지 못하도록 하려면 해당 사이트 모음에 대해 이전에 부여된 FullControl 권한을 취소할 수 있습니다.

프로시저

1. Windows 시스템에서 관리자 권한으로 PowerShell을 실행하여 관리자 권한 PowerShell 세션을 시작합니다.
2. 사이트 모음에 대한 PnP PowerShell 연결을 설정합니다.
   1. 관리자 권한 PowerShell 세션에서 이 cmdlet을 실행하고, <siteURL> 을 액세스 권한을 변경하려는 사이트 컬렉션의 URL로, <clientId> 를 PnP PowerShell 모듈에 사용하도록 등록된 Entra ID 애플리케이션의 앱 ID로 바꿉니다.

      Connect-PnPOnline -Url <siteUrl> -Interactive -ClientId <clientId>

   2. 메시지가 표시되면 계정 자격 증명을 Microsoft 입력합니다.
3. 외부 콘텐츠 커넥터에 대한 OAuth 2.0 앱에 쓰기 권한을 부여합니다.Microsoft SharePoint Online
   1. 관리자 권한 PowerShell 세션에서 이 cmdlet을 실행하고 <appId> 및 <name>을 외부 콘텐츠 커넥터에 등록된 OAuth 2.0 앱의 애플리케이션 ID 및 표시 이름으로 바꿉니다.Microsoft SharePoint Online

      Grant-PnPAzureADAppSitePermission -AppId appId -DisplayName <name> -Permissions Write

   2. cmdlet 응답에서 권한 ID를 기록합니다.
      중요사항:

      PnP를 사용하여 사이트 모음에 대한 FullControl 권한을 부여하려면 이 권한 ID가 필요합니다.
4. 외부 콘텐츠 커넥터에 대한 Microsoft SharePoint Online OAuth 2.0 앱에서 사이트 컬렉션 에 대한 권한을 수정하거나 확인합니다.
   • 앱에 사이트 모음에 대한 FullControl 권한을 부여하고 외부 콘텐츠 커넥터에 의한 Microsoft SharePoint Online 크롤링을 허용하려면 관리자 권한 PowerShell 세션에서 이 cmdlet을 실행하여 <permissionId>를 단계에서 기록한 권한 ID로, <siteURL>을 사이트 모음의 URL로 바꿉니다.3.b

     Set-PnPAzureADAppSitePermission -PermissionId <permissionId> -Permissions FullControl -Site <siteUrl>

   • 사이트 모음에 대한 앱의 FullControl 권한을 취소하고 외부 콘텐츠 커넥터에 의한 Microsoft SharePoint Online 크롤링을 방지하려면 관리자 권한 PowerShell 세션에서 이 cmdlet을 실행하여 <permissionId> 를 단계에서 3.b 기록한 권한 ID로, <siteURL> 을 사이트 모음의 URL로 바꿉니다.

     Revoke-PnPAzureADAppSitePermission -PermissionId <permissionId> -Site <siteUrl>

   • 사이트 모음에 대한 앱의 기존 권한을 보려면 관리자 권한 PowerShell 세션에서 이 cmdlet을 실행하여 <permissionId> 를 단계에서 3.b 기록한 권한 ID로, <siteURL> 을 사이트 모음의 URL로 바꿉니다.

     Get-PnPAzureADAppSitePermission -PermissionId <permissionId> -Site <siteUrl>

5. 관리자 권한 PowerShell 세션에서 다음 cmdlet을 실행하여 사이트 컬렉션에서 연결을 끊습니다.

   Disconnect-PnPOnline

6. 권한을 수정하려는 각 추가 사이트 모음에 대해 단계를 2 반복 5 합니다.

다음에 수행할 작업

외부 콘텐츠 커넥터에 대해 Microsoft SharePoint Online 부여된 FullControl 권한이 있는 사이트 컬렉션 목록을 관리자에게 Now Platform 제공합니다. 선택한 사이트만 크롤링하도록 외부 콘텐츠 커넥터를 Microsoft SharePoint Online 구성하려면 이 목록이 필요합니다.

외부 콘텐츠 커넥터 생성 및 구성 Microsoft SharePoint Online 에 대한 자세한 내용은 다음 문서를 참조하십시오 .