Microsoft SharePoint On-Prem 커넥터 배포

이 가이드는 Google Cloud Search SharePoint On-Prem 커넥터의 관리자, 즉 커넥터의 다운로드, 구성, 실행, 모니터링을 담당하는 모든 사람을 대상으로 합니다.

가이드 내용에는 SharePoint On-Prem 커넥터 배포와 관련된 주요 작업을 수행하기 위한 안내가 포함되어 있습니다.

  • Google Cloud Search SharePoint On-Prem 커넥터 소프트웨어 다운로드
  • 온프레미스 SharePoint Server 데이터 소스와 함께 사용할 커넥터 구성
  • 커넥터 배포 및 실행

이 문서에 나오는 개념을 이해하려면 G Suite, 온프레미스 SharePoint Server의 기본사항을 잘 알고 있어야 합니다.

개요

Google Cloud Search는 기본적으로 Google 문서, Gmail과 같은 G Suite 데이터를 탐색하고, 색인을 생성하고, 관련 콘텐츠를 제공할 수 있습니다. Sharepoint On-Prem 커넥터를 사용하면 Google Cloud Search를 확장하여 사용자에게 SharePoint On-Prem 콘텐츠를 제공할 수 있습니다.

구성 속성 파일

커넥터가 온프레미스 SharePoint의 콘텐츠를 검색하고 Indexing API에 업로드할 수 있게 하려면 구성 파일을 만들어서 커넥터에 특정 정보를 제공해야 합니다. 배포 단계에 설명된 구성 단계가 진행되는 동안 매개변수를 추가해 구성 파일을 빌드해야 합니다.

이 문서에서 설명하는 SharePoint On-Prem 커넥터 매개변수 외에도 모든 Cloud Search 커넥터에서 사용되는 구성 매개변수가 있습니다. 자세한 내용은 Google 제공 커넥터 매개변수를 참조하세요.

지원되는 운영체제

  • Windows Server 2016
  • Ubuntu
  • Red Hat Enterprise Linux 5.0
  • SUSE Enterprise Linux 10(64비트)

지원되는 SharePoint 버전

  • SharePoint Server 2016
  • SharePoint Server 2013

게시되지 않은 문서의 색인 생성

Cloud Search SharePoint On-Prem 커넥터는 항상 SharePoint의 검색 공개 상태 설정을 따릅니다. 이 설정은 사용자가 재정의할 수 없습니다. 임시 문서의 경우 색인 생성은 커넥터 사용자 계정에 부여된 권한에 따라 결정됩니다. 커넥터 사용자에게 '전체 읽기' 권한만 있는 경우 커넥터는 SharePoint의 모든 '임시 항목 공개 상태' 설정을 따릅니다.

지원되는 인증 메커니즘

  • NTLM
  • Kerberos
  • HTTP 기본
  • ADFS

커넥터 제한사항

  • 콘텐츠 데이터베이스의 수는 문서 변경 감지 지연 시간에 영향을 줍니다.
  • 각 사이트 모음의 ACL에 사용된 순 사용자 및 그룹의 수는 메모리 소비에 영향을 줍니다.
  • 커넥터의 현재 버전은 단일한 Active Directory 도메인의 ID를 지원합니다.
  • 커넥터의 현재 버전은 잘 알려진 Active Directory 및 Windows 주 구성원(예: Everyone, BUILTIN\Users, All Authenticated Users)을 지원하지 않습니다.
  • 커넥터의 현재 버전은 즉각적인 삭제 알림을 생성하지 않습니다.
  • 커넥터의 현재 버전은 소스 저장소의 삭제 내용을 식별하기 위해 콘텐츠의 색인 재생성을 사용합니다. 이전에 색인을 생성한 콘텐츠의 경우 삭제 감지 지연 시간이 4시간 넘게 걸릴 수 있습니다.

Cloud Search SharePoint On-Prem 커넥터를 배포하기 전에

Google Cloud Search SharePoint On-Prem 커넥터를 배포하기 전에 다음과 같은 필수 구성요소가 있는지 확인하세요.

  • 지원되는 운영체제Sharepoint Server
  • Google Cloud Search SharePoint On-Prem 커넥터를 실행하는 컴퓨터에 설치된 자바 JRE 1.8
  • Google Cloud Search와 데이터 소스 간의 관계를 설정하는 데 필요한 G Suite 정보:

    일반적으로 도메인의 G Suite 관리자가 이러한 사용자 인증 정보를 제공할 수 있습니다.

  • 사용자 정책에 따라 SharePoint 웹 애플리케이션에 대한 전체 읽기 권한이 있는 커넥터의 사용자 계정

  • 웹 애플리케이션에 루트 사이트 모음이 있는지 확인합니다. 이 커넥터는 루트 사이트 모음이 없는 웹 애플리케이션의 콘텐츠 색인 생성을 지원하지 않습니다.

  • 쓰기 잠금 사이트 모음이 있으면 커넥터를 설치하기 전에 관리자 권한이 있는 계정을 사용하여 SharePoint에서 PrepareWriteLockedSitesForAdaptor.ps1 스크립트를 실행하세요.

  • 이 커넥터를 구성하는 데 도움이 되도록 팜 관리 권한을 사용해 SharePoint 서버에 로그인하여 diagnose_sp.ps1을 실행하세요.

    이 명령어의 결과는 웹 애플리케이션 개수, 문서 개수, 사용자 그룹 멤버십 개수를 포함하므로, 필요한 커넥터 인스턴스 개수, 메모리 소요량, 예상 문서 개수를 추정하는 데 도움이 됩니다.

배포 단계

Google Cloud Search SharePoint On-Prem 커넥터를 배포하는 방법은 다음과 같습니다.

  1. Google Cloud Search SharePoint On-Prem 커넥터 소프트웨어 설치
  2. SharePoint On-Prem 커넥터 구성을 지정합니다.
  3. Google Cloud Search 데이터 소스에 대한 액세스를 구성합니다.
  4. SharePoint On-Prem에 대한 액세스를 구성합니다.
  5. SharePoint를 신뢰할 수 있는 호스트로 추가합니다.
  6. 사이트 모음을 구성합니다.
  7. 로깅을 사용 설정합니다.
  8. Google Cloud Search로 SharePoint ID 매핑을 구성합니다.
  9. Active Directory 조회를 구성합니다.
  10. HTML 생성 및 구조화된 데이터 지원을 구성합니다.

1. Google Cloud Search SharePoint On-Prem 커넥터 소프트웨어 설치

  1. GitHub의 커넥터 저장소를 클론합니다.

    $ git clone https://github.com/google-cloudsearch/sharepoint-connector.git
        $ cd sharepoint-connector
  2. 원하는 버전의 커넥터를 체크아웃합니다.

    $ git checkout tags/v1-0.0.3
  3. 커넥터를 빌드합니다.

    $ mvn package

    커넥터를 빌드할 때 테스트를 건너뛰려면 mvn package 대신 mvn package -DskipTests를 실행합니다.

  4. 커넥터 zip 파일을 로컬 설치 디렉터리에 복사합니다.

    $ cp target/google-cloudsearch-sharepoint-connector-v1-0.0.3.zip installation-dir
        $ cd installation-dir
        $ unzip google-cloudsearch-sharepoint-connector-v1-0.0.3.zip
        $ cd google-cloudsearch-sharepoint-connector-v1-0.0.3

2. SharePoint On-Prem 커넥터 구성 지정

커넥터가 SharePoint On-Prem에 올바르게 액세스하고 관련 콘텐츠의 색인을 생성하게 하려면 먼저 구성 파일을 만들어야 합니다. 커넥터의 구성 파일에 매개변수를 정의하여 SharePoint On-Prem 커넥터의 동작 및 속성을 제어하세요. 다음을 제어하는 매개변수를 구성할 수 있습니다.

  • 데이터 소스에 대한 액세스
  • SharePoint On-Prem 서버에 대한 액세스
  • 사이트 모음으로 SharePoint On-Prem 서버에 대한 색인 생성

구성 파일을 만들려면 다음 안내를 따르세요.

  • 원하는 텍스트 편집기를 열고 구성 파일 이름을 지정합니다.
  • 다음 섹션의 설명에 따라 파일 콘텐츠에 키=값 쌍을 추가합니다.
  • 구성 파일을 저장하고 이름을 지정합니다. Google에서는 커넥터를 실행하는 데 추가 명령줄 매개변수가 필요하지 않도록 구성 파일 connector-config.properties의 이름을 지정할 것을 권장합니다.

3. Google Cloud Search 데이터 소스에 대한 액세스 구성

다음 표에서와 같이 모든 구성 파일은 Cloud Search 데이터 소스에 액세스하는 데 필요한 매개변수를 첫 번째로 지정해야 합니다. 일반적으로 Cloud Search에 대한 커넥터의 액세스를 구성하려면 데이터 소스 ID, ID 소스 ID, 서비스 계정의 비공개 키 파일에 대한 경로가 필요합니다. 데이터 소스를 설정하는 데 필요한 단계는 검색할 데이터 소스 추가에 설명되어 있습니다.

설정 매개변수
데이터 소스 ID api.sourceId=1234567890abcdef

필수. 타사 데이터 소스 관리에 설명된 대로 G Suite 관리자가 설정한 Google Cloud Search 소스 ID입니다.

서비스 계정 비공개 키 파일의 경로 api.serviceAccountPrivateKeyFile=./PrivateKey.json

필수. Google Cloud Search SharePoint On-Prem 커넥터의 접근성을 위한 Google Cloud Search 서비스 계정 키 파일입니다.

ID 소스 ID api.identitySourceId=x0987654321

필수. G Suite 관리자가 설정한 Cloud Search ID 소스 ID입니다.

4. SharePoint On-Prem에 대한 액세스 구성

커넥터가 SharePoint On-Prem에 액세스하고 색인을 생성할 데이터를 추출하려면 먼저 SharePoint 서버에 대한 액세스를 구성해야 합니다. 다음 매개변수를 사용하여 구성 파일에 액세스 정보를 추가하세요.

설정 매개변수
SharePoint 서버의 정규화된 도메인 이름 sharepoint.server=http://yoursharepoint.example.com/

필수. 도메인 이름이 정규화되지 않았으면 커넥터 호스트에서 DNS 재정의를 설정해야 합니다.

SharePoint 사용자 이름 sharepoint.username=YOURDOMAIN\\ConnectorUser

필수. SharePoint Server AD 도메인에 속하지 않은 Linux 또는 Windows 시스템에서 커넥터를 실행할 때 필요합니다.

SharePoint 비밀번호 sharepoint.password=user_password

필수. SharePoint Server AD 도메인에 속하지 않은 Linux 또는 Windows 시스템에서 커넥터를 실행할 때 필요합니다.

실시간 인증을 사용하여 SharePoint에 연결 sharepoint.username=AdaptorUser Live Authentication Id

sharepoint.password uS3R_passWoRD

sharepoint.formsAuthenticationMode=LIVE

ADFS 인증을 사용하여 SharePoint에 연결 sharepoint.username=AdaptorUser@yourdomain.com

sharepoint.password=uS3R_passWoRD

sharepoint.sts.endpoint=https://adfs.example.com/adfs/services/trust/2005/usernamemixed

sharepoint.sts.realm=urn:myserver:sharepoint 또는 https://yoursharepoint.example.com/_trust

sharepoint.formsAuthenticationMode=ADFS

5. SharePoint를 신뢰할 수 있는 호스트로 추가

SharePoint가 HTTPS를 사용하도록 구성된 경우 다음 단계를 수행하여 SharePoint 인증서를 가져와서 커넥터의 신뢰할 수 있는 호스트로 추가합니다.

  • 브라우저에서 SharePoint로 이동합니다. '본 연결은 신뢰할 수 없음'과 같은 메시지가 표시된 경고 페이지가 나타납니다. 이 메시지가 나타나는 이유는 인증서가 자체 서명되었으며 공인된 인증 기관의 서명을 받지 않았기 때문입니다. 위험 사항 확인을 클릭하고 예외 추가를 클릭합니다.
  • 보기 버튼을 클릭할 수 있을 때까지 기다렸다가 클릭합니다.
  • '상세 정보' 탭으로 변경하고 '내보내기'를 클릭합니다.
  • 인증서를 커넥터의 디렉터리에 sharepoint.crt라는 이름으로 저장합니다.
  • 닫기취소를 클릭하여 창을 닫습니다.
  • 커넥터가 SharePoint를 신뢰하도록 허용하려면 명령 프롬프트를 열고 다음 명령어를 입력합니다.

    $ keytool -importcert -keystore cacerts.jks -storepass changeit -file sharepoint.crt -alias sharepoint

    '이 인증서를 신뢰하시겠습니까?'라는 메시지가 나타나면를 선택합니다.

6. 사이트 모음 구성

선택사항으로, 사이트 모음으로 SharePoint 서버에 대한 색인을 생성하도록 커넥터를 구성할 수 있습니다.

설정 매개변수
sharepoint.server가 가상 서버가 아니라 사이트 모음인지 여부 sharepoint.siteCollectionOnly=true

기본값은 auto-detected입니다. 값이 true이면 커넥터가 사이트 모음으로서의 sharepoint.server에 대하여 색인을 생성합니다.

7. 로깅 사용 설정

커넥터 바이너리를 포함하는 동일한 디렉터리에 이름이 logs인 폴더를 만듭니다. 같은 디렉터리에 logging.properties라는 ASCII 또는 UTF-8 파일을 만들고 다음 콘텐츠를 추가합니다.

handlers = java.util.logging.ConsoleHandler,java.util.logging.FileHandler
    # Default log level
    .level = INFO
    # uncomment line below to increase logging level for SharePoint APIsa
    #com.google.enterprise.cloudsearch.sharepoint.level=FINE

    # uncomment line below to increase logging level to enable API trace
    #com.google.api.client.http.level = FINE
    java.util.logging.ConsoleHandler.level = INFO
    java.util.logging.FileHandler.pattern=logs/connector-sharepoint.%g.log
    java.util.logging.FileHandler.limit=10485760
    java.util.logging.FileHandler.count=10
    java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter
    

고객은 Google Cloud Search를 사용하여 검색 결과에 ACL 트리밍을 적용할 수 있습니다. 이러한 ACL은 Google 주 구성원과 외부 주 구성원을 사용하여 정의할 수 있습니다.

일반적인 SharePoint On-Prem 설정에는 다음과 같은 3가지 주 구성원이 있습니다.

  • Active Directory 사용자
  • Active Directory 그룹
  • SharePoint 로컬 그룹(Active Directory 사용자 및 그룹을 구성원으로 포함)

SharePoint 콘텐츠에 적절한 보안 트리밍을 적용하려면 다음과 같은 외부 ID를 Google과 동기화해야 합니다.

  • Google Cloud 디렉터리 동기화 도구(ID 매핑된 그룹에 대한 지원이 추가됨)를 사용하여 Active Directory 사용자 및 그룹을 동기화합니다.
  • SharePoint 로컬 그룹을 동기화하는 데 SharePoint ID 커넥터를 사용합니다.

이러한 설정을 지원하려면 2개의 ID 소스를 만들어야 합니다.

  • Active Directory 사용자 및 그룹을 동기화하기 위한 ID 소스
  • SharePoint 로컬 그룹의 ID 소스
설정 매개변수
ID 소스 ID api.identitySourceId=1234567890abcdef

SharePoint 로컬 그룹을 동기화하기 위한 ID 소스 ID. 필수. 검색할 데이터 소스 추가에 설명된 대로 G Suite 관리자가 설정한 Google Cloud Search 소스 ID입니다.

참조 ID 소스 api.referenceIdentitySources=CONTOSO,contoso

Active Directory 주 구성원의 참조 ID 소스 목록. 값은 참조되는 Active Directory 주 구성원의 Active Directory NETBIOS 이름과 일치해야 합니다.

참조 ID 소스 ID api.referenceIdentitySource.CONTOSO.id=112233abcd

필수. 도메인 CONTOSO의 Active Directory 주 구성원을 동기화하기 위한 ID 소스 ID입니다.

9. Active Directory 조회 구성

다른 커넥터는 Google Cloud 디렉터리 동기화를 사용하여 Active Directory 사용자 및 그룹을 동기화하지만, SharePoint 커넥터는 동기화되는 주 구성원에 대한 추가 정보를 가져오기 위해 AD 조회를 수행해야 합니다. 사용 사례는 다음과 같습니다.

  • 도메인 그룹의 SID를 해당 sAMAccountName에 매핑합니다.
  • 사용자 sAMAccountName을 SharePoint 로컬 그룹 구성원의 이메일 주소에 매핑합니다.
설정 매개변수
Active Directory 호스트 adLookup.host=dc.contoso.com

필수. Active Directory 호스트 이름 또는 IP 주소.

Active Directory 조회 포트 adLookup.port=389

선택사항. 기본값은 389입니다. ssl에는 686을 사용하세요.

Active Directory 조회 메소드 adLookup.method=standard

선택사항. 기본값은 standard입니다. 보안 연결에는 'ssl'을 사용하세요.

Active Directory 조회 사용자 adLookup.username=CONTOSO\user1

필수. Active Directory 조회를 수행할 권한이 있는 사용자입니다.

Active Directory 조회 비밀번호 adLookup.passowrd=password123

필수. adLookup.user로 지정된 사용자의 비밀번호입니다.

10. SharePoint 목록 항목의 구조화된 데이터 지원 및 HTML 콘텐츠 생성 구성

SharePoint 목록 항목의 추가 메타데이터 색인을 생성하려면 HTML 콘텐츠 생성 또는 구조화된 데이터를 지원하도록 커넥터를 구성합니다.

HTML 콘텐츠 생성

다음 표의 매개변수를 사용하여 HTML 콘텐츠 생성을 구성합니다. 선택적 HTML 콘텐츠 생성 매개변수에 대한 자세한 내용은 HTML 콘텐츠 생성을 참조하세요.

설정 매개변수
HTML 템플릿 제목 필드 contentTemplate.sharePointItem.title=Title

생성된 HTML의 '제목'으로 사용될 SharePoint 필드입니다.

HTML 콘텐츠 높은 검색 품질 필드 contentTemplate.sharePointItem.quality.high=highField1,highField2…

생성된 HTML에 고품질 필드로 포함할 필드입니다. 이 필드의 검색어와 일치하면 순위가 높아집니다.

HTML 콘텐츠 중간 검색 품질 필드 contentTemplate.sharePointItem.quality.medium=mediumField1, mediumField2…

생성된 HTML에 중간 품질 필드로 포함할 필드입니다.

HTML 콘텐츠 낮은 검색 품질 필드 contentTemplate.sharePointItem.quality.low=lowField1, lowField2…

생성된 HTML에 낮은 품질 필드로 포함할 필드입니다.

HTML 콘텐츠 매핑되지 않은 열 contentTemplate.sharepointItem.unmappedColumnsMode=APPEND

기본값은 APPEND입니다. 생성된 HTML 콘텐츠에 매핑되지 않은 필드(고, 중, 저 구성에 속하지 않음)를 포함하려면 APPEND로 설정합니다. 매핑된 열만 사용하여 HTML을 생성하려면 IGNORE로 설정합니다.

구조화된 데이터 지원

데이터 소스의 스키마가 다음 지침에 따라 정의되어 있으면 커넥터가 SharePoint 목록 항목의 구조화된 데이터를 채웁니다.

  • 커넥터는 CloudSearch API에 정의된 사양에 따라 SharePoint 콘텐츠 유형 이름을 정규화하여 해당 객체 정의에 매핑합니다. Cloud Search API는 A~Z, a~z, 0~9만 객체 정의에 유효한 문자로 지원합니다. 커넥터는 지원되지 않는 문자를 제외하여 콘텐츠 유형 이름을 정규화합니다. 예를 들어 콘텐츠 유형 'Announcements'는 객체 정의 'Announcements'에 매핑되지만 콘텐츠 유형 'News Article'은 'NewsArticle'에 매핑됩니다.

  • 또한 커넥터는 itemMetadata.objectType 구성을 통해 대체 객체 유형의 구성을 지원합니다. 스키마에 SharePoint 콘텐츠 유형에 해당하는 객체 정의가 없으면 커넥터는 대체 객체 유형을 사용합니다.

  • 커넥터는 SharePoint 열의 표시 이름을 정규화하여 SharePoint 속성 이름을 속성 정의에 매핑합니다.

예: 구성 파일

다음 예시 구성 파일은 예시 커넥터의 동작을 정의하는 매개변수 키=값 쌍을 보여줍니다.

api.sourceId=08ef8becd116faa4546b8ca2c84b2879
    api.serviceAccountPrivateKeyFile=service_account.json
    api.identitySourceId=08ef8becd116faa475de26d9b291fed9

    # Optional
    contentTemplate.sharepointItem.title=Title
    contentTemplate.sharepointItem.unmappedColumnsMode=APPEND

    sharepoint.server=http://sp-2016:32967/sites/doc-center-site-collection
    sharepoint.siteCollectionOnly=true
    sharepoint.username=contoso\\admin
    sharepoint.password=pa$sw0rd
    sharepoint.stripDomainInUserPrincipals=true

    adLookup.host=dc.contoso.com
    adLookup.port=389
    adLookup.username=contoso\\admin
    adLookup.password=pa$sw0rd

    api.referenceIdentitySources=CONTOSO,contoso
    api.referenceIdentitySource.contoso.id=08ef8becd116faa5d3783f8c5a80e5aa
    api.referenceIdentitySource.CONTOSO.id=08ef8becd116faa5d3783f8c5a80e5aa
    

SharePoint On-Prem ID 커넥터 실행

액세스 권한이 있는 SharePoint 콘텐츠에서 Cloud Search 결과를 얻으려면 온프렘 Active Directory와 SharePoint 사이트 모음의 주 구성원을 Google Cloud ID 서비스의 ID에 매핑해야 합니다. 이러한 동기화는 Google Cloud 디렉터리 동기화(GCDS) 애플리케이션과 SharePoint On-Prem ID 커넥터를 통해 이루어집니다. GCDS를 사용하기 위한 단계는 Google 디렉터리 동기화 정보를 참조하세요. ID 매핑된 그룹을 사용 설정하는 방법에 대한 자세한 내용은 그룹을 Cloud Search ID 소스와 동기화를 참조하세요.

GCDS가 Active Directory의 사용자와 그룹을 동기화한 후에 아래 설명과 같이 SharePoint On-Prem ID 커넥터를 실행하여 SharePoint 사이트 모음 그룹을 동기화합니다.

ID 커넥터는 콘텐츠 색인 생성에 사용되는 것과 유사한 구성 파일을 사용합니다. 다음은 샘플 ID 커넥터 구성 파일입니다.

api.customerId=C05d3djk8
    api.serviceAccountPrivateKeyFile=service_account.json
    api.identitySourceId=08ef8becd116faa475de26d9b291fed9

    sharepoint.server=http://sp-2016:32967/sites/doc-center-site-collection
    sharepoint.siteCollectionOnly=true
    sharepoint.username=contoso\\admin
    sharepoint.password=pa$sw0rd
    sharepoint.stripDomainInUserPrincipals=true

    adLookup.host=dc.contoso.com
    adLookup.port=389
    adLookup.username=contoso\\admin
    adLookup.password=pa$sw0rd

    api.referenceIdentitySources=CONTOSO,contoso
    api.referenceIdentitySource.contoso.id=08ef8becd116faa5d3783f8c5a80e5aa
    api.referenceIdentitySource.CONTOSO.id=08ef8becd116faa5d3783f8c5a80e5aa
    

이 파일에는 api.customerId 속성이 포함되어 있습니다. 이 속성에는 G Suite 계정 ID가 포함됩니다. customerID를 생성하는 방법에 대한 자세한 내용은 Cloud Search에서 사용자 ID 매핑을 참조하세요.

콘텐츠의 색인을 생성하는 데 사용되는 것과 동일한 JAR 파일에는 ID 커넥터도 포함되어 있습니다. 이를 실행하려면 구성 파일이 있는 디렉터리에서 다음 명령어를 실행하세요. version 대신 GitHub 출시 페이지에서 찾을 수 있는 현재 버전 번호를 사용하세요.

java -Djava.util.logging.config.file=logging.properties -cp "google-cloudsearch-sharepoint-connector-version.jar" com.google.enterprise.cloudsearch.sharepoint.SharePointIdentityConnector

SharePoint On-Prem 커넥터 실행

호스트 머신에서 cmd.exe를 사용하여 커넥터를 실행합니다.

$ java -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-sharepoint-connector-v1-0.0.3.jar

HTTPs 보안 SharePoint 사이트에 대해 커넥터를 실행하려면 위에서 설명한 대로 SharePoint를 신뢰할 수 있는 호스트로 추가합니다.

$ java -Djavax.net.ssl.trustStore=cacerts.jks -Djavax.net.ssl.trustStoreType=jks -Djavax.net.ssl.trustStorePassword=changeit -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-sharepoint-connector-v1-0.0.3.jar

심화 주제

이 섹션의 정보는 기본 SharePoint 커넥터 구성을 넘어 주제를 확장합니다.

멀티 테넌트 구성

멀티 테넌트 SharePoint 배포는 일반적으로 동일한 웹 애플리케이션 아래에 여러 고객 사이트를 호스팅합니다. 고객은 해당 사이트 모음에 대해서만 사용 권한을 받습니다. 이러한 시나리오에서는 SharePoint On-Prem 커넥터에서 요구하는 대로 SharePoint 웹 애플리케이션에 대한 전체 읽기 권한을 얻을 수 없습니다.

이러한 멀티 테넌트 구성은 사이트 모음 전용 모드를 통해 지원됩니다. 멀티 테넌트 구성을 지원하려면 connector-config.properties 파일에서 sharepoint.siteCollectionOnly 구성 옵션을 사용하여 사이트 모음 모드를 사용 설정해야 합니다.

사이트 모음 전용 모드에서 루트 수준의 사이트 모음에 대한 색인을 생성하려면 sharepoint.siteCollectionOnly를 명시적으로 true로 설정해야 합니다.

커넥터는 사이트 모음과 하위 항목의 색인을 생성합니다. 이러한 이유로 SharePoint의 커넥터 사용자 계정에는 사이트 모음 관리자 권한이 필요합니다.

멀티 테넌트 환경에 색인을 생성할 사이트 모음이 여러 개 있으면 각 사이트 모음에 대하여 하나의 커넥터 인스턴스를 구성해야 합니다.

사이트 모음 전용 모드에서 SharePoint On-Prem 커넥터를 구성하려면 다음 안내를 따르세요.

  • sharepoint.server를 사이트 모음 URL(예: http://sharepoint.example.com/sites/sitecollection)로 지정합니다.

  • 사이트 모음 URL이 루트 사이트 모음(예: http://sharepoint.example.com)이면 명시적으로 sharepoint.siteCollectionOnly=true를 설정합니다.

사이트 모음 전용 모드의 비표준 URL

SharePoint On-Prem 커넥터는 사이트 모음 전용 모드에서 비표준 URL을 허용합니다. 즉 connector-config.properties 파일의 sharepoint.server 구성 옵션으로 지정된 커넥터 URL이 SharePoint에서와 완전히 동일한 경우일 필요가 없습니다.

Microsoft Outlook .msg 파일의 Content-Type 재정의

콘텐츠를 크롤링할 때 커넥터가 Outlook .msg파일을 발견하면 파일의 Content-Type을 재정의하여 application/vnd.ms-outlook으로 색인을 생성합니다.