View a markdown version of this page

관리자 관리형 설정(서비스 자격 증명) - Amazon Quick
사전 조건설정 개요알려진 제한 사항관리형 연결 관리 및 문제 해결

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

관리자 관리형 설정(서비스 자격 증명)

관리자 관리형 설정을 사용하면 관리자가 인증서 기반 자격 증명을 사용하여AWS KMS 서명 키와 Microsoft Entra ID 앱 등록을 구성합니다. 개별 사용자는 로그인을 통해 권한을 부여할 필요가 없습니다. Amazon Quick은 조직 내 모든 사용자의 OneDrive 콘텐츠를 크롤링합니다.

관리자 관리형 설정에는 기본 제공 문서 수준 액세스 제어 목록(ACL) 지원이 포함됩니다. 관리자 관리형 설정은 모든 사용자의 OneDrive 콘텐츠를 크롤링하므로 ACL은 항상 활성화되며 끌 수 없습니다. Amazon Quick은 각 크롤링 중에 OneDrive의 ACLs 동기화하고 쿼리 시 각 사용자의 권한을 확인하므로 사용자는 액세스 권한이 부여된 문서의 답변만 볼 수 있습니다. 자세한 내용은 문서 수준 액세스 제어 단원을 참조하십시오.

사전 조건

시작하기 전에 다음 사항을 갖췄는지 확인하세요.

  • Amazon Quick Admin 콘솔에 대한 관리자 액세스 권한.

  • Microsoft Entra ID에 대한 관리자 액세스 권한으로 애플리케이션을 등록하고 API 권한을 부여합니다.

  • 인덱싱할 OneDrive 콘텐츠가 있는 Microsoft 365 테넌트입니다.

설정 개요

설정에는 다음 단계가 포함됩니다.

  1. 서비스 자격 증명 설정 - KMS 서명 키를 생성하고, 인증서를 생성하고, Entra에 애플리케이션을 등록하고, Amazon Quick에 키를 사용할 수 있는 권한을 부여합니다. 자세한 내용은 서비스 자격 증명 설정 단원을 참조하십시오.

  2. Amazon Quick에서 지식 기반 생성 - 1단계의 서비스 자격 증명을 사용하여 OneDrive 지식 기반을 생성합니다. 자세한 내용은 Amazon Quick에서 지식 기반 생성 단원을 참조하십시오.

문서 수준 액세스 제어는 모든 관리자 관리형 지식 기반에 대해 자동으로 활성화됩니다. 액세스 제어의 작동 방식에 대한 자세한 내용은 섹션을 참조하세요문서 수준 액세스 제어.

알려진 제한 사항

  • OneNote 파일은 관리자 관리형 설정에서 크롤링되지 않습니다. Microsoft는 2025년 3월 31일에 OneNote APIs에 대한 앱 전용 토큰을 사용 중지했습니다. OneNote 콘텐츠를 인덱싱하려면를 사용합니다사용자 관리형 설정.

  • 공유 폴더는 크롤링되지 않습니다. 사용자와 공유된 폴더는 SharePoint에 저장되며 관리자 관리형 설정에 사용되는 애플리케이션 자격 증명으로 액세스할 수 없습니다. 공유 콘텐츠를 동기화하려면를 생성하는 것이 좋습니다Microsoft SharePoint 지식 기반 통합.

관리형 연결 관리 및 문제 해결

통합을 편집, 공유 또는 삭제하려면 섹션을 참조하세요기존 통합 관리.

  • KMS 키에 액세스할 수 없음 - KMS 키 ARN 및 리전을 확인합니다. 계정, AWS리소스, Key AWS Management Service 관리 아래의 Amazon Quick Admin 콘솔에서 KMS 키가 추가되었는지 확인합니다. 키가 활성화되어 있고 삭제가 예약되지 않았는지 확인합니다. 다중 리전 키는 현재 지원되지 않습니다.

  • 인증서 검증 실패 - 인증서 생성 단계의 base64url 인코딩 SHA-1 값을 사용하여 지문을 확인합니다. Entra에 업로드된 인증서가 만료되지 않았는지 확인합니다.

  • ACL이 적용되지 않음 - Microsoft Graph에서 Entra 앱GroupMember.Read.All에 Files.Read.All, Sites.Read.All, Group.Read.All, 및 User.Read.All가 있는지 확인합니다. 권한을 수정한 후 전체 동기화를 다시 실행합니다. 문서 액세스 확인에 대한 자세한 내용은 섹션을 참조하세요문서 액세스 확인(ACL 확인).

  • 크롤링된 항목 0개 - 동기화가 완료되었지만 인덱싱된 문서가 없습니다. 이는 일반적으로 권한 문제를 나타냅니다. Amazon Quick이 SharePoint에서 호스팅되는 OneDrive 드라이브를 열거할 수 Sites.Read.All 있도록 Entra 앱에를 포함하여 올바른 API 권한이 있는지 확인합니다. 또한 사용자에게 OneDrive 콘텐츠가 있고 관리자 동의가 부여되었는지 확인합니다.

  • 인증서 만료 후 동기화 실패 - 동일한 데이터 소스 연결을 공유하는 여러 지식 기반에서 동기화가 실패하면 Entra에 업로드된 인증서가 만료되었을 수 있습니다. 새 인증서를 생성하고( 참조2단계: 자체 서명된 인증서 생성) Entra 앱 등록에 업로드한 다음 연결 세부 정보를 업데이트합니다. Amazon Quick 관리자는 원래 생성자를 사용할 수 없는 경우 자산 관리를 통해 데이터 소스 소유권을 재할당할 수 있습니다. 자세한 내용은 데이터 소스 연결 공유 단원을 참조하십시오.

  • ACL 지원 지식 기반에서 결과 없음 - 사용자가 관리자 관리형 지식 기반에서 결과를 받지 못하면 실시간 ACL 애플리케이션에 대한 관리자 동의가 부여되지 않았을 수 있습니다. 테넌트가 사용자 동의를 차단할 수도 있습니다. Amazon Quick 콘솔에 제공된 링크를 사용하여 관리자 동의를 부여하거나 섹션을 참조하세요관리자 동의.

동기화 모니터링, 보고서 및 ACL 확인을 포함한 추가 문제 해결은 섹션을 참조하세요OneDrive 지식 기반 문제 해결.