OAuth 2.0 ROPC 흐름 인증 방법을 사용하여 Amazon Q Business를 SharePoint(온라인)와 통합

기업은 조직의 다양한 시스템에 분산된 방대한 양의 정보에 액세스하고 이를 활용하는 데 있어 심각한 문제에 직면해 있습니다. 개별 사용자의 데이터 액세스 수준을 고려하면서 단순히 질문을 하고 회사의 전체 지식 기반에서 즉각적이고 정확한 답변을 얻을 수 있다면 어떨까요?

Enterprises face significant challenges accessing and utilizing the vast amounts of information scattered across an organization’s various systems. What if you could simply ask a question and get instant, accurate answers from your company’s entire knowledge base, while accounting for an individual user’s data access levels?

기업은 조직의 다양한 시스템에 분산된 방대한 양의 정보에 액세스하고 이를 활용하는 데 있어 심각한 문제에 직면해 있습니다. 개별 사용자의 데이터 액세스 수준을 고려하면서 단순히 질문을 하고 회사의 전체 지식 기반에서 즉각적이고 정확한 답변을 얻을 수 있다면 어떨까요?

Amazon Q Business is a game changing AI assistant that’s revolutionizing how enterprises interact with their data. With Amazon Q Business, you can access relevant information through natural language conversations, drawing insights from diverse data sources within your organization, adhering to the permissions granted to your user account.

Amazon Q Business는 기업이 데이터와 상호 작용하는 방식을 혁신하는 획기적인 AI 도우미입니다. Amazon Q Business를 사용하면 자연어 대화를 통해 관련 정보에 액세스하고, 조직 내의 다양한 데이터 소스에서 통찰력을 얻고, 사용자 계정에 부여된 권한을 준수할 수 있습니다.

At its core, Amazon Q Business works by first indexing the content from a variety of data sources using built-in data source connectors. These connectors function as an integration layer, unifying content from diverse systems such as Salesforce, Microsoft Exchange, and SharePoint into a centralized index. This consolidated index powers the natural language processing and response generation capabilities of Amazon Q. When a user asks a question using the built-in web experience, Amazon Q Business retrieves relevant content from the index, taking into account user profiles and permissions. It then uses large language models (LLMs) to provide accurate, personalized, and well-written responses based on the consolidated data.

기본적으로 Amazon Q Business는 내장된 데이터 원본 커넥터를 사용하여 다양한 데이터 원본의 콘텐츠를 먼저 인덱싱하는 방식으로 작동합니다. 이러한 커넥터는 Salesforce, Microsoft Exchange 및 SharePoint와 같은 다양한 시스템의 콘텐츠를 중앙 집중식 인덱스로 통합하는 통합 계층의 역할을 합니다. 이 통합 인덱스는 Amazon Q의 자연어 처리 및 응답 생성 기능을 강화합니다. 사용자가 내장된 웹 경험을 사용하여 질문하면 Amazon Q 비즈니스는 사용자 프로필 및 권한을 고려하여 인덱스에서 관련 콘텐츠를 검색합니다. 그런 다음 LLM(대형 언어 모델)을 사용하여 통합된 데이터를 기반으로 정확하고 개인화되었으며 잘 작성된 응답을 제공합니다.

For a full list of Amazon Q supported data source connectors, refer to Supported connectors.

Amazon Q에서 지원하는 데이터 원본 커넥터의 전체 목록은 지원되는 커넥터를 참조하세요.

This approach is useful when you need Amazon Q Business to crawl through OneNote or if you don’t want to deal with certificates or in scenarios that require regular password rotation.

이 접근 방식은 OneNote를 통해 크롤링하기 위해 Amazon Q Business가 필요한 경우 또는 인증서를 처리하고 싶지 않거나 정기적인 암호 교체가 필요한 시나리오에서 유용합니다.

We provide a step-by-step guide for the Azure AD configuration and demonstrate how to set up the Amazon Q connector to establish this secure integration.

Azure AD 구성에 대한 단계별 가이드를 제공하고 Amazon Q 커넥터를 설정하여 이러한 보안 통합을 설정하는 방법을 보여줍니다.

Solution overview

솔루션 개요

SharePoint is a web-based solution developed by Microsoft that enables organizations to collaborate, manage documents, and share information efficiently. It offers a wide range of features, including using document libraries, viewing lists, publishing pages, sharing events and links, and allowing users to make comments, making it a great tool for team collaboration and content management.

SharePoint는 조직이 효율적으로 공동 작업하고, 문서를 관리하고, 정보를 공유할 수 있도록 Microsoft에서 개발한 웹 기반 솔루션입니다. 문서 라이브러리 사용, 목록 보기, 페이지 게시, 이벤트 및 링크 공유, 사용자 댓글 허용 등 다양한 기능을 제공하므로 팀 공동 작업 및 콘텐츠 관리를 위한 훌륭한 도구입니다.

After integrating SharePoint Online with Amazon Q Business, you can ask questions using natural language about the content stored in the SharePoint sites. For example, if your organization’s human resources team manages an internal SharePoint site and maintains a list of holidays for geographical regions, you can ask, “What are the company holidays for this year?” Amazon Q Business will then list region-specific holidays based on your location (country).

SharePoint Online을 Amazon Q Business와 통합한 후에는 SharePoint 사이트에 저장된 콘텐츠에 대해 자연어를 사용하여 질문할 수 있습니다. 예를 들어 조직의 인사팀이 내부 SharePoint 사이트를 관리하고 지역별 휴일 목록을 유지 관리하는 경우 "올해 회사 휴일은 언제입니까?"라고 질문할 수 있습니다. 그러면 Amazon Q Business는 귀하의 위치(국가)를 기준으로 지역별 공휴일을 나열합니다.

The following diagram illustrates the solution architecture. In the upcoming sections, we show you how to implement this architecture. After you integrate Amazon Q Business using the SharePoint connector, Amazon Q Business will crawl through the SharePoint content and update the index whenever content changes. Each published event, page, link, file, comment, OneNote, and attachment on the SharePoint site is treated as a document. In addition to the documents, it also crawls through access control lists (ACLs) for each document (user and group information) and stores them in the . This allows end-users to see chat responses generated only from the documents they have access to.

다음 다이어그램은 솔루션 아키텍처를 보여줍니다. 다음 섹션에서는 이 아키텍처를 구현하는 방법을 보여줍니다. SharePoint 커넥터를 사용하여 Amazon Q Business를 통합하면 Amazon Q Business는 SharePoint 콘텐츠를 크롤링하고 콘텐츠가 변경될 때마다 인덱스를 업데이트합니다. SharePoint 사이트에 게시된 각 이벤트, 페이지, 링크, 파일, 댓글, OneNote 및 첨부 파일은 문서로 처리됩니다. 문서 외에도 각 문서(사용자 및 그룹 정보)에 대한 ACL(액세스 제어 목록)을 크롤링하여 . 이를 통해 최종 사용자는 액세스 권한이 있는 문서에서만 생성된 채팅 응답을 볼 수 있습니다.

You can configure Azure AD using either of the following methods:

다음 방법 중 하나를 사용하여 Azure AD를 구성할 수 있습니다.

We demonstrate both methods in the following sections.

다음 섹션에서는 두 가지 방법을 모두 보여줍니다.

Prerequisites

전제 조건

To follow along, you need the following prerequisites:

계속하려면 다음 전제 조건이 필요합니다.

Configure Azure AD using the Azure AD console

Azure AD 콘솔을 사용하여 Azure AD 구성

To configure Azure AD using the GUI, complete the steps in this section.

GUI를 사용하여 Azure AD를 구성하려면 이 섹션의 단계를 완료하세요.

Register an Azure AD application

Azure AD 애플리케이션 등록

Complete the following steps to register an Azure AD application in the Azure AD tenant that is linked to the SharePoint Online/O365 tenant:

SharePoint Online/O365 테넌트에 연결된 Azure AD 테넌트에 Azure AD 애플리케이션을 등록하려면 다음 단계를 완료하세요.

An application will be created. You will see a page like the following screenshot.

애플리케이션이 생성됩니다. 다음 스크린샷과 같은 페이지가 나타납니다.

Now you can configure the newly registered application with Microsoft Graph and SharePoint API permissions.

이제 Microsoft Graph 및 SharePoint API 권한으로 새로 등록된 애플리케이션을 구성할 수 있습니다.

When configuring permissions, you have two different options:

권한을 구성할 때 다음 두 가지 옵션이 있습니다.

For option 1, install the MS Graph PowerShell SDK as a prerequisite.

옵션 1의 경우 MS Graph PowerShell SDK를 필수 구성 요소로 설치합니다.

Option 1: Manually allow access to specific SharePoint sites

옵션 1: 특정 SharePoint 사이트에 대한 액세스를 수동으로 허용

If you choose option 1, to grant access to specific sites instead of all sites, you need to complete additional prerequisites.

옵션 1을 선택하는 경우 모든 사이트가 아닌 특정 사이트에 대한 액세스 권한을 부여하려면 추가 전제 조건을 완료해야 합니다.

Make sure you have access to another application in Microsoft Entra ID with Sites.FullControl.All application-level permissions, along with its client ID and client secret. This application won’t be used by the Amazon Q Business connector, but it’s needed to grant Sites.Selected permissions only to the application you just registered. If you don’t have access to an application with Sites.FullControl permissions, you can follow the previous steps to register a new application and grant Sites.FullControl as described in option 2. We refer to this application as SitesFullControlApp.

클라이언트 ID 및 클라이언트 암호와 함께 Sites.FullControl.All 애플리케이션 수준 권한을 사용하여 Microsoft Entra ID의 다른 애플리케이션에 액세스할 수 있는지 확인하세요. 이 애플리케이션은 Amazon Q 비즈니스 커넥터에서 사용되지 않지만 방금 등록한 애플리케이션에만 Sites.Selected 권한을 부여하는 데 필요합니다. Sites.FullControl 권한이 있는 애플리케이션에 액세스할 수 없는 경우 이전 단계에 따라 새 애플리케이션을 등록하고 옵션 2에 설명된 대로 Sites.FullControl을 부여할 수 있습니다. 이 애플리케이션을 SitesFullControlApp이라고 합니다.

To configure your permissions using option 1, complete the following steps:

옵션 1을 사용하여 권한을 구성하려면 다음 단계를 완료하세요.

You will see the permissions listed as shown in the following screenshot.

다음 스크린샷과 같이 권한이 나열된 것을 볼 수 있습니다.

After granting admin consent, your permissions should look like the following screenshot.

관리자 동의를 부여한 후 권한은 다음 스크린샷과 같아야 합니다.

The output from the PowerShell script will look like the following screenshot.

PowerShell 스크립트의 출력은 다음 스크린샷과 같습니다.

This completes the steps to configure permissions for a specific set of SharePoint site collections.

이로써 특정 SharePoint 사이트 모음 집합에 대한 권한을 구성하는 단계가 완료되었습니다.

Option 2: Manually allow

옵션 2: 수동으로 허용