기술 자료에 보안 SharePoint 데이터 원본 추가
기술 자료에 보안 클라우드 기반 SharePoint 데이터 원본을 추가하여 Active Directory로 보호할 수 있는 질문과 대답으로 기술 자료를 보강합니다.
기술 자료에 보안 SharePoint 문서를 추가하는 경우 QnA Maker 관리자로서 QnA Maker에 대한 Active Directory 권한을 요청해야 합니다. SharePoint에 접속하기 위해 이 권한이 Active Directory 관리자에서 QnA Maker로 제공되는 경우 다시 제공하지 않아도 됩니다. 동일한 SharePoint 리소스에 있는 경우 기술 자료에 대한 각 후속 문서 추가는 권한 부여가 필요하지 않습니다.
QnA Maker 기술 자료 관리자가 Active Directory 관리자가 아닌 경우에는 Active Directory 관리자와 통신하여 이 프로세스를 완료해야 합니다.
필수 조건
- 클라우드 기반 SharePoint - QnA Maker는 권한에 대해 Microsoft Graph를 사용합니다. SharePoint가 온-프레미스인 경우 Microsoft Graph에서 권한을 확인할 수 없기 때문에 SharePoint에서 추출할 수 없습니다.
- URL 형식 - QnA Maker는 공유를 위해 생성되고
https://\*.sharepoint.com형식인 SharePoint URL만 지원합니다.
기술 자료에 지원되는 파일 형식 추가
SharePoint 사이트에서 지원되는 모든 QnA Maker 파일 형식을 기술 자료에 추가할 수 있습니다. 파일 리소스가 보호되는 경우 사용 권한을 부여해야 할 수 있습니다.
SharePoint 사이트를 사용하는 라이브러리에서 파일의 줄임표 메뉴
...를 선택합니다.파일 URL을 복사합니다.
QnA Maker 포털의 설정 페이지에서 기술 자료에 URL을 추가합니다.
SharePoint 파일이 있는 이미지
파일이 이미지를 포함하는 경우 추출되지 않습니다. 파일이 QnA 쌍으로 추출된 후, QnA Maker 포털에서 이미지를 추가할 수 있습니다.
다음 Markdown 구문을 사용하여 이미지를 추가합니다.
대괄호 [] 안의 텍스트는 이미지에 대해 설명합니다. 괄호 () 안의 URL은 이미지에 대한 직접 링크입니다.
대화형 테스트 패널에서 QnA 쌍을 테스트하면 QnA Maker 포털에서 Markdown 텍스트가 아닌 이미지가 표시됩니다. 이렇게 하면 클라이언트-애플리케이션에서 이미지를 공개적으로 검색할 수 있는지 유효성을 검사합니다.
사용 권한
권한 부여는 SharePoint를 실행하는 서버의 보안 파일이 기술 자료에 추가된 경우에 발생합니다. SharePoint를 설정하는 방법 및 파일을 추가하는 사용자의 권한에 따라 다음과 같은 권한 부여 단계가 필요할 수 있습니다.
- 필요한 추가 단계가 없습니다. 파일을 추가하는 사용자에게 필요한 모든 권한이 있습니다.
- 기술 자료 관리자와 Active Directory 관리자 모두에게 권한 부여 단계가 필요합니다.
아래 나열된 단계를 참조하세요.
기술 자료 관리자: QnA Maker 포털에서 SharePoint 데이터 원본 추가
QnA Maker 관리자가 기술 자료에 보안 SharePoint 문서를 추가하면 기술 자료 관리자는 Active Directory 관리자가 완료해야 하는 사용 권한에 대한 요청을 시작합니다.
요청은 Active Directory 계정에 인증하기 위한 팝업으로 시작합니다.
QnA Maker 관리자가 계정을 선택하면 Microsoft Entra 관리자에게 QnA Maker 앱(QnA Maker 관리자 아님)이 SharePoint 리소스에 액세스할 수 있도록 허용해야 한다는 알림이 표시됩니다. Microsoft Entra 관리자는 이 작업을 모든 SharePoint 리소스에서 수행해야 하지만, 해당 리소스의 모든 문서에서 수행할 필요는 없습니다.
Active Directory 관리자: QnA Maker에 파일 읽기 액세스 권한을 부여합니다.
Active Directory 관리자(QnA Maker 관리자가 아님)는 이 링크를 선택하여 QnA Maker Portal SharePoint 엔터프라이즈 앱에 파일 읽기 권한을 부여함으로, SharePoint 리소스에 액세스 할 수 있는 액세스 권한을 QnA Maker에 부여해야 합니다.
Microsoft Entra 관리 센터에서 액세스 권한 부여
Azure Portal에 로그인합니다.
Microsoft Entra ID>Enterprise 애플리케이션으로 이동합니다.
QnAMakerPortalSharePoint를 검색하고 QnA Maker 앱을 선택합니다.
보안에서 사용 권한으로 이동합니다. 조직에 대한 관리자 동의 부여를 선택합니다.
권한이 있는 로그온 계정을 선택하여 Active Directory에 대한 권한을 부여합니다.
API를 사용하여 SharePoint 데이터 원본 추가
Azure Blob Storage를 사용하여 API를 통해 최신 SharePoint 콘텐츠를 추가하는 방법은 다음과 같습니다.
- SharePoint 파일을 로컬로 다운로드합니다. API를 호출하는 사용자는 SharePoint에 대한 액세스 권한이 있어야 합니다.
- Azure Blob Storage에 업로드합니다. 이렇게 하면 SAS 토큰을 사용하여 보안 공유 액세스가 생성됩니다.
- SAS 토큰을 사용하여 생성된 Blob URL을 QnA Maker API로 전달합니다. 파일에서 질문 및 답변 추출을 허용하려면 URL의 끝에 접미사 파일 유형을 '&ext=pdf' 또는 '&ext=doc'로 추가하여 QnA Maker API로 전달해야 합니다.