SharePoint Microsoft-Aktionsintegration

Verwenden Sie den Microsoft SharePoint Action Connector, um Listen, Elemente, Dateien und Excel-Arbeitsmappen direkt in Amazon Quick in natürlicher Sprache zu verwalten.

Die Einrichtung dieser Integration umfasst zwei Schritte. Zunächst registrieren Sie eine Anwendung in Microsoft Entra und konfigurieren ihre Berechtigungen. Anschließend erstellen Sie die Integration in Amazon Quick und verbinden sie mit Ihrer Entra-App. Informationen zu den Authentifizierungsmethoden, die Amazon Quick unterstützt, finden Sie unterAuthentifizierungsmethoden.

Bevor Sie beginnen

Stellen Sie sicher, dass Sie über Folgendes verfügen, bevor Sie die Integration einrichten.

• Ein Microsoft 365-Konto mit SharePoint Zugriff.

• Zugriff auf das Microsoft Entra Admin Center mit mindestens Anwendungsentwicklerberechtigungen.

• Informationen zu den Abonnementanforderungen finden Sie unterIntegrationen in der Konsole einrichten.

Microsoft Entra konfigurieren

Bevor Sie Amazon Quick konfigurieren, erstellen Sie eine App-Registrierung in Microsoft Entra. Führen Sie alle folgenden Schritte in Entra aus, bevor Sie zur Amazon Quick-Konsole wechseln.

Weitere Informationen zu App-Registrierungen finden Sie in der Microsoft-Dokumentation unter Registrieren einer Anwendung bei der Microsoft Identity Platform.

Registrieren Sie die Anwendung

1. Öffnen Sie das Microsoft Entra Admin Center.

2. Wählen Sie in der linken Navigationsleiste Entra ID und dann App-Registrierungen aus.

3. Wählen Sie Neue Registrierung.

4. Geben Sie unter Name einen aussagekräftigen Namen für Ihre Integration ein.

5. Wählen Sie für Unterstützte Kontotypen die Option Nur Konten in diesem Organisationsverzeichnis aus.

6. Wählen Sie für Umleitungs-URI die Option Web aus und geben Sie einhttps://{region}.quicksight.aws.amazon.com/sn/oauthcallback. {region}Ersetzen Sie durch die AWS Region, in der Ihre Amazon Quick-Instance bereitgestellt wird.

7. Wählen Sie Registrieren aus.

8. Kopieren Sie auf der Übersichtsseite die Anwendungs-ID (Client) und die Verzeichnis-ID (Mandant). Sie benötigen diese Werte für die Amazon Quick-Konfiguration.

Erstellen Sie einen geheimen Client-Schlüssel

Amazon Quick benötigt ein Client-Geheimnis, um sich bei Microsoft Entra zu authentifizieren. Dieses Geheimnis dient als Passwort für die App-Registrierung.

1. Wählen Sie in Ihrer App-Registrierung die Option Zertifikate und Geheimnisse aus.

2. Wählen Sie Neues geheimes Kundenkonto aus.

3. Geben Sie eine Beschreibung ein und wählen Sie einen Ablaufzeitraum.

4. Wählen Sie Hinzufügen aus.

5. Kopieren Sie den Wert sofort. Dieser Wert wird nur einmal angezeigt.

Wichtig

Kopieren Sie den geheimen Wert, nicht die geheime ID. Der Wert ist die längere Zeichenfolge, die für die Authentifizierung verwendet wird.

API-Berechtigungen konfigurieren

Microsoft Graph unterstützt zwei Berechtigungstypen für diese Integration. Delegierte Berechtigungen ermöglichen es der App, im Namen eines angemeldeten Benutzers zu handeln. Anwendungsberechtigungen ermöglichen es der App, auch ohne einen angemeldeten Benutzer zu agieren. Weitere Informationen finden Sie in der Microsoft-Dokumentation unter Überblick über Microsoft Graph-Berechtigungen.

1. Wählen Sie in Ihrer App-Registrierung die Option API-Berechtigungen aus.

2. Wählen Sie „Berechtigung hinzufügen“ und anschließend „Microsoft Graph“.

3. Wählen Sie je nach Ihrer Authentifizierungsmethode Delegierte Berechtigungen oder Anwendungsberechtigungen aus und fügen Sie die Berechtigungen aus der entsprechenden Tabelle unten hinzu.

4. Wählen Sie Administratorzustimmung erteilen für [Ihren Mandantennamen] aus, um die Berechtigungen zu genehmigen.

Für die Benutzerauthentifizierung (delegierte Berechtigungen):

Fügen Sie Ihrer Entra-App-Registrierung Folgendes als Delegierte Berechtigungen hinzu. Die vollständige Berechtigungsreferenz finden Sie in der Microsoft Graph-Berechtigungsreferenz in der Microsoft-Dokumentation.

SharePoint Aktionsintegration — delegierte Berechtigungen

Berechtigung	Description
Files.ReadWrite	Ermöglicht der App, die Dateien des angemeldeten Benutzers zu lesen, zu erstellen, zu aktualisieren und zu löschen.
Sites.ReadWrite.All	Ermöglicht der Anwendung, Dokumente zu bearbeiten oder zu löschen und Elemente in allen Websitesammlungen im Namen des angemeldeten Benutzers aufzulisten.
offline_access	Ermöglicht der App, Zugriffstoken zu aktualisieren, ohne dass sich der Benutzer erneut anmelden muss. Dadurch wird die Häufigkeit reduziert, mit der sich Benutzer erneut authentifizieren müssen.

Für die Dienstauthentifizierung (Anwendungsberechtigungen):

Fügen Sie Ihrer Entra-App-Registrierung Folgendes als Anwendungsberechtigungen hinzu.

SharePoint Aktionsintegration — Anwendungsberechtigungen

Berechtigung	Description
Sites.ReadWrite.All	Ermöglicht der App, Dokumente zu erstellen, zu lesen, zu aktualisieren und zu löschen und Elemente in allen Websitesammlungen aufzulisten, ohne dass ein Benutzer angemeldet ist.

Wichtig

Bei der Dienstauthentifizierung werden alle Aktionen als Dienstkonto ausgeführt. Jeder Benutzer mit Zugriff auf diese Integration kann Aktionen für alle Websitesammlungen ausführen, auf die das Dienstkonto zugreifen kann. Richten Sie die Anwendungsberechtigungen entsprechend den Sicherheitsanforderungen Ihres Unternehmens ein.

Notieren Sie Ihre Anmeldedaten

Bevor Sie das Microsoft Entra Admin Center verlassen, vergewissern Sie sich, dass Sie die folgenden Werte haben. Sie benötigen sie für die Amazon Quick-Konfiguration.

Erforderliche Anmeldeinformationen von Microsoft Entra

Wert	Wo ist es zu finden
Anwendungs-(Client-)ID	Übersichtsseite zur App-Registrierung
Verzeichnis-ID (Mandanten-ID)	Übersichtsseite zur App-Registrierung
Geheimer Wert für den Kunden	Seite mit Zertifikaten und Geheimnissen

Richten Sie die Integration in Amazon Quick ein

Nachdem Sie die Entra-Konfiguration abgeschlossen haben, erstellen Sie die Integration in Amazon Quick.

1. Wählen Sie in der Amazon Quick-Konsole Integrationen aus.

2. Wählen Sie Microsoft SharePoint und klicken Sie auf die Schaltfläche Hinzufügen (plus „+“).

3. Wählen Sie die Registerkarte „Aktionen“.

4. Wählen Sie Aktionen in Microsoft ausführen aus SharePoint.

5. Geben Sie die Integrationsdetails ein:

   • Name — Beschreibender Name für Ihre SharePoint Integration.

   • Beschreibung (optional) — Zweck der Integration.

6. Wählen Sie Ihren Verbindungstyp und geben Sie die Verbindungseinstellungen ein:

   1. Konfigurieren Sie für die Benutzerauthentifizierung (OAuth) die folgenden Felder:

      • Basis-URL — https://graph.microsoft.com/v1.0

      • Client-ID — Anwendungs-ID (Client) aus Ihrer Entra-App-Registrierung.

      • Kundengeheimnis — Wert des geheimen Kundengeheimnisses aus Ihrer Entra-App-Registrierung.

      • Token-URL — https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token

      • Authentifizierungs-URL — https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize

      • URL umleiten — https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

   2. Konfigurieren Sie für die Dienstauthentifizierung die folgenden Felder:

      • Client-ID — Anwendungs-ID (Client) aus Ihrer Entra-App-Registrierung.

      • Kundengeheimnis — Wert des geheimen Kundengeheimnisses aus Ihrer Entra-App-Registrierung.

      • Token-URL — https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token

      • Umfang – .default

7. Wählen Sie Erstellen und fortfahren.

8. Wählen Sie Benutzer aus, mit denen Sie die Integration teilen möchten.

9. Wählen Sie Weiter aus.

Verfügbare Aktionen

Nachdem Sie die Integration eingerichtet haben, sind die folgenden Aktionen verfügbar.

SharePoint Verfügbare Aktionen von Microsoft

Kategorie	Action	Description
Listen und Artikel	Artikel ansehen	Ruft die Sammlung von Elementen in einer Liste ab.
Listen und Artikel	Element abrufen	Gibt die Metadaten für ein Element in einer Liste zurück.
Listen und Elemente	Liste abrufen	Gibt die Metadaten für eine Liste zurück.
Listen und Elemente	Element aktualisieren	Aktualisieren Sie die Eigenschaften eines Listenelements.
Listen und Elemente	Element löschen	Entfernt ein Element aus einer Liste.
Dateien	Datei hochladen	Laden Sie eine neue Datei hoch oder aktualisieren Sie eine bestehende Datei. Unterstützt Dateien bis zu 250 MB.
Dateien	Suchen Sie nach Site Drive-Artikeln	Durchsucht die Hierarchie der Elemente, die einer Abfrage entsprechen.
Excel-Arbeitsmappen	Listenblätter	Ruft eine Liste von Arbeitsblattobjekten ab.
Excel-Arbeitsmappen	Blatt hinzufügen	Fügen Sie der Arbeitsmappe ein neues Arbeitsblatt hinzu.
Excel-Arbeitsmappen	Blatt lesen	Ruft die Eigenschaften eines Arbeitsblattobjekts ab.
Excel-Arbeitsmappen	Blatt aktualisieren	Aktualisieren Sie die Eigenschaften eines Arbeitsblattobjekts.
Excel-Arbeitsmappen	Blatt löschen	Löschen Sie das Arbeitsblatt aus der Arbeitsmappe.
Excel-Arbeitsmappen	Zelle lesen	Ermittelt den Wert einer einzelnen Zelle anhand der Zeilen- und Spaltennummer.
Excel-Arbeitsmappen	Zelle schreiben	Legt den Wert einer einzelnen Zelle nach Zeilen- und Spaltennummer fest.
Excel-Arbeitsmappen	Bereich lesen	Ruft die Werte eines Bereichs ab.
Excel-Arbeitsmappen	Bereich schreiben	Aktualisieren Sie die Werte eines Bereichs.
Excel-Arbeitsmappen	Bereich löschen	Löscht Bereichswerte, Format, Füllung und Rahmen.
Excel-Arbeitsmappen	Bereich löschen	Löscht die mit dem Bereich verknüpften Zellen.
Excel-Arbeitsmappen	Verwendete Reichweite abrufen	Ermittelt den kleinsten Bereich, der Zellen mit einem Wert oder einer Formatierung umfasst.

Verwaltung und Problembehebung

Informationen zum Bearbeiten, Teilen oder Löschen Ihrer Integration finden Sie unterVerwaltung vorhandener Integrationen.

Probleme bei der Authentifizierung

• Falsche App-Registrierung — Stellen Sie sicher, dass die App-Registrierung in Microsoft Entra die erforderlichen API-Berechtigungen enthält und dass die Zustimmung des Administrators erteilt wurde.

• Abgelaufener geheimer Client-Schlüssel — Prüfen Sie unter Zertifikate und geheime Daten, ob der geheime Client-Schlüssel abgelaufen ist, und generieren Sie bei Bedarf einen neuen.

• Falsche Umleitungs-URI — Stellen Sie sicher, dass die Umleitungs-URI in Microsoft Entra übereinstimmthttps://{region}.quicksight.aws.amazon.com/sn/oauthcallback.

Häufige Fehlermeldungen

• Access denied. You do not have permission to perform this action— Der authentifizierte Benutzer verfügt nicht über die erforderlichen Berechtigungen. Wenden Sie sich an Ihren Administrator, um die entsprechenden Berechtigungen zu überprüfen und zu erteilen.

• AADSTS50020: User account from identity provider does not exist in tenant— Das Benutzerkonto ist nicht im richtigen Microsoft Entra-Mandanten konfiguriert. Stellen Sie sicher, dass das Benutzerkonto in dem Mandanten vorhanden ist, der mit der Verzeichnis-ID (Mandanten-ID) in Ihrer App-Registrierung übereinstimmt.