설정 SharePoint Online 검색 커넥터
테넌트를 구성하고 인스턴스에 연결 Microsoft SharePoint 하여 설정합니다SharePoint Online 검색 커넥터. 검색할 사이트를 인덱싱하기 전에 설정 실패를 방지하기 위해 연결을 확인합니다.
테넌트 구성 Microsoft SharePoint
를 시작하도록 SharePoint Online 검색 커넥터테넌트를 구성 Microsoft SharePoint 합니다.
시작하기 전에
사용 중단에 대한 자세한 내용은 Now Support 지식베이스의 사용 중단 프로세스 [KB0867184] 문서를 참조하십시오.
- Configure OAuth application in Microsoft Azure의 절차를 따르십시오.
- 의 절차를 따르십시오.Set up Microsoft Entra ID spoke Microsoft Entra ID 스포크(이전의 Microsoft Azure Active Directory 스포크)는 사용자를 인덱싱하기 전에 설정해야 하는 종속 플러그인입니다.
- 방법 Configure Microsoft SharePoint Graph connection이해 .
- 권한을 부여하려면 관리자 자격 증명으로 로그인하십시오.
필요한 역할: 관리자
이 태스크 정보
프로시저
- 다음으로 이동 Azure > Active Directory > 앱 등록 > 모든 애플리케이션, 기존 앱을 선택합니다.
기존 애플리케이션을 사용하거나 애플리케이션을 생성합니다.
- 다음으로 이동 앱 등록 > API 권한을 클릭하고 권한 추가를 클릭합니다.
-
다음 옵션 중 하나를 선택합니다.
- 다음으로 이동 Microsoft Graph > 위임된 권한 그래프용.
- 다음으로 이동 Microsoft Graph > 애플리케이션 권한 그래프용.
사이트 목록에서 Sites.ReadWrite.All 권한을 추가합니다. Sites.ReadWrite.All 권한은 구독 생성에 도움이 됩니다.사용자 목록에서 User.Read 권한을 추가합니다.
이러한 사용자 권한은 나중에 데이터를 크롤링 Microsoft SharePoint 하는 데 사용됩니다. -
다음으로 이동 SharePoint > 애플리케이션 권한 > 사이트에서 Sites.FullControl.All, Sites.Read.All 또는 Sites.Selected for REST를 선택합니다.
다음 단계를 수행하여 Sites.Selected 권한을 활성화합니다.
-
애플리케이션에서 Microsoft AzureSites.Selected 및 User.Read.All 권한을 사용 설정합니다.
API 클라이언트를 사용하여 다음 사이트 모음에 대한 읽기 권한을 제공합니다.
- 인스턴스에 ServiceNow 연결되어 있고 Sites.Selected 권한이 있는 애플리케이션 X입니다.
- 애플리케이션 Y는 관리자 애플리케이션이며 그래프 연결에 대한 Sites.Full.Control 권한이 있습니다.
-
API 메서드 https://login.microsoftonline.com/{Tenant Id}/oauth2/v2.0/token을 호출하여 전달자 토큰을 가져옵니다.
페이로드:
client_id={App Y client id} &scope=https%3A%2F%2Fgraph.microsoft.com%2F.default &client_secret={App Y client secret} &grant_type=client_credentials -
API 메서드 https://graph.microsoft.com/v1.0/sites/{site id}/permissions를 호출하는 동안 b단계에서 받은 토큰을 인증 토큰으로 전달합니다.
페이로드:
{ "roles": [ "read" ], "grantedToIdentities": [ { "application": { "id": "App X client id", "displayName": "App X" } } ] }
-
애플리케이션에서 Microsoft AzureSites.Selected 및 User.Read.All 권한을 사용 설정합니다.
-
다음 이미지와 같이 필요한 API 권한을 구성해야 합니다.
자세한 내용은 Configure Microsoft SharePoint Graph connection 문서를 참조하십시오.그림 1. 구성된 권한 목록 - 관리자 동의 부여를 클릭하고 예를 선택한 다음 저장 및 계속을 클릭합니다.
- 다음으로 이동 인증 > 웹 > 리디렉션 URL 및 이 형식으로 URL을 추가합니다 https://<예: ServiceNow 인스턴스 URL>/oauth_redirect.do, https://eesharepoint.example.com/oauth_redirect.do 및 저장.
- 애플리케이션에 대한 인증서 및 비밀로 이동하여 Microsoft SharePoint Online Spoke 등록합니다.
-
Microsoft 관리자 포털에서 사용자 추가를 클릭하고 사용자 상세 정보를 지정한 후 마침을 클릭합니다.
주:검색은 액세스할 수 있는 사이트를 크롤링합니다. 필요한 컨텐츠에만 적합한 권한을 가진 사용자를 선택해야 합니다. 자세한 내용은 사용자 권한을 참조하십시오. 상위 수준 사용자를 선택하면 원하는 것보다 더 많은 문서를 임포트할 수 있습니다.
자세한 내용은 Azure AD 앱 전용을 통해 액세스 권한 부여를 참조하세요.
다음에 수행할 작업
검색 소스를 Microsoft SharePoint 프로파일과 AI 검색 통합
검색 소스를 검색 프로파일에 연결하여 사용자가 연결된 검색 프로파일을 통해 검색할 수 있는 콘텐츠를 지정합니다.
시작하기 전에
필요한 역할: 관리자
프로시저
- 다음으로 이동 애플리케이션 검색 > 검색 애플리케이션 구성 (sys_search_context_config).
-
가상 에이전트 기본 검색 애플리케이션에 대해 다음 값을 업데이트합니다.
- 검색 엔진: AI 검색.
- 검색 프로파일: ESC 포털 기본 검색 프로파일입니다. 이 동적 필드 값은 검색 엔진 값을 변경한 후에 표시됩니다.
다음에 수행할 작업
인스턴스를 ServiceNow 테넌트에 Microsoft SharePoint 연결
인스턴스를 ServiceNow 테넌트에 Microsoft SharePoint 연결합니다. 요청을 인증하기 위해 Microsoft SharePoint 사용자 지정 ServiceNow OAuth 연결을 생성합니다.ServiceNow
시작하기 전에
- 애플리케이션을 구성하는 데 필요한 SharePoint 개발자 프로그램 도구 및 기타 자원에 대한 작업 지식이 있어야 합니다.
- 통합에 ServiceNow® 대해 알고 있는지 확인합니다.
프로시저
- 다음으로 이동 ServiceNow 인스턴스 > 시스템 OAuth > 애플리케이션 레지스트리.
-
새로 만들기를 클릭합니다.
어떤 종류의 OAuth 애플리케이션입니까?
- 외부 공급업체 OAuth 제공자에 연결을 선택합니다.
-
다음 레지스트리를 생성합니다.
- 그래프 연결 양식의 필드에 내용을 입력합니다.
필드 값에 대한 설명은 다음 문서를 참조하십시오 그래프 연결 양식.
-
REST 연결 양식의 필드에 내용을 입력합니다.
필드 값에 대한 설명은 다음 문서를 참조하십시오 REST 연결 양식.
- 양식 헤더를 마우스 오른쪽 단추로 클릭하고 저장을 클릭합니다.
- 그래프 연결 양식의 필드에 내용을 입력합니다.
-
OAuth 엔터티 프로파일 [oauth_entity_profile] 테이블로 이동하여 다음 항목을 찾습니다.
<그래프 애플리케이션 레지스트리 이름>.default_profile<REST 애플리케이션 레지스트리 이름>.default_profile
OAuth 엔터티 프로파일 [oauth_entity_profile] 테이블에 두 개의 시스템에서 생성된 OAuth 엔터티 프로파일(REST 및 Graph)이 생성됩니다. 자세한 내용은 Specify an OAuth profile 문서를 참조하십시오.
-
OAuth 엔터티 범위 [oauth_entity_scope] 테이블에 다음 값이 있는 행을 삽입합니다.
자세한 내용은 Specify an OAuth scope 문서를 참조하십시오.표 1. OAuth 엔터티 범위 그래프 REST 이름: 원하는 이름 이름: 원하는 이름 OAuth 제공자: 그래프 애플리케이션 레지스트리 기록 OAuth 제공자: REST 애플리케이션 레지스트리 기록 애플리케이션: 글로벌 애플리케이션: 글로벌 (위임된 권한의 경우) OAuthscope: offline_access https://graph.microsoft.com/Sites.ReadWrite.All(애플리케이션 권한의 경우) OAuthscope:
https://graph.microsoft.com/.defaultOAuth 범위: https://<인스턴스 이름>.sharepoint.com/
- OAuth 엔터티 프로파일 범위 [oauth_entity_profile_scope] 테이블에 다음 값이 있는 행을 삽입합니다.
표 2. OAuth 엔터티 프로파일 범위 그래프 REST OAuth 엔터티 프로파일: OAuth 엔터티 프로파일 [oauth_entity_profile] 테이블에서 생성된 그래프 엔터티 프로파일입니다. OAuth 엔터티 프로파일: OAuth 엔터티 프로파일 [oauth_entity_profile] 테이블에서 생성된 REST 엔터티 프로파일입니다. OAuth 엔터티 범위: 그래프 OAuth 엔터티 범위[oauth_entity_profile_scope] 테이블을 선택합니다. OAuth 엔터티 범위: REST OAuth 엔터티 범위[oauth_entity_profile_scope] 테이블을 선택합니다. 애플리케이션: 글로벌 애플리케이션: 글로벌
-
다음으로 이동 연결 및 자격 증명 > 자격 증명에서 OAuth 2.0 자격 증명을 생성합니다.
-
그래프 또는 REST 자격 증명 양식의 필드에 내용을 입력합니다.
표 3. OAuth 2.0 자격 증명 양식 필드 설명 이름 선택한 이름입니다. OAuth 엔터티 프로파일 (그래프용) 그래프 엔터티 프로파일이 식별되었습니다. (REST의 경우) REST 엔터티 프로파일이 식별되었습니다.
-
양식 헤더를 마우스 오른쪽 단추로 클릭하고 저장을 클릭합니다.
주:엔터티, 연결 및 자격 증명 별칭에 대한 자세한 내용은 다음 문서를 참조하십시오 Configure the SharePoint Graph Root Site Subscription connection and credential alias record.
-
그래프 또는 REST 자격 증명 양식의 필드에 내용을 입력합니다.
- 다음으로 이동 연결 및 자격 증명 > 연결을 클릭하고 새로 만들기 를 클릭하여 다음 그래프 또는 REST에 대한 HTTP 연결을 생성합니다.
-
양식에서 필드를 채웁니다.
표 4. 연결 양식 필드 설명 이름: 그래프에 대해 선택한 이름 이름: REST에 대해 선택한 이름 자격 증명: 그래프 선택 자격 증명 자격 증명: REST 자격 증명 선택 연결 별칭: sn_sp_spoke. MicrosoftSharePointGraph 연결 별칭: sn_sp_spoke. MicrosoftSharepointOnline 연결 URL: https://graph.microsoft.com/v1.0/ 연결 URL: https://<SharePoint 인스턴스의 호스트 URL입니다>/ 도메인: 전역 도메인: 전역 - 양식 헤더를 마우스 오른쪽 단추로 클릭하고 저장을 클릭합니다.
자세한 내용은 Connections and Credentials 및 Create an HTTP(s) connection 문서를 참조하십시오. -
양식에서 필드를 채웁니다.
- 다음으로 이동 Microsoft Sharepoint Online > 테넌트.
- 새로 만들기를 클릭하여 그래프 또는 REST 연결을 작성합니다.
-
양식에서 필드를 채웁니다.
표 5. 테넌트 연결 양식 필드 설명 이름 선택한 이름입니다. 별칭 그래프의 경우: sn_sp_spoke. MicrosoftSharePointGraph REST의 경우: sn_sp_spoke. MicrosoftSharepointOnline
SharePoint 루트 URL 루트 URL은 <SiteName>.sharepoint.com 테넌트 ID 그래프 또는 REST 연결에 필요한 테넌트 ID입니다. 도메인 전역 - 주제 헤더를 마우스 오른쪽 버튼으로 클릭하고 저장을 클릭합니다.
-
다음으로 이동 시스템 정의 > 인증서 > Microsoft SharePoint Online 인증서.
- Azure AD 포털에서 생성된 파일 Java 키 스토어 인증서를 첨부합니다.
자세한 내용은 Attach a Java Key Store certificate 문서를 참조하십시오.
- Java 키 스토어(.jks) 파일의 암호로 키 스토어 암호를 업데이트합니다.
- 유형을 Java 키 스토어로 업데이트합니다.
- 주제 헤더를 마우스 오른쪽 버튼으로 클릭하고 저장을 클릭합니다.
- Azure AD 포털에서 생성된 파일 Java 키 스토어 인증서를 첨부합니다.
-
다음으로 이동 시스템 OAuth > JWT 키 > Microsoft SharePoint Online JWT 키.
- 인증서(.cer) 파일의 암호로 서명 키를 업데이트합니다.
- 주제 헤더를 마우스 오른쪽 버튼으로 클릭하고 저장을 클릭합니다.
- 다음으로 이동 시스템 OAuth > JWT 제공자 > Microsoft SharePoint Online JWT 제공자.
- aud 클레임을 https://login.microsoftonline.com/<Tenant-id>/oauth2/token으로 업데이트합니다.
- Azure AD 앱 등록 시 해당 클라이언트 ID로 iss 및 sub 클레임을 업데이트합니다.
- 저장을 클릭합니다.
-
다음으로 이동 연결 및 자격 증명 > 연결.
-
REST 연결 기록을 열고 속성 탭에서 Base 64 인코딩된 인증서 지문을 지정합니다.
주:SharePoint 앱 지문 값은 16진수 인코딩됩니다. 연결 기록에서 Base64 형식으로 동일한 내용을 인코딩합니다.
-
다음 자격 증명 옵션을 선택합니다.
- ( 그래프의 경우): [자격 증명] 테이블(oauth_2_0_credentials)로 이동하여 그래프를 열고 OAuth 토큰 가져오기를 클릭합니다.
그래프 연결을 위한 OAuth 토큰을 가져오기 위해 생성한 사용자의 자격 증명으로 인스턴스에 Microsoft SharePoint 로그인해야 합니다. 인스턴스에 자격 증명을 저장합니다.
- ( REST의 경우): [자격 증명] 테이블(oauth_2_0_credentials)으로 이동하여 REST를 열고 OAuth 토큰 가져오기를 클릭합니다.
REST 연결에 대한 OAuth 토큰을 가져오려면 테넌트 관리자 자격 증명으로 인스턴스에 Microsoft SharePoint 로그인해야 합니다. 인스턴스에 자격 증명을 저장합니다.
구성 실패를 방지하려면 자격 증명을 확인합니다. SharePoint 연결 확인에 대한 자세한 내용은 다음 문서를 참조하십시오 연결 확인 Microsoft SharePoint.
- ( 그래프의 경우): [자격 증명] 테이블(oauth_2_0_credentials)로 이동하여 그래프를 열고 OAuth 토큰 가져오기를 클릭합니다.
- 저장을 클릭합니다.
-
REST 연결 기록을 열고 속성 탭에서 Base 64 인코딩된 인증서 지문을 지정합니다.
-
신뢰할 수 있는 도메인 테이블(sn_ais_spoke_trusted_domains)으로 이동하고 새로 만들기를 클릭하여 도메인 기록을 생성합니다.
-
양식에서 필드를 채웁니다.
표 6. 도메인 기록 양식 필드 설명 이름 선택한 이름입니다. 도메인 <테넌트의 호스트 URL입니다 Microsoft SharePoint >. -
저장을 클릭합니다.
자세한 내용은 Set up the AI Search spoke 문서를 참조하십시오.주:테넌트가 여러 개인 경우 각 테넌트에 대해 신뢰할 수 있는 도메인 기록을 생성해야 합니다.
-
양식에서 필드를 채웁니다.
-
다음으로 이동 연결 및 자격 증명 > 연결 및 자격 증명 별칭 > SharePoint 사용자 수집 (sn_sp_con. Sharepoint_Ingest_User).
- 자격 증명에서새로 만들기를 클릭하여 AIS에서 외부 콘텐츠를 수집하기 위한 기본 인증 자격 증명을 생성합니다.
-
ais_external_content 역할을 가진 사용자(sys_user)의 사용자 이름과 암호를 지정합니다.
주:스크린샷 예시에서 abel.tuter 사용자는 ais_external_content 역할이 할당된 sys_user입니다.
-
제출을 클릭합니다.
자세한 내용은 Create aliases for multiple tenants 문서를 참조하십시오.
- 다음 단계를 진행하기 전에 AI 검색 서버 연결을 구성합니다.
Entity View Action Mapper(EVAM) 구성은 버전 32.0에서 직원 센터 프로 기본적으로 사용할 수 있습니다.
EVAM 정의에 대한 자세한 내용은 해당 문서를 참조하십시오 Create an EVAM action definitionCreate a multi-data source list display in Entity View Action Mapper.
결과
다음에 수행할 작업
연결 확인 Microsoft SharePoint
인스턴스를 테넌트에 Microsoft SharePoint 연결 ServiceNow 한 후 유효성 검사를 실행하여 구성에 오류가 있는지 확인합니다.
시작하기 전에
필요한 역할: 관리자
이 태스크 정보
확인을 통해 구성 실패가 배제되고 원활한 설정 프로세스가 보장됩니다.
프로시저
- 다음으로 이동 시스템 UI > UI 페이지 > SharePoint 유틸리티.
- 시도를 선택하여 SharePoint 연결 확인 페이지로 이동합니다.
-
필요한 상세 정보를 입력하고 확인을 선택합니다. 오류가 있는 경우 응답 섹션에 표시됩니다.
-
테이블 이름 링크를 확인하고 응답 섹션에 표시된 현재 값과 예상 값을 기준으로 오류를 수정합니다.
누락된 정보가 있는 경우 오류 필드에 데이터가 표시됩니다.
오류가 없으면 응답 섹션에 성공적인 확인이 표시됩니다.