설정 SharePoint Online 검색 커넥터

SharePoint Online 검색 커넥터 테넌트를 Microsoft SharePoint 구성하고 인스턴스와 연결하여 설정합니다. 검색을 위해 사이트를 인덱싱하기 전에 설정 실패를 방지하기 위해 연결의 유효성을 검사합니다.

Microsoft SharePoint 테넌트 구성

Microsoft SharePoint 를 시작하도록 테넌트를 SharePoint Online 검색 커넥터구성합니다.

시작하기 전에

Microsoft SharePoint 관리자는 루트 URL(https:// <sitename>.sharepoint.com), 앱 도메인, 리디렉션 URL 및 기타 설정을 지정하여 사용자 지정 응용 프로그램을 만듭니다.

자세한 내용은 문서를 참조하십시오.

관리자 자격 증명으로 로그인하여 권한을 부여합니다.

필요한 역할: admin

이 태스크 정보

계정에서 다음 절차를 Microsoft SharePoint 완료합니다. 사용자 지정 응용 프로그램을 만들고 구성하는 방법에 대한 자세한 내용은 SharePoint 개발을 참조하십시오
주:
Azure 앱에 할당된 권한에 권한 문제가 있는 경우 오류 메시지: 메서드 실패: (/_api/web/XXXXXXX) 코드: 401 - 잘못된 사용자 이름/암호 콤보. KB1117977에서 사용할 수 있는 지침에 따라 이 문제를 해결합니다.
검색 결과에 문서의 게시된 버전만 표시되도록 하려면 에 설명된 사용 권한을 구성하는 동안 위임된 사용 권한 대신 응용 프로그램 사용 권한을 선택해야 합니다.
주:
관리자는 게시된 버전만 인덱싱하도록 제한하여 초안 또는 완료되지 않은 작업이 검색 결과에 표시되지 않도록 할 수 있습니다.

프로시저

  1. 다음으로 이동 Azure > Active Directory > 앱 등록 > 모든 애플리케이션 을 클릭하고 앱을 선택합니다.

    기존 애플리케이션을 사용하거나 애플리케이션을 생성합니다.

  2. 다음으로 이동 앱 등록 > API 권한을 클릭하고 권한 추가를 클릭합니다.
  3. 다음으로 이동 Microsoft Graph > 위임된 권한 그래프의 경우.
    1. 사이트 목록에서 Sites.ReadWrite.All 권한을 추가합니다.
      Sites.ReadWrite.All 권한은 구독을 만드는 데 도움이 됩니다.
    2. 사용자 목록에서 User.Read 권한을 추가합니다.
    이러한 사용자 권한은 나중에 데이터를 크롤링 Microsoft SharePoint 하는 데 사용됩니다.
  4. 다음으로 이동 SharePoint > 애플리케이션 권한 > 사이트를 클릭하고 REST에 대해 Sites.FullControl.All 을 선택합니다.
  5. Grant admin consent(관리자 동의 허용)를 클릭하고 Yes(예)를 선택한 다음 Configured Permission(구성된 권한) 탭에서 Save and Continue(저장 및 계속)를 클릭합니다.
  6. 다음으로 이동 인증 > 웹 > 리디렉션 URL.
    1. URL을 https://<ServiceNow 인스턴스 URL>/oauth_redirect.do 형식으로 추가합니다(예: https://eesharepoint.example.com/oauth_redirect.do 하고 저장을 클릭).
  7. 응용 프로그램에 대한 인증서와 비밀로 이동하여 등록합니다.
  8. Microsoft 관리 포털에서 사용자 추가를 클릭하고 사용자 세부 정보를 지정한 다음 마침을 클릭합니다.
    주:
    검색은 액세스할 수 있는 사이트를 크롤링합니다. 필요한 콘텐츠에만 대해 적절한 권한이 있는 사용자를 선택해야 합니다. 자세한 내용은 사용자 배출을 참조하세요. 상위 수준 사용자를 선택하면 임포트하려는 것보다 많은 문서를 임포트할 수 있습니다.

    자세한 내용은 https://docs.microsoft.com/en-us/sharepoint/dev/solution-guidance/security-apponly-azuread 문서를 참조하십시오.

다음에 수행할 작업

계정에서 ServiceNow AI 검색 통합을 완료합니다. 자세한 내용은 검색 소스를 AI 검색 프로필에 통합 Microsoft SharePoint 문서를 참조하십시오.

ServiceNow 인스턴스를 테넌트에 Microsoft SharePoint 연결

ServiceNow 인스턴스를 테넌트와 Microsoft SharePoint 연결합니다. 요청을 인증 ServiceNow 하기 위해 Microsoft SharePoint 사용자 지정 ServiceNow OAuth 연결을 생성합니다.

시작하기 전에

  • SharePoint 개발자 프로그램 도구 및 기타 리소스를 사용하여 응용 프로그램을 구성해야 합니다.
  • 통합에 ServiceNow® 대해 알고 있어야 합니다.
  • 사이트 인덱싱을 시작하기 전에 구성에 대한 유효성 검사를 실행합니다.
필요한 역할: 관리자

프로시저

  1. 다음으로 이동 ServiceNow 인스턴스 > 시스템 OAuth > 애플리케이션 레지스트리.
  2. 새로 만들기를 클릭합니다.
    시스템에 "어떤 종류의 OAuth 애플리케이션입니까?"라는 메시지가 표시됩니다.
  3. 외부 공급업체 OAuth 제공자에 연결을 선택합니다.
  4. 다음 연결을 생성합니다.
  5. Graph 연결 양식의 필드에 내용을 입력합니다.
    필드 값에 대한 설명은 을 참조하십시오 그래프 연결 양식.
  6. 양식 헤더를 마우스 오른쪽 버튼으로 클릭하고 저장을 클릭합니다.
  7. REST 연결 양식의 필드에 내용을 입력합니다.
    필드 값에 대한 설명은 을 참조하십시오 REST 연결 양식.
  8. 양식 헤더를 마우스 오른쪽 버튼으로 클릭하고 저장을 클릭합니다.
    OAuth 엔터티 프로파일 [oauth_entity_profile] 테이블에 두 개의 시스템 생성 OAuth 엔터티 프로파일(REST 및 그래프)이 생성됩니다.
  9. 다음으로 이동 OAuth 엔터티 프로파일 [oauth_entity_profile] 테이블을 사용하여 다음 두 항목을 찾을 수 있습니다.
    • <Graph 애플리케이션 레지스트리 이름입니다>.default_profile
    • <REST 애플리케이션 레지스트리 이름입니다>.default_profile
  10. OAuth 엔터티 범위 [oauth_entity_scope] 테이블에 다음 값이 있는 행을 삽입합니다.
    그래프의 경우:
    • 이름: 원하는 이름
    • OAuth 제공자: Graph 애플리케이션 레지스트리 기록
    • 애플리케이션: Global
    • OAuth 범위: offline_access https://graph.microsoft.com/Sites.ReadWrite.All

    휴식:REST의 경우:

    • 이름: 원하는 이름
    • OAuth 제공자: REST 애플리케이션 레지스트리 기록
    • 애플리케이션: Global
    • OAuth 범위 = https://<인스턴스 이름>.sharepoint.com/
  11. OAuth 엔터티 프로파일 범위 [oauth_entity_profile_scope] 테이블에 다음 값이 있는 행을 삽입합니다.
    그래프의 경우:
    • OAuth 엔터티 프로파일: OAuth 엔터티 프로파일 [oauth_entity_profile] 테이블에서 생성된 그래프 엔터티 프로파일입니다.
    • OAuth 엔터티 범위: 10단계에서 생성한 그래프 OAuth 엔터티 범위 [oauth_entity_profile_scope] 테이블을 선택합니다.
    • 애플리케이션: Global

    나머지의 경우:

    • OAuth 엔터티 프로파일: OAuth 엔터티 프로파일 [oauth_entity_profile] 테이블에서 생성된 REST 엔터티 프로파일입니다.
    • OAuth 엔터티 범위: 10단계에서 생성한 REST OAuth 엔터티 범위 [oauth_entity_profile_scope] 테이블을 선택합니다.
    • 애플리케이션: Global

    자격 증명을 구성합니다.

  12. 다음으로 이동 연결 및 자격 증명 > 자격 증명을 클릭하고 OAuth 2.0 자격 증명을 만듭니다.
    Graph 자격 증명 양식의 필드에 내용을 입력합니다.
    표 1. OAuth 2.0 Graph 자격 증명 양식
    필드 설명
    이름 선택한 이름입니다.
    OAuth 엔터티 프로파일 식별된 그래프 엔터티 프로파일입니다.
    양식 헤더를 마우스 오른쪽 버튼으로 클릭하고 저장을 클릭합니다.
  13. 양식의 필드에 내용을 입력합니다.
    표 2. OAuth 2.0 REST 자격 증명 양식
    필드 설명
    이름 선택한 이름입니다.
    OAuth 엔터티 프로파일 나머지 엔터티 프로파일이 식별되었습니다.
    주:
    엔터티, 연결 및 자격 증명 별칭에 대한 자세한 내용은 을 참조하십시오 .
  14. 다음으로 이동 연결 및 자격 증명 > 연결를 클릭하고 새로 만들기를 클릭하여 다음 Graph 및 REST에 대한 HTTP 연결을 만듭니다.
    • 이름: 그래프 및 REST에 대해 선택한 이름입니다.
    • 자격 증명을 선택합니다.
      • 그래프의 경우: 그래프 자격 증명 선택
      • REST의 경우: REST 자격 증명 선택
    • 연결 별칭:
      • 그래프의 경우:sn_sp_spoke. MicrosoftSharePointGraph
      • REST의 경우: sn_sp_spoke. MicrosoftSharepointOnline
    • 연결 URL
      • 그래프: https://graph.microsoft.com/v1.0/
      • REST의 경우: https://<SharePoint 인스턴스의 호스트 URL>/
    • 도메인: 전역
  15. 테넌트로 이동합니다.
  16. 새로 만들기를 클릭하여 그래프 및 REST 연결을 만듭니다.
  17. 양식의 필드에 내용을 입력합니다.
    표 3. 테넌트 새 연결 양식
    필드 설명
    이름 선택한 이름입니다.
    별칭
    • 그래프의 경우:sn_sp_spoke. MicrosoftSharePointGraph
    • REST:sn_sp_spoke의 경우. MicrosoftSharepointOnline
    SharePoint 루트 URL 루트 URL을 <SiteName>.sharepoint.com 로
    테넌트 ID Graph 또는 REST 연결에 필요한 특정 테넌트 ID입니다.
    도메인 글로벌.
  18. 주제 헤더를 마우스 오른쪽 버튼으로 클릭하고 저장을 클릭합니다.
  19. 다음으로 이동 시스템 정의 > 인증서 > Microsoft SharePoint Online 인증서.
    1. Azure AD 포털에서 파일이 생성된 Java 키 저장소 인증서를 첨부합니다.
      자세한 내용은 문서를 참조하십시오.
    2. 키 저장소 비밀번호를 Java 키 저장소(.jks) 파일의 비밀번호로 업데이트합니다.
    3. Java 키 저장소로 유형을 업데이트합니다.
    자세한 내용은 문서를 참조하십시오.
  20. 다음으로 이동 시스템 OAuth > JWT 키 > Microsoft SharePoint Online JWT 키.
    1. 인증서(.cer) 파일 저장의 암호로 서명 키 업데이트.
  21. 다음으로 이동 시스템 OAuth > JWT 제공자 > Microsoft SharePoint Online JWT 공급자.
    1. aud 클레임을 https://login.microsoftonline.com/<Tenant-id>/oauth2/token으로 업데이트합니다.
    2. iss 및 sub 클레임을 Azure AD 앱 등록의 각 클라이언트 ID로 업데이트하고 저장을 클릭합니다.
  22. 다음으로 이동 연결 및 자격 증명 > 연결.
  23. REST 연결 기록을 열고 속성 탭에서 지문의 Base64 인코딩 값을 지정합니다.
  24. [자격 증명] 테이블(oauth_2_0_credentials)로 이동하여 Graph를 엽니다.
  25. OAuth 토큰 가져오기를 클릭합니다.
    Graph 연결을 위한 OAuth 토큰을 가져오기 위해 생성한 사용자의 자격 증명으로 인스턴스에 로그인 Microsoft SharePoint 해야 합니다. 인스턴스에 자격 증명을 저장합니다.
  26. [자격 증명] 테이블(oauth_2_0_credentials)로 이동하여 REST를 엽니다.
  27. OAuth 토큰 가져오기를 클릭합니다.
    테넌트 관리자 자격 증명으로 인스턴스에 로그인하여 Microsoft SharePoint Rest 연결을 위한 OAuth 토큰을 가져와야 합니다. 인스턴스에 자격 증명을 저장합니다.

    구성 실패를 방지하기 위해 자격 증명의 유효성을 검사합니다. sharePoint 연결의 유효성을 검사하는 방법에 대한 자세한 내용은 을 참조하십시오 연결 확인 Microsoft SharePoint.

  28. 신뢰할 수 있는 도메인 테이블(sn_ais_spoke_trusted_domains)로 이동하고 새로 만들기를 클릭하여 도메인 레코드를 만듭니다.

    양식의 필드에 내용을 입력합니다.

    표 4. 도메인 기록 양식
    필드 설명
    이름 선택한 이름입니다.
    도메인 <테넌트의 호스트 URL입니다 Microsoft SharePoint >.
    주:
    테넌트가 여러 개인 경우 각 테넌트에 대해 신뢰할 수 있는 도메인 기록을 생성해야 합니다.
  29. EVAM을 생성한 후 구성합니다.
  30. 다음으로 이동 연결 및 자격 증명 > 연결 및 자격 증명 별칭 > Sharepoint 수집 사용자.
  31. 자격 증명에서 새로 만들기를 클릭하여 기본 인증 자격 증명을 생성합니다.
    Sharepoint Ingest 사용자에게 통합 사용자 역할을 하도록 할당된 ais_external_content 역할이 있는지 확인합니다.
  32. 다음 단계를 진행하기 전에 AI 검색 서버 연결을 구성해야 합니다.
  33. 다음으로 이동 엔티티 뷰 작업 매퍼(EVAM) > EVAM 정의.
  34. ESC 포털 검색을 선택하고 EVAM 뷰 구성 번들 M2M을 엽니다.
  35. 기존 연결을 선택하여 데이터 소스를 추가합니다.
  36. 양식의 필드에 내용을 입력합니다.
    표 5. ESC 포털 검색 데이터 소스 생성 양식
    필드 설명
    주문 목록에서 가장 낮은 값입니다.
    구성 번들 보기 Microsoft SharePoint 검색 번들.
  37. 다음으로 이동 엔티티 뷰 작업 매퍼(EVAM) > EVAM 정의.
  38. Virtual Agent 검색을 선택하고 EVAM 뷰 구성 번들 M2M을 엽니다.
  39. 기존 연결을 선택하여 데이터 소스를 추가합니다.
  40. 양식의 필드에 내용을 입력합니다.
    표 6. 가상 에이전트 검색 데이터 소스 생성 양식
    필드 설명
    주문 목록에서 가장 낮은 순서 값입니다.
    구성 번들 보기 SharePoint 검색 번들.
    EVAM 정의에 대한 자세한 내용은 해당 Create a multi-data source list display in Entity View Action Mapper문서를 참조하십시오Create an EVAM action definition.
  41. 다음으로 이동 AI 검색 > 검색 프로파일 을 클릭하고 ESC 포털 기본 검색 프로필을 엽니다.
    1. 검색 원본으로 이동하고, 기존 항목 연결을 클릭하고, SharePoint를 검색 원본으로 추가합니다.

      자세한 내용은 Create a search profile 문서를 참조하십시오.

    2. 스톱 워드로 이동하여 기록의 상태를 확인합니다.
    3. 상태가아직 게시됨이 아닌 경우 기록을 열고 게시를 클릭합니다.

      자세한 내용은 Search profiles in AI Search 문서를 참조하십시오.

    4. 동의어로 이동하여 기록 상태를 확인합니다.
    5. 상태가게시되지 않은 경우. 기록을 열고 게시를 클릭합니다.

      자세한 내용은 Synonyms 문서를 참조하십시오.

    6. 검색 소스 탭으로 이동합니다.
    7. SharePoint를 선택하고 사용 가능한 옵션에서 필터 조건 및 조건을 추가합니다.

      구성에 따라 직원은 검색 결과에서 필터링된 Microsoft SharePoint 컨텐츠를 볼 수 있습니다.

  42. 검색 프로필에서 게시를 클릭하여 새 Microsoft SharePoint 검색 소스로 프로필을 게시합니다.
  43. AI 검색 프로필 로 이동하여 NowMobile 기본 검색 프로필을 엽니다.
    1. Search Sources(검색 소스) 탭에서 Link Existing(기존 항목 연결)을 클릭합니다.
      • 검색 원본: SharePoint
      • 애플리케이션: Global
    2. 스톱 워드로 이동하여 기록 상태를 확인합니다.
    3. 기록을 열고 게시를 클릭합니다.
    4. 동의어로 이동하여 기록 상태를 확인합니다.
    5. 기록을 열고 게시를 클릭합니다.
  44. 애플리케이션 검색(sys_search_context_config)으로 이동합니다.
    Virtual Agent 기본 검색 애플리케이션에 대해 다음 값을 업데이트합니다.
    • 검색 엔진: AI Search.
    • 검색 프로파일: ESC 포털 기본 검색 프로파일입니다. 이 동적 필드 값은 검색 엔진 값을 변경한 후에 표시됩니다.
  45. Search Scripted Post-processors 탭으로 이동하고 New를 클릭합니다.
    • 순서: 원하는 순서(예: 100 또는 200)를 사용합니다.
    • 스크립트로 작성된 검색 프로세서: SharePoint 커넥터 스크립트
  46. Search Scripted Post-processors(스크립트 후 프로세서 검색) 탭으로 이동하고 ESC Portal Default Search Application(ESC 포털 기본 검색 애플리케이션)에 대해 New(새로 만들기)를 클릭합니다.
    • 순서: 원하는 순서(예: 100 또는 200)를 사용합니다.
    • 스크립트로 작성된 검색 프로세서: SharePoint 커넥터 스크립트
  47. 전역 검색 M2M 항목 구성 (sys_sg_global_search_m2m_master_item)으로 이동하여 다음 항목을 생성합니다. 
    Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search Excel Main Item
Application: SharePoint Search Connector

Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search File Main Item 
Application: SharePoint Search Connector

Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search HTML Main Item
Application: SharePoint Search Connector

Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search Pages Main View
Application: SharePoint Search Connector

Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search PDF Main Item
Application: SharePoint Search Connector

Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search PPT Main Item
Application: SharePoint Search Connector

Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search Site Main Item
Application: SharePoint Search Connector

Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search Word Main Item
Application: SharePoint Search Connector

결과

구성이 완료되었습니다.

다음에 수행할 작업

연결 확인 Microsoft SharePoint 샘플 사이트를 인덱싱하기 전에 구성 오류를 배제합니다.

연결 확인 Microsoft SharePoint

인스턴스를 테넌트에 Microsoft SharePoint 연결 ServiceNow 한 후 확인을 실행하여 구성에 오류가 있는지 확인합니다.

시작하기 전에

필요한 역할: 관리자

이 태스크 정보

유효성 검사는 구성 오류를 배제하고 원활한 설정 프로세스를 보장합니다.

프로시저

  1. 다음으로 이동 시스템 UI > UI 페이지 > Sharepoint 유틸리티.
  2. 사용해 보기를 선택하여 SharePoint 연결 유효성 검사 페이지로 이동합니다.
  3. 필요한 세부 정보를 입력하고 확인을 선택합니다.
    오류(있는 경우)가 응답 섹션에 표시됩니다.
  4. 테이블 이름 링크를 확인하고 응답 섹션에 표시된 현재 값과예상 값에 따라 오류를 수정합니다.

    누락된 정보가 있으면 오류 필드에 데이터가 표시됩니다.

    오류가 없으면 응답 섹션에 성공적인 유효성 검사가 표시됩니다.

다음에 수행할 작업

검색을 위해 사이트를 인덱싱합니다. 자세한 내용은 검색을 위한 인덱스 사이트 문서를 참조하십시오.