Integrieren Sie Amazon Q Business mit SharePoint (Online) mithilfe der OAuth 2.0 ROPC-Flow-Authentifizierungsmethode

Unternehmen stehen vor erheblichen Herausforderungen beim Zugriff auf und der Nutzung der riesigen Informationsmengen, die über die verschiedenen Systeme des Unternehmens verstreut sind. Was wäre, wenn Sie einfach eine Frage stellen und sofort genaue Antworten aus der gesamten Wissensdatenbank Ihres Unternehmens erhalten könnten, während Sie gleichzeitig die Datenzugriffsebenen eines einzelnen Benutzers berücksichtigen könnten?

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?

Unternehmen stehen vor erheblichen Herausforderungen beim Zugriff auf und der Nutzung der riesigen Informationsmengen, die über die verschiedenen Systeme einer Organisation verstreut sind. Was wäre, wenn Sie einfach eine Frage stellen und sofort genaue Antworten aus der gesamten Wissensdatenbank Ihres Unternehmens erhalten könnten, während Sie gleichzeitig die Datenzugriffsebenen eines einzelnen Benutzers berücksichtigen könnten?

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 ist ein bahnbrechender KI-Assistent, der die Art und Weise, wie Unternehmen mit ihren Daten interagieren, revolutioniert. Mit Amazon Q Business können Sie über Gespräche in natürlicher Sprache auf relevante Informationen zugreifen und Erkenntnisse aus verschiedenen Datenquellen innerhalb Ihres Unternehmens gewinnen und dabei die Ihrem Benutzerkonto gewährten Berechtigungen einhalten.

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.

Im Kern funktioniert Amazon Q Business, indem es zunächst den Inhalt verschiedener Datenquellen mithilfe integrierter Datenquellenkonnektoren indiziert. Diese Konnektoren fungieren als Integrationsschicht und vereinen Inhalte aus verschiedenen Systemen wie Salesforce, Microsoft Exchange und SharePoint in einem zentralen Index. Dieser konsolidierte Index unterstützt die Funktionen zur Verarbeitung natürlicher Sprache und zur Antwortgenerierung von Amazon Q. Wenn ein Benutzer mithilfe der integrierten Web-Erfahrung eine Frage stellt, ruft Amazon Q Business relevante Inhalte aus dem Index ab und berücksichtigt dabei Benutzerprofile und Berechtigungen. Anschließend werden große Sprachmodelle (LLMs) verwendet, um auf der Grundlage der konsolidierten Daten genaue, personalisierte und gut geschriebene Antworten bereitzustellen.

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

Eine vollständige Liste der von Amazon Q unterstützten Datenquellen-Konnektoren finden Sie unter Unterstützte Konnektoren.

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.

Dieser Ansatz ist nützlich, wenn Sie Amazon Q Business zum Crawlen durch OneNote benötigen oder wenn Sie sich nicht mit Zertifikaten befassen möchten oder in Szenarien, die eine regelmäßige Passwortrotation erfordern.

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.

Wir bieten eine Schritt-für-Schritt-Anleitung für die Azure AD-Konfiguration und zeigen, wie Sie den Amazon Q-Connector einrichten, um diese sichere Integration herzustellen.

Solution overview

Lösungsübersicht

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 ist eine von Microsoft entwickelte webbasierte Lösung, die es Unternehmen ermöglicht, effizient zusammenzuarbeiten, Dokumente zu verwalten und Informationen auszutauschen. Es bietet eine breite Palette an Funktionen, darunter die Verwendung von Dokumentbibliotheken, das Anzeigen von Listen, das Veröffentlichen von Seiten, das Teilen von Ereignissen und Links sowie die Möglichkeit für Benutzer, Kommentare abzugeben, was es zu einem großartigen Tool für die Teamzusammenarbeit und Inhaltsverwaltung macht.

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).

Nach der Integration von SharePoint Online mit Amazon Q Business können Sie in natürlicher Sprache Fragen zu den auf den SharePoint-Sites gespeicherten Inhalten stellen. Wenn das Personalteam Ihrer Organisation beispielsweise eine interne SharePoint-Website verwaltet und eine Liste der Feiertage für geografische Regionen verwaltet, können Sie fragen: „Welche Betriebsferien gibt es in diesem Jahr?“ Amazon Q Business listet dann regionalspezifische Feiertage basierend auf Ihrem Standort (Land) auf.

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.

Das folgende Diagramm veranschaulicht die Lösungsarchitektur. In den kommenden Abschnitten zeigen wir Ihnen, wie Sie diese Architektur implementieren. Nachdem Sie Amazon Q Business über den SharePoint-Connector integriert haben, durchsucht Amazon Q Business den SharePoint-Inhalt und aktualisiert den Index, wenn sich der Inhalt ändert. Jedes veröffentlichte Ereignis, jede Seite, jeder Link, jede Datei, jeder Kommentar, jedes OneNote und jeder Anhang auf der SharePoint-Website wird als Dokument behandelt. Zusätzlich zu den Dokumenten durchsucht es auch Zugriffskontrolllisten (ACLs) für jedes Dokument (Benutzer- und Gruppeninformationen) und speichert sie im . Dadurch können Endbenutzer Chat-Antworten sehen, die nur aus den Dokumenten generiert wurden, auf die sie Zugriff haben.

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

Sie können Azure AD mit einer der folgenden Methoden konfigurieren:

We demonstrate both methods in the following sections.

Wir demonstrieren beide Methoden in den folgenden Abschnitten.

Prerequisites

Voraussetzungen

To follow along, you need the following prerequisites:

Um mitmachen zu können, benötigen Sie folgende Voraussetzungen:

Configure Azure AD using the Azure AD console

Konfigurieren Sie Azure AD mit der Azure AD-Konsole

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

Um Azure AD über die GUI zu konfigurieren, führen Sie die Schritte in diesem Abschnitt aus.

Register an Azure AD application

Registrieren Sie eine Azure AD-Anwendung

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

Führen Sie die folgenden Schritte aus, um eine Azure AD-Anwendung im Azure AD-Mandanten zu registrieren, der mit dem SharePoint Online/O365-Mandanten verknüpft ist:

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

Es wird ein Antrag erstellt. Sie sehen eine Seite wie im folgenden Screenshot.

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

Jetzt können Sie die neu registrierte Anwendung mit Microsoft Graph- und SharePoint-API-Berechtigungen konfigurieren.

When configuring permissions, you have two different options:

Beim Konfigurieren von Berechtigungen haben Sie zwei verschiedene Möglichkeiten:

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

Installieren Sie für Option 1 das MS Graph PowerShell SDK als Voraussetzung.

Option 1: Manually allow access to specific SharePoint sites

Option 1: Zugriff auf bestimmte SharePoint-Websites manuell zulassen

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

Wenn Sie Option 1 wählen, um Zugriff auf bestimmte Sites statt auf alle Sites zu gewähren, müssen Sie zusätzliche Voraussetzungen erfüllen.

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.

Stellen Sie sicher, dass Sie Zugriff auf eine andere Anwendung in Microsoft Entra ID mit Sites.FullControl.All-Berechtigungen auf Anwendungsebene sowie deren Client-ID und Client-Geheimnis haben. Diese Anwendung wird nicht vom Amazon Q Business-Connector verwendet, ist jedoch erforderlich, um Sites.Selected-Berechtigungen nur für die Anwendung zu erteilen, die Sie gerade registriert haben. Wenn Sie keinen Zugriff auf eine Anwendung mit Sites.FullControl-Berechtigungen haben, können Sie die vorherigen Schritte ausführen, um eine neue Anwendung zu registrieren und Sites.FullControl wie in Option 2 beschrieben zu gewähren. Wir bezeichnen diese Anwendung als SitesFullControlApp.

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

Um Ihre Berechtigungen mit Option 1 zu konfigurieren, führen Sie die folgenden Schritte aus:

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

Die Berechtigungen werden wie im folgenden Screenshot aufgeführt angezeigt.

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

Nachdem Sie die Administratoreinwilligung erteilt haben, sollten Ihre Berechtigungen wie im folgenden Screenshot aussehen.

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

Die Ausgabe des PowerShell-Skripts sieht wie im folgenden Screenshot aus.

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

Damit sind die Schritte zum Konfigurieren von Berechtigungen für einen bestimmten Satz von SharePoint-Websitesammlungen abgeschlossen.

Option 2: Manually allow

Option 2: Manuell zulassen