Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
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.
Amazon Quick unterstützt mehrere Authentifizierungsmethoden für Microsoft SharePoint. Wählen Sie die Methode, die den Sicherheitsanforderungen Ihres Unternehmens am besten entspricht.
-
Standard-OAuth-Anwendung — Verwendet eine AWS-verwaltete OAuth-Anwendung. Es sind keine zusätzlichen Anmeldeinformationen erforderlich. Benutzer authentifizieren sich direkt mit ihrem Microsoft-Konto.
-
Benutzerdefinierte OAuth-App — Verwendet eine vom Kunden verwaltete Anwendung, die in Microsoft Entra registriert ist. Diese Option gibt Ihrem Unternehmen die volle Kontrolle über die OAuth-Konfiguration. Benutzer authentifizieren sich im Namen eines angemeldeten Benutzers (delegierte Berechtigungen).
-
Service-to-Service OAuth — Verwendet Client-Anmeldeinformationen für die Server-zu-Server-Authentifizierung ohne Benutzerinteraktion (Anwendungsberechtigungen). Geeignet für automatisierte Workflows.
Weitere 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.
-
Für benutzerdefinierte OAuth-Apps oder Service-to-Service OAuth: Zugriff auf das Microsoft Entra Admin Center auf der Microsoft-Website
mit mindestens Anwendungsentwicklerberechtigungen. -
Informationen zu den Abonnementanforderungen finden Sie unter. Integrationen in der Konsole einrichten
Microsoft Entra konfigurieren
Wenn Sie die standardmäßige OAuth-App-Authentifizierung verwenden, überspringen Sie diesen Abschnitt und fahren Sie fort mit. Den Connector in Amazon Quick einrichten
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
-
Öffnen Sie das Microsoft Entra Admin Center
. -
Wählen Sie in der linken Navigationsleiste Entra ID und dann App-Registrierungen aus.
-
Wählen Sie Neue Registrierung.
-
Geben Sie unter Name einen aussagekräftigen Namen für Ihre Integration ein.
-
Wählen Sie für Unterstützte Kontotypen die Option Nur Konten in diesem Organisationsverzeichnis aus.
-
Wählen Sie für Umleitungs-URI die Option Web aus und geben Sie ein
https://.{region}.quicksight.aws.amazon.com/sn/oauthcallback{region}Ersetzen Sie durch die AWS Region, in der Ihre Amazon Quick-Instance bereitgestellt wird. -
Wählen Sie Registrieren aus.
-
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.
-
Wählen Sie in Ihrer App-Registrierung die Option Zertifikate und Geheimnisse aus.
-
Wählen Sie Neues geheimes Kundenkonto aus.
-
Geben Sie eine Beschreibung ein und wählen Sie einen Ablaufzeitraum.
-
Wählen Sie Hinzufügen aus.
-
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
-
Wählen Sie in Ihrer App-Registrierung die Option API-Berechtigungen aus.
-
Wählen Sie „Berechtigung hinzufügen“ und anschließend „Microsoft Graph“.
-
Wählen Sie je nach Ihrer Authentifizierungsmethode Delegierte Berechtigungen oder Anwendungsberechtigungen aus und fügen Sie die Berechtigungen aus der entsprechenden Tabelle unten hinzu.
-
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
| 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.
| 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.
| 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 |
Den Connector in Amazon Quick einrichten
Connect über die Registerkarte „Verfügbar“ her
Wenn Sie die standardmäßige OAuth-App-Authentifizierung verwenden möchten, können Sie ohne zusätzliche Konfiguration direkt über den Tab Verfügbar eine Verbindung herstellen.
-
Wählen Sie in der Amazon Quick-Konsole Connectors aus.
-
Suchen SharePointund wählen Sie auf der Registerkarte Verfügbar die Option Connect aus.
-
Schließen Sie den Microsoft-Anmeldevorgang ab und gewähren Sie die angeforderten Berechtigungen.
Um einen Connector stattdessen mit der benutzerdefinierten OAuth-App oder Service-to-Service OAuth zu konfigurieren, verwenden Sie die Registerkarte „Für Ihr Team erstellen“ wie unten beschrieben.
Erstellen Sie auf der Registerkarte „Für Ihr Team erstellen“
Nachdem Sie alle erforderlichen Entra-Konfigurationen abgeschlossen haben, erstellen Sie den Connector in Amazon Quick.
-
Wählen Sie in der Amazon Quick-Konsole Connectors aus.
-
Wählen Sie den Tab „Für Ihr Team erstellen“.
-
Suchen und wählen Sie Microsoft SharePoint.
Anmerkung
Wenn bereits ein SharePoint Microsoft-Connector vorhanden ist, wird ein Dialogfeld mit Ihren vorhandenen Connectoren angezeigt. Um einen vorhandenen Connector zu verwenden, wählen Sie ihn aus. Um einen neuen zu erstellen, wählen Sie Nein, neu erstellen.
-
Wählen Sie auf der Seite Integrationstyp die Option Aktionen in Microsoft SharePoint Online ausführen und dann Weiter aus.
-
Geben Sie einen Namen für Ihren Connector ein. Wählen Sie optional + Beschreibung hinzufügen, um eine Beschreibung hinzuzufügen.
-
Wählen Sie als Verbindungstyp die Option Öffentliches Netzwerk aus.
-
Wählen Sie für die OAuth-Konfiguration eine der folgenden Authentifizierungsmethoden und konfigurieren Sie die erforderlichen Felder.
-
Für die Standard-OAuth-App:
Es sind keine zusätzlichen Anmeldeinformationen erforderlich. Wählen Sie Next (Weiter), um fortzufahren.
-
Konfigurieren Sie für die benutzerdefinierte OAuth-App (Benutzerauthentifizierung mit delegierten Berechtigungen) die folgenden Felder:
-
Basis-URL (optional) — Die Microsoft Graph-API-Basis-URL. Beispiel:
https://graph.microsoft.com/v1.0 -
Client-ID — Die Anwendungs- (Client-) ID aus Ihrer Entra-App-Registrierung.
-
Kundengeheimnis — Der geheime Client-Wert aus Ihrer Entra-App-Registrierung.
-
Token-URL — Der Token-Endpunkt. Beispiel:
https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token -
Autorisierungs-URL — Der Autorisierungsendpunkt. Beispiel:
https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize -
Weiterleitungs-URL — Pre-filled mit der Amazon Quick Callback-URL.
-
-
Konfigurieren Sie für Service-to-ServiceOAuth (Serviceauthentifizierung mit Anwendungsberechtigungen) die folgenden Felder:
-
Basis-URL (optional) — Die Microsoft Graph-API-Basis-URL. Beispiel:
https://graph.microsoft.com/v1.0 -
Client-ID — Die Anwendungs- (Client-) ID aus Ihrer Entra-App-Registrierung.
-
Kundengeheimnis — Der geheime Client-Wert aus Ihrer Entra-App-Registrierung.
-
Token-URL — Der Token-Endpunkt. Beispiel:
https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token
Anmerkung
Der Bereich für die Token-Anforderung (
https://graph.microsoft.com/.default) für Client-Anmeldeinformationen wird automatisch von Amazon Quick festgelegt. Sie müssen ihn nicht manuell konfigurieren. -
-
-
Wählen Sie Weiter aus.
-
Wenn Sie die Standard-OAuth-App oder die benutzerdefinierte OAuth-App ausgewählt haben, wird ein Microsoft-Autorisierungsfenster geöffnet. Überprüfen Sie die angeforderten Berechtigungen und wählen Sie Akzeptieren.
Wenn Sie statt des Zustimmungsdialogs eine Fehlermeldung sehen, schränkt Ihre Organisation möglicherweise den Zugriff auf Drittanbieter-Apps ein. Siehe Zustimmung des Administrators für Microsoft 365.
-
Überprüfen Sie auf der Seite Überprüfen die verfügbaren Aktionen für den Connector. Wählen Sie Weiter aus.
-
Wählen Sie auf der Seite „Veröffentlichen“ aus, wer auf den Connector zugreifen kann. Sie können den Zugriff für alle in Ihrer Organisation aktivieren oder nach bestimmten Teams oder Gruppen suchen.
-
Wählen Sie Publish.
Verfügbare Aktionen
Nachdem Sie die Integration eingerichtet haben, sind die folgenden Aktionen verfügbar.
| 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 übereinstimmt
https://.{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.
Zustimmung des Administrators für Microsoft 365
Wenn Sie die AWS Standard-OAuth-App-Authentifizierungsmethode verwenden, verwendet Amazon Quick eine verwaltete Anwendung, um im Namen des angemeldeten SharePoint Benutzers auf Microsoft zuzugreifen. Die meisten Benutzer können die Einrichtung ohne zusätzliche Schritte abschließen. Wenn Ihr Microsoft 365-Mandant jedoch den Zugriff auf Drittanbieter-Apps einschränkt, muss ein Microsoft 365-Administrator eine einmalige Zustimmung erteilen, bevor Benutzer eine Verbindung herstellen können.
Wenn Sie bei der Anmeldung während der Connector-Setup einen Fehler sehen, schränkt Ihre Organisation möglicherweise den Zugriff auf Drittanbieter-Apps ein. Teilen Sie Ihrem Microsoft 365-Administrator die folgenden Informationen mit:
-
Was zu tun ist: Erteilen Sie die Zustimmung des Administrators für die Amazon Quick SharePoint Microsoft-Integrationsanwendung.
-
Warum: Amazon Quick benötigt delegierten Zugriff auf SharePoint Websites, Listen, Dateien und Excel-Arbeitsmappen, um Aktionen im Namen von Benutzern ausführen zu können.
Ein Administrator kann seine Zustimmung auf eine der folgenden Arten erteilen:
-
Über das Zustimmungsdialogfeld — Ein globaler Administrator oder Administrator mit privilegierter Rolle initiiert den Connector-Setup-Flow. Im Microsoft-Anmeldedialogfeld aktivieren sie das Kontrollkästchen Zustimmung im Namen Ihrer Organisation und wählen Akzeptieren aus.
-
Über das Microsoft Entra Admin Center — Melden Sie sich beim Microsoft Entra Admin Center
auf der Microsoft-Website an. Wählen Sie Unternehmensanwendungen, suchen Sie die Amazon Quick-Anwendung, wählen Sie Permissions und anschließend Grant admin consent for aus Your Organization.
Nachdem die Zustimmung erteilt wurde, kann jeder Benutzer in Ihrer Organisation eine Verbindung herstellen, ohne nach individueller Zustimmung gefragt zu werden.
Anmerkung
Um zu überprüfen, ob Ihr Mandant die Benutzereinwilligungen einschränkt, rufen Sie das Microsoft Entra Admin Center auf und wählen Sie Unternehmensanwendungen, Zustimmung und Berechtigungen, Einstellungen für Benutzereinwilligungen aus. Wenn die Einstellung „Benutzereinwilligung nicht zulassen“ lautet, muss ein Administrator die Zustimmung erteilen, bevor Benutzer den Connector verwenden können.
