Microsoft SharePoint On Prem
온프레미스 Microsoft SharePoint 데이터 원본에 저장된 문서를 크롤링합니다.
IBM Cloud Pak for Data IBM Software Hub
이 정보는 설치된 배포에만 적용됩니다. 관리형 배포에서 온-프레미스 SharePoint 사이트에 연결하는 방법에 대한 자세한 내용은 SharePoint On Prem 를 참조하세요.
크롤링되는 문서
- Discovery 가 지원하는 문서만 크롤링되고, 그 외의 모든 문서는 무시됩니다. 자세한 내용은 지원되는 파일 형식 를 참조하세요.
- 문서 수준 보안이 지원됩니다. 이 옵션을 사용하도록 설정하면 사용자가 SharePoint에 로그인했을 때 액세스할 수 있는 것과 동일한 콘텐츠를 크롤링하고 쿼리할 수 있습니다. 자세한 내용은 문서 수준 보안 지원 를 참조하세요.
- 소스가 다시 크롤링되면, 새로운 문서가 추가되고, 업데이트된 문서는 현재 버전으로 수정되며, 삭제된 문서는 컬렉션의 색인에서 삭제됩니다.
- 모든 Discovery 데이터 원본 커넥터는 읽기 전용입니다. 크롤링 계정에 부여된 권한에 관계없이 Discovery는 원본 데이터 원본의 콘텐츠를 쓰거나 업데이트하거나 삭제하지 않습니다.
데이터 소스 요구사항
설치된 모든 배포에 대한 데이터 소스 요구 사항 외에도 SharePoint On Prem 데이터 원본은 다음 요구 사항을 충족해야 합니다:
- 데이터 소스 연결은 SharePoint 2013, 2016 또는 2019를 지원합니다.
- 연결하려는 데이터 소스에 필요한 모든 서비스 라이선스를 취득해야 합니다. 라이선스에 대한 자세한 내용은 데이터 원본의 시스템 관리자에게 문의하세요.
SharePoint On Prem에 대한 자세한 내용은 Microsoft SharePoint 개발자 설명서를 참조하세요.
전제조건 단계
SharePoint On Prem 컬렉션을 만들기 전에 다음 작업을 수행해야 합니다:
-
SharePoint 관리자와 협력하여 웹 애플리케이션에 대한 전체 읽기 액세스 설정을 조정하세요.
자세한 내용은 셰어포인트 서버에서 웹 응용 프로그램에 대한 사용 권한 관리를 참조하세요.
-
문서 수준 보안을 사용하려면 몇 가지 단계를 거쳐 설정해야 합니다. 자세한 내용은 문서 수준 보안 지원 를 참조하세요.
LDAP 관리자로부터 다음 정보를 수집해야 합니다:
- LDAP 서버 URL
- LDAP 서버 URL 에 연결하려면, 예를 들어
ldap://<ldap_server>:<port>와 같이 입력합니다. - LDAP 바인딩 사용자 이름
- 디렉토리 서비스에 바인딩하는 데 사용되는 사용자 이름입니다. 대부분의 경우 이 사용자 이름은 식별 이름(DN)입니다. 로그온 이름이 때때로 Active Directory에서 작동할 수 있습니다. 그러나 일반적인 윈도우 로그온과 달리 대소문자를 구분합니다. 고유 이름은 항상 작동합니다.
- LDAP 바인딩 사용자 비밀번호
- 디렉토리 서비스에 바인딩하는 데 사용되는 비밀번호입니다.
- LDAP 기본 DN
- LDAP에서 사용자 항목을 검색하는 시작점, 예를 들어
CN=Users,DC=example,DC=com. - LDAP 사용자 필터
- LDAP에서 사용자 항목을 검색하는 사용자 필터. 지정하지 않을 경우 기본값은
(userPrincipalName={0})입니다.
2.2.1 이하 버전을 사용하는 경우 데이터 원본에 연결하기 전에 몇 가지 추가 필수 작업을 완료해야 합니다. 자세한 내용은 SharePoint 이전 릴리스의 Prem 사전 필수 단계 를 참조하세요.
SharePoint On Prem 데이터 원본에 연결하기
Discovery 프로젝트에서 다음 단계를 완료하십시오
-
탐색 창에서 컬렉션 관리를 선택합니다.
-
새 컬렉션을 클릭합니다.
-
SharePoint 를 클릭한 다음, Next를 클릭합니다.
-
컬렉션의 이름을 지정합니다.
-
SharePoint에 있는 문서의 언어가 영어가 아닌 경우 적절한 언어를 선택합니다.
지원되는 언어 목록은 언어 지원을 참조하십시오.
-
선택: 동기화 일정을 변경합니다.
자세한 내용은 크롤링 일정 옵션 를 참조하세요.
-
인증정보 입력하기 섹션에서 다음 필드를 입력합니다:
- 사용자 이름
- SharePoint 의 사용자 이름으로, 크롤링과 색인 작업이 필요한 모든 사이트와 목록에 액세스할 수 있습니다.
- 비밀번호
- SharePoint 의 사용자 비밀번호입니다.
이 값은 절대 반환되지 않으며, 자격 증명을 생성하거나 수정할 때만 사용됩니다.
-
선택 사항: SAML(보안 어설션 마크업 언어) 클레임 기반 인증을 사용하려면 SAML 인증 사용 스위치를
On으로 설정합니다. 그렇지 않으면 NTLM(Windows NT LAN 관리자) 인증이 사용됩니다. 다음 필드에 값을 추가합니다:- ID 공급자 엔드포인트
- ID 공급자 엔드포인트의 인증서( URL )는, 예를 들어
https://adfs.server.example.com/adfs/services/trust/2005/UsernameMixed입니다. - 신뢰 당사자 엔드포인트
- 선택사항. 의존 당사자의 신뢰 엔드포인트( URL )입니다. 지정하지 않으면 다음 값이 사용됩니다:
https://<sharepoint_server>:<port>/_trust/. - 신뢰 당사자 신뢰 식별자
- 신뢰 당사자의 신뢰 식별자( URL )는 예를 들어
urn:sharepoint:sample와 같은 식별자입니다. 지정하지 않으면 다음 값이 사용됩니다:https://<sharepoint_server>:<port>/_trust/. 이 기능은 2013, 2016 및 2019 버전에서 사용할 수 있습니다.
-
크롤링하려는 항목 지정 섹션에서, SharePoint 웹 서비스 URL 를 웹 애플리케이션 URL 필드 에 추가합니다. 예:
https://<host>:<port>. -
선택 사항: 프록시 서버를 사용하여 데이터 소스 서버에 액세스하는 경우 프록시 설정 섹션에서 프록시 설정 사용 스위치를
On로 설정합니다. 다음 필드에 값을 추가합니다:- 사용자 이름
- 선택사항. 프록시 서버가 인증을 요구하는 경우, 인증할 프록시 서버 사용자 이름. 사용자 이름을 모르는 경우 프록시 서버 관리자로부터 얻을 수 있습니다.
- 비밀번호
- 선택사항. 프록시 서버가 인증을 요구하는 경우, 인증을 위한 프록시 서버 비밀번호. 비밀번호를 모르는 경우 프록시 서버 관리자로부터 얻을 수 있습니다.
- 프록시 서버 호스트 이름 또는 IP 주소
- 프록시 서버의 호스트 이름 또는 IP 주소.
- 프록시 서버 포트 번호
- 프록시 서버에 연결하고자 하는 네트워크 포트입니다.
-
선택: 문서 수준 보안을 활성화하려면 보안 섹션에서 문서 수준 보안 사용 스위치를
On로 설정합니다.이 옵션을 사용하도록 설정하면 사용자가 SharePoint에 로그인했을 때 액세스할 수 있는 것과 동일한 콘텐츠를 크롤링하고 쿼리할 수 있습니다. 지원을 추가하려면 필수 단계 를 완료하세요.
이 옵션을 활성화하는 경우 다음 필드에 값을 입력해야 합니다:
- LDAP 서버 URL
- LDAP 서버 URL 에 연결하려면, 예를 들어
ldap://<ldap_server>:<port>와 같이 입력합니다. - LDAP 바인딩 사용자 이름
- 디렉토리 서비스에 바인딩하는 데 사용되는 사용자 이름입니다. 대부분의 경우 이 사용자 이름은 식별 이름(DN)입니다. 로그온 이름이 때때로 Active Directory에서 작동할 수 있습니다. 그러나 일반적인 윈도우 로그온과 달리 대소문자를 구분합니다. 고유 이름은 항상 작동합니다.
- LDAP 바인딩 사용자 비밀번호
- 디렉토리 서비스에 바인딩하는 데 사용되는 비밀번호입니다.
- LDAP 기본 DN
- LDAP에서 사용자 항목을 검색하는 시작점, 예를 들어
CN=Users,DC=example,DC=com. - LDAP 사용자 필터
- LDAP에서 사용자 항목을 검색하는 사용자 필터. 지정하지 않을 경우 기본값은
(userPrincipalName={0})입니다.
-
크롤러가 사이트의 이미지에서 텍스트를 추출하도록 하려면 추가 처리 설정를 확장하고 광학 문자 인식(OCR) 를
On으로 설정합니다.OCR이 활성화되어 있고 문서에 이미지가 포함되어 있으면 처리 시간이 더 오래 걸립니다. 자세한 내용은 광학 문자 인식 를 참조하세요.
-
** 완료**를 누르십시오.
컬렉션이 빠르게 생성됩니다. 데이터가 컬렉션에 추가되면 처리하는 데 시간이 더 걸립니다.
진행 상황을 확인하려면 활동 페이지로 이동하세요. 탐색 창에서 컬렉션 관리를 클릭한 다음 클릭하여 컬렉션을 엽니다.
이전 릴리스를 위한 필수 단계
2.2.1 버전 이하를 사용하는 경우 데이터 원본에 연결하려면 먼저 이러한 추가 단계를 완료해야 합니다:
- Discovery 클러스터에서 웹 서비스 패키지를 가져옵니다. 이 웹 서비스 패키지는 크롤러가 크롤링을 위해 필요한 정보를 얻는 데 사용하는 사용자 정의 모듈입니다. 자세한 내용은 웹 서비스 패키지 받기 를 참조하세요.
- 웹 서비스 패키지를 SharePoint 서버에 배포합니다. 자세한 내용은 SharePoint 서버에 웹 서비스 배포 를 참조하세요.
웹 서비스 패키지 받기
Discovery 클러스터에서 웹 서비스 패키지를 가져오려면 다음 단계를 완료하세요:
-
Discovery 클러스터에 로그인하십시오.
-
crawler의 pod 이름을 얻으려면 다음 명령을 입력하십시오oc get pods | grep crawler다음 메시지와 유사한 출력물을 보게 될 수도 있습니다
wd-discovery-crawler-57985fc5cf-rxk89 1/1 Running 0 85m -
ESSPSolution.wsp파일을 얻으려면 다음 명령어를 입력하고,{crawler-pod-name}를 이전 단계에서 얻은crawler포드 이름으로 바꾸십시오oc exec {crawler-pod-name} -- ls -l /opt/ibm/wex/zing/resources/ | grep ESSPSolution다음 메시지와 유사한 출력물을 보게 될 수도 있습니다
-rw-r--r--. 1 dadmin dadmin 8600 Feb 3 08:23 ESSPSolution-${build-version}.wsp -
ESSPSolution.wsp파일을 호스트 서버에 복사하려면 다음 명령을 입력하십시오. 여기서{build-version}는 이전 단계의 빌드 버전 번호로,{crawler-pod-name}는crawlerpod 이름으로 대체하십시오oc cp {crawler-pod-name}:/opt/ibm/wex/zing/resources/ESSPSolution-${build-version}.wsp ESSPSolution.wsp
SharePoint 서버에 웹 서비스를 배포하십시오
웹 서비스를 SharePoint 서버에 수동으로 배치하거나 웹 서비스를 자동으로 배치하는 스크립트를 실행할 수 있습니다.
웹 서비스를 자동으로 배포하는 스크립트를 실행합니다:
-
Windows PowerShell cmdlet인
ESSPSolution.wsp를 입력하여 SharePoint 서버에서Add-SPSolution -LiteralPath C:\files\ESSPSolution.wsp를 실행하십시오. -
SharePoint, 에서 SharePoint 중앙 관리로 이동한 다음 시스템 설정으로 이동합니다.
-
팜 솔루션을 사용하여 패키지를 배포하십시오.
-
esspsolution.wsp솔루션을 선택한 후 솔루션을 배치하십시오.배치가 완료되면 팜 솔루션이 SharePoint 관리 콘솔에 나열됩니다. 관리자는 솔루션을 사용 또는 사용 안함으로 설정할 수 있으며 트리거를 스케줄할 수 있습니다.
-
선택 사항: 웹 서비스를 배포하는 데 사용한 접근 방식에 관계없이, 일부 환경에서 배포를 완료하려면 SharePoint 서버와 웹 서비스를 호스팅하는 인터넷 정보 서비스(IIS) 서버에 다음 구성을 적용해야 할 수 있습니다
- IIS에서 .NET 위장 허용
- WSS_Medium으로 ASP.NET 신뢰 레벨 변경
인터넷 정보 서비스 관리자에서 이러한 설정을 적용할 수 있습니다.