OneDrive Microsoft-Aktionsintegration

Verwenden Sie den Microsoft OneDrive Action Connector, um OneDrive Dateien, Ordner 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 OneDrive 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

Diese Integration verwendet delegierte Berechtigungen, die es der App ermöglichen, im Namen eines angemeldeten Benutzers zu handeln. 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 Delegierte Berechtigungen und fügen Sie die Berechtigungen aus der Tabelle unten hinzu.

4. Wählen Sie Grant admin consent for [your tenant name] aus, um die Berechtigungen zu genehmigen.

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.

OneDrive 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.
User.Read.All	Ermöglicht der App, im Namen des angemeldeten Benutzers den vollständigen Satz von Profileigenschaften aller Benutzer in der Organisation zu lesen.
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.

Notieren Sie sich 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 OneDrive 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 OneDrive.

5. Geben Sie die Integrationsdetails ein:

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

   • Beschreibung (optional) — Zweck der Integration.

6. Füllen Sie die Verbindungseinstellungen aus:

   • 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

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.

OneDrive Verfügbare Aktionen von Microsoft

Kategorie	Action	Description
Laufwerk und Artikel	Holen Sie sich Drive	Ruft die Eigenschaften und Beziehungen eines Laufwerks ab.
Laufwerk und Artikel	Artikel auflisten	Ruft alle im Laufwerk enthaltenen Elemente ab.
Laufwerk und Artikel	Element abrufen	Ruft ein Objekt ab, das im Laufwerk enthalten ist.
Laufwerk und Gegenstände	Ordner erstellen	Erstellen Sie einen neuen Ordner auf der Festplatte des Benutzers.
Laufwerk und Artikel	Element aktualisieren	Aktualisieren Sie die Metadaten für eine Datei oder einen Ordner.
Laufwerk und Artikel	Element löschen	Eine Datei oder einen Ordner löschen. Verschiebt den Artikel in den Papierkorb.
Laufwerk und Artikel	Untergeordnete Ordner auflisten	Gibt eine Sammlung von Elementen in den untergeordneten Ordnern eines Ordners zurück.
Laufwerk und Artikel	Artikel kopieren	Erstellen Sie eine Kopie einer Datei oder eines Ordners an einen anderen Speicherort.
Laufwerk und Artikel	Hinzufügen von Berechtigungen	Senden Sie eine Einladung zum Teilen einer Datei oder eines Ordners.
Laufwerk und Artikel	Datei hochladen	Laden Sie eine neue Datei hoch oder aktualisieren Sie eine bestehende Datei. Unterstützt Dateien bis zu 250 MB.
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.