Google Workspace 콘텐츠 외에도 조직의 SharePoint 온프레임 콘텐츠에서 결과를 반환하도록 Google Cloud Search를 설정할 수 있습니다. Google Cloud Search SharePoint On-Prem 커넥터를 사용하고 특정 SharePoint 데이터 소스에 액세스하도록 구성합니다.
중요 고려사항
적용되는 SharePoint 설정
Cloud Search SharePoint On-Prem 커넥터는 항상 SharePoint의 검색 공개 상태 설정을 따르며 이 설정은 재정의할 수 없습니다. 임시 문서의 경우 커넥터가 SharePoint Online에 액세스하는 데 사용하는 사용자 계정의 권한에 따라 색인이 생성되고 반환되는 임시 문서가 결정됩니다. 계정에 '전체 읽기' 권한만 있는 경우 커넥터는 SharePoint의 '임시 항목 공개 상태' 설정을 따릅니다.
사용자 계정 액세스를 기반으로 결과를 제한하도록 커넥터를 구성할 수도 있습니다. Google 주 구성원과 외부 주 구성원을 사용하여 ACL을 정의할 수 있습니다. SharePoint 콘텐츠에 보안 트리밍을 적용하려면 다음 외부 ID를 Google 디렉터리와 동기화합니다.
- Active Directory 사용자
- Active Directory 그룹
- SharePoint 로컬 그룹(Active Directory 사용자 및 그룹을 구성원으로 포함)
AD 사용자 및 그룹을 동기화하려면 Google Cloud 디렉터리 동기화를 사용하여 ID 매핑된 그룹을 사용 설정합니다. SharePoint 로컬 그룹을 동기화하려면 SharePoint ID 커넥터를 사용합니다.
또한 커넥터는 주 구성원을 동기화하기 위한 추가 정보를 가져오기 위해 AD 조회를 실행해야 합니다. 예를 들어 AD를 사용하여 조회하면 커넥터에서 다음을 실행할 수 있습니다.
- 도메인 그룹의 SID를 해당 sAMAccountName에 매핑합니다.
- 사용자 sAMAccountName을 SharePoint 로컬 그룹 구성원의 이메일 주소에 매핑합니다.
검색 최적화
더 관련성 높은 검색 결과를 반환하도록 커넥터를 구성하여 사용자 환경을 개선할 수 있습니다.
API를 사용하려면 SharePoint Online 커넥터 구성 파일에서 HTML 생성 매개변수의 값을 설정합니다. 이 매개변수를 사용하면 일치에 더 큰 영향을 미치는 필드와 더 작은 영향을 미치는 필드를 설정할 수 있습니다.
스키마를 설정하려면 스키마 만들기 및 등록하기의 안내를 따르세요. 스키마를 설정할 때 다음 사항에 유의하세요.
SharePoint 콘텐츠 유형의 이름을 해당 객체 정의에 매핑하기 위해 커넥터는 지원되지 않는 문자를 제외하여 콘텐츠 유형 이름을 정규화합니다. 객체 정의의 경우 Cloud Search API는 A~Z, a~z, 0~9만 유효한 문자로 지원합니다. 예를 들어 콘텐츠 유형 'Announcements'는 객체 정의 'Announcements'에 매핑됩니다. 콘텐츠 유형 'News Article'은 'NewsArticle' (공백 없음)에 매핑됩니다.
커넥터가 객체 정의를 객체 정의와 일치시킬 수 없는 경우 대체 객체 유형 (
itemMetadata.objectType)을 사용합니다. 메타데이터 구성 매개변수에 대해 자세히 알아보세요.SharePoint 속성 이름을 속성 정의에 매핑하기 위해 커넥터는 16진수로 인코딩된 문자를 디코딩하고 'ows_' 접두사를 삭제한 다음 지원되지 않는 문자 (A~Z, a~z, 0~9를 제외한 모든 문자)를 제외하여 속성 이름을 정규화합니다.
Microsoft Outlook 메시지 처리
커넥터가 콘텐츠를 색인 생성할 때 Microsoft Outlook .msg 파일을 발견하면 파일의 미디어 유형을 재정의하고 application/vnd.ms-outlook.로 색인을 생성합니다.
멀티 테넌트 구성
SharePoint가 여러 고객 사이트가 동일한 웹 애플리케이션에 호스팅되는 멀티 테넌트 배포인 경우 구성 파일에서 사이트 모음 모드를 구성해야 합니다. 멀티 테넌트 배포에서는 사이트 모음에 대한 권한만 부여받으며 SharePoint 온프레미스 커넥터에서 요구하는 전체 읽기 권한을 얻을 수 없습니다.
사이트 모음 모드를 사용 설정하려면 다음 단계를 따르세요.
- 커넥터 사용자 계정에 사이트 모음 관리자 권한을 부여합니다.
- 커넥터 구성 파일에서
sharepoint.server를 사이트 모음 URL(예:http://sharepoint.example.com/sites/sitecollection)로 설정합니다. URL은 SharePoint에서와 완전히 동일한 경우일 필요가 없습니다. - 커넥터 구성 파일에서
sharepoint.siteCollectionOnly를true로 설정합니다.
멀티 테넌트 환경에 색인을 생성할 사이트 모음이 여러 개 있으면 각 사이트 모음에 대하여 하나의 커넥터 인스턴스를 구성해야 합니다.
커넥터 제한사항
- 커넥터가 데이터베이스의 항목 변경사항을 감지하는 데 걸리는 시간은 커넥터가 모니터링하는 데이터베이스 수에 따라 증가합니다.
- 메모리 소비량은 각 사이트 모음의 ACL에 사용하는 순 사용자 및 그룹의 수에 따라 증가합니다.
- 단일 Active Directory 도메인의 ID로만 커넥터를 구성할 수 있습니다.
Everyone,BUILTIN\Users,All Authenticated Users와 같은 일부 일반적인 Active Directory 및 Windows 주 구성원은 지원되지 않습니다.- 삭제 알림은 즉시 전송되지 않으며 커넥터가 사용자가 소스 저장소에서 콘텐츠를 삭제했음을 인식하는 데 4시간 넘게 걸릴 수 있습니다.
시스템 요구사항
| 시스템 요구사항 | |
|---|---|
| 운영체제 |
|
| 소프트웨어 |
|
| 인증 |
|
커넥터 배포
기본 요건
서비스 계정 ID가 포함된 Google Workspace 비공개 키를 만듭니다. 비공개 키를 가져오는 방법을 알아보려면 Google Cloud Search API에 대한 액세스 구성으로 이동하세요.
Google Workspace 관리자가 검색할 데이터 소스를 추가해야 합니다. 데이터 소스 ID를 기록합니다.
커넥터가 ACL을 기반으로 결과를 반환하는 경우 (결과가 공개되지 않음) Google Workspace 관리자가 두 개의 ID 소스를 만들고 ID를 제공해야 합니다.
- Active Directory 사용자 및 그룹을 동기화하기 위한 ID 소스
- SharePoint 로컬 그룹의 ID 소스
또한 관리자가 조직의 Google Workspace 고객 ID를 가져와 사용자에게 제공해야 합니다.
Cloud Search에서 사용자 ID 매핑에서 이러한 값을 가져오는 방법을 알아보세요.
사용자 정책에서 SharePoint 웹 애플리케이션에 대한 전체 읽기 권한이 있는 커넥터의 사용자 계정을 설정합니다.
SharePoint 웹 애플리케이션에 루트 사이트 모음이 없는 경우 만듭니다.
사이트 모음이 쓰기 잠겨 있으면 관리자 권한이 있는 계정으로 SharePoint Server에 로그인하고
PrepareWriteLockedSites.ps1스크립트를 실행합니다.커넥터 구성에 제공할 데이터 소스 측정항목을 가져오려면 팜 관리 권한이 있는 계정으로 SharePoint 서버에 로그인하고
diagnose_sp.ps1를 실행합니다.출력에는 웹 애플리케이션, 문서, 사용자 그룹 멤버십의 수가 보고됩니다. 이 정보를 사용하여 필요한 커넥터 인스턴스 개수, 메모리 요구사항, 문서 개수를 추정합니다.
1단계: Google Cloud Search SharePoint On-Prem 커넥터 소프트웨어 설치
GitHub의 커넥터 저장소를 클론합니다.
$ git clone https://github.com/google-cloudsearch/sharepoint-connector.git $ cd sharepoint-connector
원하는 버전의 커넥터를 체크아웃합니다.
$ git checkout tags/latest_version여기서
latest_version=v1-0.0.5와 같은 값커넥터를 빌드합니다.
$ mvn package커넥터를 빌드할 때 테스트를 건너뛰려면
mvn package대신mvn package -DskipTests를 실행합니다.커넥터 zip 파일을 로컬 설치 디렉터리에 복사합니다.
$ cp target/google-cloudsearch-sharepoint-connector-latest_version.zip installation-dir $ cd installation-dir $ unzip google-cloudsearch-sharepoint-connector-latest_version.zip $ cd google-cloudsearch-sharepoint-connector-latest_version
2단계: SharePoint On-Prem 커넥터 구성 파일 만들기
커넥터 설치와 동일한 디렉터리에 파일을 만듭니다. 커넥터를 실행하는 데 추가 명령줄 매개변수가 필요하지 않도록 파일 이름을
connector-config.properties로 지정하는 것이 좋습니다. 커넥터 인스턴스를 여러 개 실행할 계획이라면 이름에 세부정보를 추가하여 구분합니다.다음 예와 같이 파일 콘텐츠에 매개변수를 키-값 쌍으로 추가합니다.
### Sharepoint On-Prem Connector configuration ### # Required parameters for data source access api.sourceId=08ef8becd116faa4546b8ca2c84b2879 api.serviceAccountPrivateKeyFile=service_account.json api.identitySourceId=08ef8becd116faa475de26d9b291fed9 # Required parameters for SharePoint on-premises access 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 # Required parameters for AD lookup adLookup.host=dc.contoso.com adLookup.username=contoso\\admin adLookup.password=pa$sw0rd api.referenceIdentitySources=CONTOSO,contoso api.referenceIdentitySource.contoso.id=08ef8becd116faa5d3783f8c5a80e5aa api.referenceIdentitySource.CONTOSO.id=08ef8becd116faa5d3783f8c5a80e5aa # Optional parameters for schema mapping contentTemplate.sharepointItem.title=Title contentTemplate.sharepointItem.unmappedColumnsMode=APPEND각 매개변수에 대한 자세한 설명은 구성 매개변수 참조를 참고하세요.
(선택사항) 필요에 따라 추가 커넥터 매개변수를 구성합니다. 자세한 내용은 Google 제공 커넥터 매개변수를 참고하세요.
3단계: HTTPS의 경우 SharePoint를 신뢰할 수 있는 호스트로 추가
SharePoint가 HTTPS를 사용하도록 구성된 경우 SharePoint 인증서를 가져와서 커넥터의 신뢰할 수 있는 호스트로 추가합니다.
커넥터를 실행할 컴퓨터에서 브라우저를 열고 SharePoint로 이동합니다.
경고 페이지가 열리면 위험 사항 확인 및 예외 추가를 클릭합니다. 인증서가 자체 서명되었으며 공인된 인증 기관의 서명을 받지 않았기 때문에 '본 연결은 신뢰할 수 없음'과 같은 메시지가 페이지에 표시됩니다.
보기 버튼을 클릭할 수 있게 되면 클릭합니다.
세부정보 탭으로 이동하여 내보내기를 클릭합니다.
인증서를 커넥터 디렉터리에
sharepoint.crt라는 이름으로 저장합니다.닫기와 취소를 차례로 클릭하여 창을 닫습니다.
명령 프롬프트를 열고 다음 명령어를 입력합니다.
$ keytool -importcert -keystore cacerts.jks -storepass changeit -file sharepoint.crt -alias sharepoint"이 인증서를 신뢰하시겠습니까?"라는 메시지가 나타나면 예를 선택합니다.
4단계: 로깅 설정
커넥터 바이너리가 포함된 디렉터리에
logs라는 폴더를 만듭니다.logs이 아닌 동일한 디렉터리에서logging.properties이라는 Latin1 인코딩 파일을 만듭니다.logging.properties에 다음 텍스트를 추가합니다.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
5단계: SharePoint On-Prem ID 커넥터 구성
이 단계는 SharePoint 온프레미스 ID 기반 ACL을 검색 결과에 적용하는 데 필요합니다. 공개 ACL로 커넥터를 설정한 경우 이 단계를 건너뛰어도 됩니다.
SharePoint Online 커넥터 설치와 동일한 디렉터리에서 파일을 만들고 이름을
sharepoint-onprem-identity-connector.config로 지정합니다.다음 예와 같이 파일 콘텐츠에 매개변수를 키-값 쌍으로 추가합니다.
### SharePoint On-prem identity connector configuration ### # Required parameters for data source access api.customerId=C05d3djk8 api.serviceAccountPrivateKeyFile=service_account.json api.identitySourceId=08ef8becd116faa475de26d9b291fed9 # Required parameters for SharePoint access 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 # Required parameters for AD lookup adLookup.host=dc.contoso.com adLookup.username=contoso\\admin adLookup.password=pa$sw0rd api.referenceIdentitySources=CONTOSO,contoso api.referenceIdentitySource.contoso.id=08ef8becd116faa5d3783f8c5a80e5aa api.referenceIdentitySource.CONTOSO.id=08ef8becd116faa5d3783f8c5a80e5aa값은 SharePoint 온프레미스 커넥터와 거의 동일하지만, 매개변수가
api.sourceId대신api.customerId입니다.api.customerId의 값은 Google Workspace 관리자로부터 받은 고객 ID입니다.
6단계: SharePoint On-Prem 커넥터 실행
다음 단계에서는 온프레미스 Active Directory와 SharePoint 사이트 모음의 주 구성원을 Cloud ID 서비스의 ID에 매핑합니다. 이 동기화는 Google Cloud 디렉터리 동기화 (GCDS) 및 SharePoint On-Prem ID 커넥터를 통해 이루어집니다.
GCDS가 사용자와 그룹을 동기화한 후 SharePoint 사이트 모음 그룹을 동기화하려면 SharePoint On-Prem ID 커넥터를 실행합니다. 마지막으로 SharePoing On-Prem 커넥터를 실행하여 색인을 생성하고 Cloud Search 사용자에게 결과를 제공합니다.
아직 GCDS를 구성하지 않았다면 GCDS를 구성하고 실행합니다. ID 매핑 그룹을 사용 설정해야 합니다.
SharePoint On-Prem ID 커넥터를 실행합니다.
$ java -Djava.util.logging.config.file=logging.properties -cp "google-cloudsearch-sharepoint-connector-version.jar" com.google.enterprise.cloudsearch.sharepoint.SharePointIdentityConnector -Dconfig=sharepoint-onprem-identity-connector.configSharePoint On-Prem 커넥터를 실행합니다. SharePoint 사이트 보안에 다음 명령어 문법을 사용합니다.
HTTP (신뢰할 수 있는 호스트 필요 없음):
$ java -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-sharepoint-connector-v1-version.jarHTTPS (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-version.jar
구성 매개변수 참조 정보
데이터 소스 액세스
| 설정 | 매개변수 |
| 데이터 소스 ID | api.sourceId=1234567890abcdef
필수 항목입니다. Google Workspace 관리자가 설정한 Google Cloud Search 데이터 소스 ID입니다. |
| 서비스 계정 비공개 키 파일의 경로 | api.serviceAccountPrivateKeyFile=PrivateKey.json
필수 항목입니다. Google Cloud Search 서비스 계정 키 파일의 경로입니다. |
SharePoint 온프레미스 액세스
| 설정 | 매개변수 |
| SharePoint 서버 URL | sharepoint.server=http://yoursharepoint.example.com/
필수 항목입니다. SharePoint 서버의 URL(예: 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
|
| ADFS 인증을 사용하여 SharePoint에 연결 | sharepoint.username=AdaptorUser@yourdomain.com
|
사이트 모음 색인 생성
| 설정 | 매개변수 |
| 색인 유형 | sharepoint.siteCollectionOnly=boolean
다중 테넌트 SharePoint 배포를 제외하고 선택사항입니다 (자세히 알아보기). 커넥터가 |
SharePoint ID 매핑
| 설정 | 매개변수 |
| ID 소스 ID | api.identitySourceId=1234567890abcdef
필수 항목입니다. SharePoint 로컬 그룹을 동기화하기 위한 ID 소스 ID입니다.검색할 데이터 소스 추가에 설명된 대로 Google Workspace 관리자가 설정한 Google Cloud Search 소스 ID입니다. |
| 참조 ID 소스 | api.referenceIdentitySources=CONTOSO,contoso
Active Directory 주 구성원의 참조 ID 소스를 쉼표로 구분하여 나열한 목록입니다. 값은 참조 Active Directory 주 구성원의 Active Directory NETBIOS 이름과 일치합니다. |
| 참조 ID 소스 ID | api.referenceIdentitySource.DOMAIN.id=identity-source-id
필수 항목입니다. Active Directory 주 구성원을 동기화하기 위한 ID 소스 ID입니다. |
Active Directory 조회
| 설정 | 매개변수 |
| Active Directory 호스트 | adLookup.host=host
필수 항목입니다. Active Directory 호스트 이름(예: dc.contoso.com) 또는 IP 주소 |
| Active Directory 조회 포트 | adLookup.port=port
선택사항. 기본값은 389입니다. SSL에는 686을 사용하세요. |
| Active Directory 조회 메소드 | adLookup.method=value
선택사항입니다. 기본값은 `standard`입니다. HTTPS 연결의 경우 `ssl`로 설정합니다. |
| Active Directory 조회 사용자 | adLookup.username=CONTOSO\user1
필수. Active Directory 조회를 수행할 권한이 있는 사용자입니다. |
| Active Directory 조회 비밀번호 | adLookup.password=password123
필수 항목입니다. |
HTML 콘텐츠 생성
| 설정 | 매개변수 |
| HTML 템플릿 제목 필드 | contentTemplate.sharePointItem.title=Title
생성된 HTML의 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 (기본값) 또는 IGNORE입니다.
|