설정 SharePoint Online 검색 커넥터
SharePoint Online 검색 커넥터 테넌트를 Microsoft SharePoint 구성하고 인스턴스와 연결하여 설정합니다. 검색할 사이트를 인덱싱하기 전에 연결 상태를 확인하여 설정 오류가 발생하지 않도록 합니다.
Microsoft SharePoint 테넌트 구성
를 SharePoint Online 검색 커넥터시작하도록 테넌트를 Microsoft SharePoint 구성합니다.
시작하기 전에
사용 중단에 대한 자세한 내용은 Now Support 지식베이스의 사용 중단 프로세스 [KB0867184] 문서를 참조하십시오.
- 절차에 따라 로 이동합니다 .
- 절차에 따라 로 이동합니다 Set up Microsoft Entra ID spoke. Microsoft Entra ID 스포크(이전의 Microsoft Azure Active Directory 스포크)는 사용자를 인덱싱하기 전에 설정해야 하는 종속 플러그인입니다.
- 방법을 이해하십시오 .
- 권한을 부여하려면 관리자 자격 증명으로 로그인하십시오.
필요한 역할: admin
이 태스크 정보
프로시저
- 다음으로 이동 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 Azure 애플리케이션에서 Sites.Selected 및 User.Read.All 권한을 사용하도록 설정합니다.
API 클라이언트를 사용하여 다음 사이트 모음에 대한 읽기 권한을 제공합니다.
- 인스턴스에 연결되어 ServiceNow 있으며 Sites.Selected 권한이 있는 애플리케이션 X입니다.
- 애플리케이션 Y - 관리 애플리케이션이며 Graph 연결에 대한 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 Azure 애플리케이션에서 Sites.Selected 및 User.Read.All 권한을 사용하도록 설정합니다.
-
다음 이미지와 같이 필요한 API 권한을 구성해야 합니다.
자세한 내용은 문서를 참조하십시오.그림 1. 구성된 권한 목록 - Grant admin consent(관리자 동의 부여)를 클릭하고 Yes(예)를 선택한 다음 Save and Continue(저장 및 계속)를 클릭합니다.
- 다음으로 이동 인증 > 웹 > 리디렉션 URL 을 클릭하고 다음 형식으로 URL을 추가 https://<ServiceNow 인스턴스 URL>/oauth_redirect.do(예: https://eesharepoint.example.com/oauth_redirect.do )를 클릭하고 저장을 클릭합니다.
- 애플리케이션에 대한 인증서와 비밀을 찾아 등록합니다.
-
Microsoft 관리 포털에서사용자 추가를 클릭하고 사용자 세부 정보를 지정한 다음 마침을 클릭합니다.
주:검색할 때 액세스할 수 있는 사이트를 크롤링합니다. 필요한 컨텐츠에 대해서만 적절한 권한이 있는 사용자를 선택해야 합니다. 자세한 내용은 사용자 권한을 참조하십시오. 상위 수준 사용자를 선택하면 임포트하려는 것보다 더 많은 문서를 임포트할 수 있습니다.
자세한 내용은 Azure AD 앱 전용을 통한 액세스 권한 부여를 참조하세요.
다음에 수행할 작업
검색 소스를 프로파일과 AI 검색 통합 Microsoft SharePoint
검색 소스를 검색 프로파일에 연결하여 사용자가 연결된 검색 프로파일을 통해 검색할 수 있는 콘텐츠를 지정합니다.
시작하기 전에
필요한 역할: 관리자
프로시저
- 다음으로 이동 애플리케이션 검색 > 검색 애플리케이션 구성 (sys_search_context_config).
-
가상 에이전트 기본 검색 애플리케이션에 대해 다음 값을 업데이트합니다
- 검색 엔진: AI 검색
- 검색 프로파일: ESC 포털 기본 검색 프로파일입니다. 이 동적 필드 값은 검색 엔진 값을 변경한 후에 표시됩니다.
다음에 수행할 작업
테넌트에 ServiceNowMicrosoft SharePoint 인스턴스 연결
ServiceNow 인스턴스를 테넌트에 Microsoft SharePoint 연결합니다. 요청을 인증 ServiceNow 하기 위한 Microsoft SharePoint 사용자 지정 ServiceNow OAuth 연결을 생성합니다.
시작하기 전에
- SharePoint 개발자 프로그램, 도구 및 응용 프로그램 구성에 필요한 기타 리소스에 대한 작업 지식이 있는지 확인합니다.
- 통합에 ServiceNow® 대해 알고 있어야 합니다.
프로시저
- 다음으로 이동 ServiceNow 인스턴스 > 시스템 OAuth > 애플리케이션 레지스트리.
-
새로 만들기를 클릭합니다.
어떤 종류의 OAuth 애플리케이션입니까?
- 외부 공급업체 OAuth 제공자에 연결을 선택합니다.
-
다음 레지스트리를 생성합니다.
- 그래프 연결 양식의 필드에 내용을 입력합니다.
필드 값에 대한 설명은 다음 문서를 참조하십시오 그래프 연결 양식.
-
REST 연결 양식의 필드에 내용을 입력합니다.
필드 값에 대한 설명은 다음 문서를 참조하십시오 REST 연결 양식.
- 양식 헤더를 마우스 오른쪽 단추로 클릭하고 저장을 클릭합니다.
- 그래프 연결 양식의 필드에 내용을 입력합니다.
-
OAuth 엔터티 프로파일 [oauth_entity_profile] 테이블로 이동하여 다음 항목을 찾습니다.
<그래프 애플리케이션 레지스트리 이름>.default_profile<REST 애플리케이션 레지스트리 이름>.default_profile
시스템에서 생성된 두 개의 OAuth 엔터티 프로파일(REST 및 Graph)이 OAuth 엔터티 프로파일 [oauth_entity_profile] 테이블에 생성됩니다. 자세한 내용은 Specify an OAuth profile 문서를 참조하십시오.
-
OAuth 엔터티 범위 [oauth_entity_scope] 테이블에 다음 값이 포함된 행을 삽입합니다.
자세한 내용은 Specify an OAuth scope 문서를 참조하십시오.표 1. OAuth 엔터티 범위 그래프 REST 이름: 선택한 이름 이름: 선택한 이름 OAuth 제공자: Graph 애플리케이션 레지스트리 기록 OAuth 제공자: REST 애플리케이션 레지스트리 기록 애플리케이션: Global 애플리케이션: Global (위임된 권한의 경우) OAuthscope: offline_access https://graph.microsoft.com/Sites.ReadWrite.All(애플리케이션 권한의 경우) OAuthscope:
https://graph.microsoft.com/.defaultOAuth 범위: https://<인스턴스 이름>.sharepoint.com/.default
- 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] 테이블을 선택합니다. 애플리케이션: Global 애플리케이션: Global
-
다음으로 이동 연결 및 자격 증명 > 자격 증명을 클릭하고 OAuth 2.0 자격 증명을 생성합니다.
-
그래프 또는 REST 자격 증명 양식의 필드에 내용을 입력합니다.
표 3. OAuth 2.0 자격 증명 양식 필드 설명 이름 선택한 이름입니다. OAuth 엔터티 프로파일 (그래프의 경우) 그래프 엔터티 프로파일이 식별되었습니다. (REST의 경우) REST 엔터티 프로파일이 식별되었습니다.
-
양식 헤더를 마우스 오른쪽 단추로 클릭하고 저장을 클릭합니다.
주:엔터티, 연결 및 자격 증명 별칭에 대한 자세한 내용은 다음 문서를 참조하십시오 .
-
그래프 또는 REST 자격 증명 양식의 필드에 내용을 입력합니다.
- 다음으로 이동 연결 및 자격 증명 > 연결을 클릭하고 새로 만들기를 클릭하여 다음 그래프 또는 REST에 대한 HTTP 연결을 생성합니다.
-
양식의 필드에 내용을 입력합니다.
표 4. 연결 양식 필드 설명 이름: 그래프에 대해 선택한 이름 이름: REST에 대해 선택한 이름 자격 증명: 그래프 자격 증명을 선택합니다. 자격 증명: REST 자격 증명 선택 연결 별칭: sn_sp_spoke. 마이크로소프트 셰어처그래프 연결 별칭: sn_sp_spoke. 마이크로소프트 셰어스온라인 연결 URL: https://graph.microsoft.com/v1.0/ 연결 URL: https://<SharePoint 인스턴스의 호스트 URL>/ 도메인: Global 도메인: Global - 양식 헤더를 마우스 오른쪽 단추로 클릭하고 저장을 클릭합니다.
자세한 내용은 Connections and Credentials 및 Create an HTTP(s) connection 문서를 참조하십시오. -
양식의 필드에 내용을 입력합니다.
- 다음으로 이동 Microsoft SharePoint Online > 거주자.
- 새로 만들기를 클릭하여 그래프 또는 REST 연결을 생성합니다.
-
양식의 필드에 내용을 입력합니다.
표 5. 테넌트 연결 양식 필드 설명 이름 선택한 이름입니다. 별칭 그래프의 경우: sn_sp_spoke. 마이크로소프트 셰어처그래프 REST의 경우: sn_sp_spoke. 마이크로소프트 셰어스온라인
SharePoint 루트 URL 루트 URL <SiteName>.sharepoint.com 테넌트 ID 그래프 또는 REST 연결에 테넌트 ID가 필요합니다. 도메인 전역 - 주제 헤더를 마우스 오른쪽 버튼으로 클릭하고 저장을 클릭합니다.
자세한 내용은 , , 및
-
다음으로 이동 시스템 정의 > 인증서 > Microsoft SharePoint Online 인증서.
- Azure AD 포털에서 파일 생성 Java 키 저장소 인증서를 첨부합니다.
자세한 내용은 문서를 참조하십시오.
- 키 스토어 암호를 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 연결 기록을 열고 속성 탭에서 Base64로 인코딩된 인증서 지문을 지정합니다.
주:SharePoint 앱 지문 값은 16진수로 인코딩됩니다. 연결 기록에서 Base64 형식으로 동일하게 인코딩합니다.
-
다음 자격 증명 옵션을 선택합니다.
- ( 그래프의 경우): [자격 증명] 테이블(oauth_2_0_credentials)로 이동하여 그래프를 열고 OAuth 토큰 가져오기를 클릭합니다.
Graph 연결에 대한 OAuth 토큰을 가져오기 위해 생성한 사용자의 자격 증명을 사용하여 인스턴스에 로그인해야 Microsoft SharePoint 합니다. 인스턴스에 자격 증명을 저장합니다.
- ( REST의 경우): [자격 증명] 테이블(oauth_2_0_credentials)로 이동하여 REST를 열고 OAuth 토큰 가져오기를 클릭합니다.
테넌트 관리자 자격 증명으로 인스턴스에 로그인하여 Microsoft SharePoint REST 연결에 대한 OAuth 토큰을 가져와야 합니다. 인스턴스에 자격 증명을 저장합니다. 구성 실패를 방지하려면 자격 증명을 확인합니다.
- ( 그래프의 경우): [자격 증명] 테이블(oauth_2_0_credentials)로 이동하여 그래프를 열고 OAuth 토큰 가져오기를 클릭합니다.
- 저장을 클릭합니다.
-
REST 연결 기록을 열고 속성 탭에서 Base64로 인코딩된 인증서 지문을 지정합니다.
-
신뢰할 수 있는 도메인 테이블(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입니다.
-
제출을 클릭합니다.
자세한 내용은 문서를 참조하십시오.
- 다음 단계를 진행하기 전에 AI 검색 서버 연결을 구성합니다.
Entity View Action Mapper(EVAM) 구성은 버전 32.0에서 직원 센터 프로 기본적으로 사용할 수 있습니다.
EVAM 정의에 대한 자세한 내용은 해당 Create a multi-data source list display in Entity View Action Mapper문서를 참조하십시오Create an EVAM action definition.