이 문서에서는 SharePoint와 Knowledge Base를 연동하기 위해 다음 작업을 진행합니다.1.
Microsoft Entra ID에 연동용 애플리케이션 등록
2.
SharePoint 문서와 권한을 조회하기 위한 API 권한 설정
5.
연동할 SharePoint 사이트 URL 확인
6.
확인한 정보를 Knowledge Base에 입력
1. 연동 전 확인 사항#
SharePoint 연동을 진행하려면 다음 권한과 정보가 필요합니다.(1) 필요한 관리자 권한#
Microsoft Entra ID에 애플리케이션을 등록하고 API 권한에 대한 관리자 동의를 진행할 수 있는 담당자가 필요합니다.조직의 보안 정책에 따라 애플리케이션 등록 담당자와 SharePoint 관리자의 협조가 필요할 수 있습니다.(2) 연동에 필요한 정보#
연동 과정에서 다음 정보를 생성하거나 확인합니다.| 항목 | 설명 |
|---|
| 클라이언트 ID | Microsoft Entra ID에 등록한 애플리케이션의 식별자 |
| 테넌트 ID | 회사의 Microsoft Entra 테넌트 식별자 |
| 연결 인증서 | 등록한 애플리케이션이 인증할 때 사용하는 인증서. Knowledge Base에서 발급하거나 보유한 인증서를 업로드합니다 |
| SharePoint 사이트 URL | Knowledge Base에 연결할 SharePoint 사이트의 주소 |
새로 연동하는 SharePoint는 클라이언트 시크릿 대신 인증서로 연결합니다. 인증서로 연결해야 SharePoint의 문서 권한을 Knowledge Base 검색에 적용할 수 있습니다.
이미 클라이언트 시크릿으로 연동한 SharePoint는 그대로 사용할 수 있습니다.
SharePoint 연동하기#
1. Microsoft Entra ID에 애플리케이션 등록하기#
2.
Microsoft Entra ID로 이동합니다.
5.
애플리케이션 이름과 지원되는 계정 유형을 입력한 후 애플리케이션을 등록합니다.
애플리케이션 이름은 관리자가 용도를 쉽게 식별할 수 있도록 STORM Knowledge Base와 같이 작성하는 것을 권장합니다.
2. SharePoint 접근 권한 설정하기#
등록한 애플리케이션이 SharePoint 문서와 문서 권한을 조회할 수 있도록 API 권한을 설정합니다.1.
등록한 애플리케이션의 API 권한 메뉴로 이동합니다.
2. 권한 추가를 선택합니다.
3. Microsoft Graph의 애플리케이션 권한을 선택합니다.4.
SharePoint의 애플리케이션 권한을 선택합니다.
5.
조직 관리자가 추가한 권한에 대해 관리자 동의를 진행합니다.
GroupMember.Read.All과 User.Read.All은 SharePoint 문서를 볼 수 있는 사용자와 그룹을 확인하는 데 사용합니다.
3. 연결 인증서 발급하고 애플리케이션에 등록하기#
Knowledge Base에서 연결 인증서를 만든 후, 등록한 애플리케이션에 업로드합니다.1.
STORM Knowledge Base의 소스 화면에서 SharePoint 인증 서 탭으로 이동합니다.
3.
인증서 이름을 입력하고 만드는 방법을 선택한 후 만들기를 선택합니다.
새로 발급: 새 인증서를 발급합니다. 개인 키는 STORM에 안전하게 보관되며, 애플리케이션에 등록할 인증서 파일만 다운로드합니다.
보유한 인증서 업로드: 회사 정책상 자체 인증서를 사용해야 하는 경우 인증서 파일(.cer, .pem)과 개인 키 파일(.key, .pem)을 업로드합니다.
5.
Azure Portal에서 등록한 애플리케이션의 인증서 및 암호 메뉴로 이동합니다.
6.
인증서 탭에서 인증서 업로드를 선택한 후, 다운로드한 인증서 파일을 업로드합니다.
Azure Portal에 표시된 인증서의 지문이 Knowledge Base 인증서 상세 화면의 지문과 같으면 올바르게 등록된 것입니다.
인증서의 만료일이 지나면 SharePoint 동기화가 중단될 수 있습니다. 만료 전에 인증서를 교체하는 방법은 하단의 인증서 관리하기를 참고해주세요.
4. 클라이언트 ID와 테넌트 ID 확인하기#
등록한 애플리케이션의 개요 화면으로 이동하여 다음 값을 확인합니다.확인한 값은 Knowledge Base 연동 화면의 클라이언트 ID와 테넌트 ID 항목에 각각 입력합니다.5. SharePoint 사이트 URL 확인하기#
Knowledge Base에 연결할 SharePoint 사이트에 접속한 후, 브라우저 주소창의 URL을 그대로 복사합니다.특정 폴더만 연동하려면 해당 폴더의 URL을 입력합니다. 입력한 폴더와 하위 폴더의 문서만 수집합니다. 서브사이트와 개인 SharePoint 사이트는 지원하지 않습니다.
6. Knowledge Base에 연동 정보 입력하기#
STORM Knowledge Base의 소스 연결에서 SharePoint를 선택한 후, 앞서 확인한 정보를 입력합니다.연결 인증서: 3단계에서 애플리케이션에 업로드한 인증서를 선택합니다. 클라이언트 ID를 먼저 입력하면 해당 애플리케이션에 등록된 인증서를 추천합니다.
문서 공개 범위: SharePoint 권한 따르기(권장) 또는 전체 공개를 선택합니다. 자세한 내용은 하단의 문서 권한 설정을 참고해주세요.
연동 화면에서 바로 새 인증서를 발급하거나 업로드할 수도 있습니다. 이 경우에도 3단계와 같이 인증서를 애플리케이션에 업로드한 후 연결 테스트를 진행해주세요.
7. 연동 상태 확인하기#
연동이 완료되면 Knowledge Base에서 SharePoint의 폴더와 문서를 확인할 수 있습니다.최초 연동 시 문서의 수와 용량에 따라 수집과 학습에 시간이 걸릴 수 있습니다. 문서는 수집된 후 파싱과 인덱싱 과정을 거쳐 에이전트가 검색할 수 있는 상태로 전환됩니다.문서 공개 범위를 SharePoint 권한 따르기로 설정한 경우, SharePoint의 권한 정보를 가져오는 동안에는 해당 소스의 문서가 검색되지 않습니다.이후 SharePoint에서 발생한 문서의 추가·수정·이동·삭제 사항은 설정된 동기화 주기에 따라 Knowledge Base에 반영됩니다.연동에 실패한 경우 다음 항목을 확인해 주세요.테넌트 ID와 클라이언트 ID가 올바른지 확인해주세요
연결 인증서가 애플리케이션의 인증서 및 암호에 업로드되었는지, 만료되지 않았는지 확인해주세요
SharePoint 사이트 URL이 지정된 형식에 맞는지 확인해주세요
애플리케이션에 필요한 API 권한과 관리자 동의가 적용되었는지 확인해주세요
문서 권한 설정#
1. 문서 공개 범위 선택하기#
Knowledge Base는 SharePoint에 설정된 문서 권한을 검색 결과에 그대로 적용할 수 있습니다. 공개 범위는 소스마다 선택합니다.| 공개 범위 | 설명 |
|---|
| SharePoint 권한 따르기(권장) | SharePoint에서 문서를 볼 수 있는 사람에게만 검색 결과로 보여 줍니다 |
| 전체 공개 | 소스의 모든 문서를 SharePoint 권한과 관계없이 누구에게나 검색 결과로 보여 줍니다 |
문서 권한은 현재 Teams에서 질문할 때 적용됩니다.
Teams 외의 화면이나 API에서는 공개 범위와 관계없이 소스의 모든 문서가 검색됩니다.
SharePoint에서 문서의 공유 대상이나 그룹 구성원을 변경하면 보통 몇 분 안에 검색 결과에 반영됩니다.
소스 목록의 공개 범위 열에서 소스별 설정을 확인할 수 있습니다.
SharePoint 권한 따르기에서 전체 공개로 변경하면 SharePoint에서 일부 사람만 볼 수 있던 문서도 누구에게나 검색됩니다. 변경 전에 확인 창이 표시됩니다.
소스에 권한 수집 오류가 표시되면 SharePoint 권한 정보를 모두 가져오지 못한 상태입니다. 이 경우 일부 문서가 Teams 검색 결과에서 제외될 수 있으므로 연결 인증서와 애플리케이션의 API 권한을 확인해주세요.
2. 기존 소스에 문서 권한 적용하기#
클라이언트 시크릿으로 연동한 기존 소스는 공개 범위가 전체 공개로 설정되어 있으며, 이전과 동일하게 검색됩니다. 문서 권한을 적용하려면 다음 순서로 진행합니다.1.
2단계를 참고하여 애플리케이션에 API 권한을 추가하고 관리자 동의를 진행합니다.
2.
3단계를 참고하여 연결 인증서를 만들고 애플리케이션에 업로드합니다.
3.
Knowledge Base 소스 목록에서 해당 소스의 수정을 선택합니다.
4.
**연결 인증서(선택)**에서 업로드한 인증서를 선택합니다.
5.
문서 공개 범위를 SharePoint 권한 따르기로 변경합니다.
인증서만 연결하면 공개 범위는 변경되지 않습니다. 5번까지 진행해야 문서 권한이 적용됩니다.
3. 인증서 관리하기#
SharePoint 인증서 탭에서 인증서의 만료일과 사용 중인 소스를 확인할 수 있습니다.만료일 30일 전부터 곧 만료, 만료일이 지나면 만료됨으로 표시됩니다.
인증서를 교체하려면 새 인증서를 만들어 애플리케이션에 업로드한 후, 소스 수정에서 새 인증서를 선택합니다. 교체가 끝나면 이전 인증서를 삭제합니 다.
소스에서 사용 중인 인증서는 삭제할 수 없습니다.
