|
Die klassischen Dateitypen können ab Januar 2021 nicht mehr verwendet werden. Sie können Ihre klassischen Dateien übertragen oder eine PDF herunterladen. Weitere Informationen

Workiva Support Center

Verbindung zu Microsoft OneDrive

Verbindung zu Microsoft OneDrive

  • Zuletzt aktualisiert am

Mit dem Microsoft® OneDrive® Connector können Sie Befehle in einer Kette verwenden, um Dateien und Ordner in Microsoft OneDrive oder SharePoint® zu verwalten. Mit diesem Konnektor können Sie beispielsweise Folgendes tun:

  • Kopieren, Löschen und Suchen von Dateien und Ordnern
  • Herunter- und Hochladen von Dateien
  • Verfügbare Laufwerke auflisten
Hinweis: Dieser Konnektor wird von Workiva hergestellt und verbindet sich mit einem System eines Drittanbieters. Unser Support-Team kann Ihnen zwar bei der Konfiguration dieses Konnektors innerhalb Ihres Arbeitsbereichs behilflich sein, aber wir sind nicht in der Lage, Fehler zu beheben oder anderweitig bei Problemen zu helfen, die ihren Ursprung außerhalb der Workiva-Plattform haben.

Voraussetzungen

Um die Verbindung zu aktivieren, verwendet der Connector die Microsoft Graph API. Um die Verbindung zu sichern, verwendet der Connector die OAuth-Authentifizierung über eine bestimmte Anwendung, die im Microsoft-Anwendungsregistrierungsportal oder im Azure® Active Directory® registriert ist.

Zur Einrichtung des Konnektors benötigen Sie Folgendes:

Beispiel für die Einrichtung von Microsoft Azure für OneDrive

Registrierung einer Anwendung

  1. Melden Sie sich bei Ihrem Microsoft Azure-Portal an: https://azure.microsoft.com/en-us/account/
  2. Navigieren Sie zu Ihren Azure Active Directory-Diensten unter .
  3. Rufen Sie die Seite „ -App-Registrierungen“ ( ) unter „Verwalten“ auf und klicken Sie auf „ “ (Neue Registrierung) ( ).
  4. Geben Sie den gewünschten Anwendungsnamen für „ “ ein: „ “ und klicken Sie anschließend auf „ “ (Registrieren). .

Anwendungsauthentifizierung konfigurieren

  1. Melden Sie sich bei Ihrem Microsoft Azure-Portal an: https://azure.microsoft.com/en-us/account/
  2. Navigieren Sie zu Ihren Azure Active Directory-Diensten unter .
  3. Navigieren Sie zu „ “ unter „App-Registrierungen“ unter „Verwalten“.
  4. Navigieren Sie im aktualisierten Bereich „Verwalten“ zu „ -Authentifizierung“ ( ).
  5. Wählen Sie unter „Unterstützte Kontotypen“ die Option „ -Konten in einem beliebigen Organisationsverzeichnis (beliebiger Microsoft Entra ID-Mandant – Multitenant)“ aus: .
  6. Wählen Sie unter „Plattform hinzufügen“ die Option „ -Web“ aus.
  7. Geben Sie unter „ “ (Redirect-URI) die oben angegebene gültige Callback-URL ein.
  8. Stellen Sie sicher, dass Sie das Kontrollkästchen für „ MultiTenant“ unter „ “ (Unterstützte Kontotypen) aktivieren.
Hinweis: Da der OneDrive Connector die Aktivierung der MultiTenant-Option erfordert, obliegt es den Azure-Administratoren, sicherzustellen, dass die Anwendungen für die Einhaltung der Sicherheitsvorschriften korrekt konfiguriert sind. Bei korrekter Verwendung dieser Option mit Azure-Sicherheit wird die Anwendung nicht für jedermann geöffnet. Nachfolgend finden Sie Vorschläge für weitere Maßnahmen, die ergriffen werden können.

Einrichten von Zertifikaten und Geheimnissen

  1. Melden Sie sich bei Ihrem Microsoft Azure-Portal an: https://azure.microsoft.com/en-us/account/
  2. Navigieren Sie zu Ihren Azure Active Directory-Diensten unter .
  3. Navigieren Sie zu „ “ unter „App-Registrierungen“ ( ) unter „ “ und verwalten Sie dort „ “.
  4. Navigieren Sie zu „ -Zertifikate“ ( ) im aktualisierten Bereich „ -Verwaltung“ ( ).
  5. Klicken Sie im mittleren Bereich auf „ “ (Neues Client-Secret) .
  6. Nach Eingabe einer kurzen Beschreibung „ “ ( ) und des Ablaufdatums „ “ ( ) wird ein Client-Secret angezeigt. Dies muss zur sicheren Aufbewahrung und zur Eingabe in den Microsoft OneDrive-Konnektor gespeichert werden.

Einrichten von API-Berechtigungen

  1. Melden Sie sich bei Ihrem Microsoft Azure-Portal an: https://azure.microsoft.com/en-us/account/
  2. Navigieren Sie zu Ihren Azure Active Directory-Diensten unter .
  3. Navigieren Sie zu „ “ unter „App-Registrierungen“ ( ) unter „ “ und verwalten Sie dort „ “.
  4. Navigieren Sie zu „ “ API-Berechtigungen unter dem aktualisierten Bereich „ “ Verwalten .
  5. Klicken Sie auf „ “ und fügen Sie im mittleren Bereich die Berechtigung „ “ hinzu.
  6. Wählen Sie „ “ unter „Microsoft Graph“ unter „ “ Microsoft-APIs .
  7. Wählen Sie „ “ (Delegierte Berechtigungen) unter „ “ ( ) als „ “ ( ) unter „Request Type“ (Anforderungstyp) aus .
  8. Aus der Liste der erforderlichen Berechtigungen:
    User.Read , alles unter FILES und OpenId.offline_access .
  9. Klicken Sie auf „ “ und erteilen Sie die Zustimmung zur Verwaltung der Fördermittel unter .
  10. Definieren Sie die für den Konnektor erforderliche Zugriffsebene.  Der Microsoft OneDrive-Konnektor unterstützt die
    folgenden „ “-Bereiche:
    • Files.ReadWrite.Selected 
    • Files.ReadWrite.AppFolder 
    • Files.ReadWrite.All 
    • Dateien.LesenSchreiben 
    • Files.Read.Selected 
    • Files.Read.All 
    • Files.Read 
    • Offline-Zugriff

Es ist mindestens der Bereich „ offline_access “ erforderlich.

Warum „Files.Read.All“ und „Files.ReadWrite.All“ benötigt werden

Der Workiva OneDrive-Konnektor kommuniziert über die Microsoft Graph-API mithilfe von OAuth-Delegationsberechtigungen mit Ihrer Microsoft-Umgebung – das bedeutet, dass sich der Konnektor im Namen eines authentifizierten Benutzers authentifiziert und Handlungen durchführt.

Warum „Sites.Selected“ nicht verwendet werden kann

„Sites.Selected“ ist eine SharePoint-spezifische Berechtigung, die für Zugriffsabläufe auf Anwendungsebene (nur für Apps) konzipiert ist; sie ist nicht mit dem Modell der delegierten Berechtigungen kompatibel, das der Workiva-Konnektor verwendet. Außerdem wird der Zugriff auf vorab genehmigte SharePoint-Websites beschränkt, wodurch verhindert wird, dass der Konnektor dynamische, pfadbasierte Vorgänge wie „Suchen“, „Element kopieren“ und „Element löschen“ ausführt.

 

Sicherheit aktivieren

  1. Melden Sie sich bei Ihrem Microsoft Azure-Portal an: https://azure.microsoft.com/en-us/account/
  2. Navigieren Sie zu Ihren Azure Active Directory-Diensten unter .
  3. Klicken Sie auf „ “ > „Enterprise Applications“ > „ “ unter „ “ > „Manage“ > „ “.
  4. Wählen Sie Ihre Bewerbung aus der Liste aus, um den Bearbeitungsprozess zu starten. Falls Ihre Anwendung standardmäßig nicht aufgeführt ist, klicken Sie unter „ “ auf „ “ und dann unter „Manage“ auf „All Applications“ .
  5. Klicken Sie auf „ “ und dann auf „Eigenschaften“ ( ) unter „ “ und anschließend auf „Verwalten“ ( ).
  6. Legen Sie auf dem Bildschirm „ -Eigenschaften“ ( ) die folgenden Eigenschaften fest, um die Nutzung des oben erstellten API-Zugangs zu ermöglichen:

    • Ist die Anmeldung für Benutzer aktiviert? = Ja

    • Ist eine Benutzerzuordnung erforderlich? = Ja

    • (Optional) Für Benutzer sichtbar? = Nein
  7. Klicken Sie auf „ “, dann auf „Benutzer und Gruppen“ ( ) unter „ “ und anschließend auf „Verwalten“ ( ).
  8. Sie können nun die Standardprozesse von Azure AD nutzen, um Ihre Benutzer nach Bedarf hinzuzufügen.   Dies
    ist die Liste der Benutzer, die OneDrive nutzen dürfen und über eine gültige Microsoft OneDrive-Lizenz verfügen.

Einrichten des Microsoft OneDrive-Connectors

Hinweis: Um den Konnektor für die Verwendung in den Ketten Ihrer Organisation verfügbar zu machen, muss ein Sicherheitsadministrator der Organisation ihn zunächst aktivieren unter Konfiguration.
  1. Gehen Sie auf Chain Builder , klicken Sie auf „ “ (Verbindungen) compare_arrows und anschließend oben rechts auf „ “ (Erstellen) .
  2. Wählen Sie unter „ -Konnektor-Verbindung“ ( ) die Option „ “ (Microsoft OneDrive) ( ) und den Standard-CloudRunner aus.
    microsoft-onedrive-connector_01.png
  3. Geben Sie unter Basisinformationen einen eindeutigen Namen und eine Beschreibung ein, um den Konnektor zu identifizieren.
  4. Geben Sie unter OAuth die OAuth-Client-ID und das Geheimnis für die Azure-Anwendung des Connectors ein.
    microsoft-onedrive-connector_02.png
  5. Um die Zugriffsebene des Konnektor zu bestimmen, geben Sie den Authentifizierungsbereich der Azure-Anwendung ein.
    Es ist mindestens der Geltungsbereich „ offline_access “ erforderlich.
  6. Um die Verbindung und die OAuth-Anmeldeinformationen zu autorisieren, klicken Sie auf Verbinden.

  7. Geben Sie unter Eigenschaften die Details der Verbindung ein:
    microsoft-onedrive-connector_03.png

    Eigenschaft Details
    Antriebstyp Wählen Sie den Typ des Laufwerks, mit dem Sie eine Verbindung herstellen möchten, z. B. Laufwerk, Gruppe, Benutzer oder Standort.  Um eine
    Verbindung zu Ihrem eigenen Benutzerlaufwerk herzustellen, wählen Sie „ “ > „Aktueller Benutzer (Ich)“ > „ “.
    Laufwerkstyp ID Geben Sie die ID des Laufwerks ein, mit dem eine Verbindung hergestellt werden soll, basierend auf Laufwerkstyp. Wenn beispielsweise der Laufwerkstyp „ “ unter „ “ auf „User“ lautet, geben Sie die Benutzer-ID ein; wenn er auf „Site“ lautet, geben Sie die Standort-ID ein.
    Hinweis: Sie können den „ “ von Microsoft ( ) verwenden, um diese Daten aus SharePoint abzurufen.
  8. Wählen Sie die Umgebungen aus, die für die Verbindung verwendet werden sollen, und klicken Sie auf Speichern.
  9. Um die Verbindung zu testen, erstellen Sie eine Kette und führen Sie diese mit dem Befehl Datei herunterladen des Konnektors aus und prüfen Sie, ob eine gültige Ausgabe zurückgegeben wird.

Fehlersuche

Wenn die Verbindung zu Microsoft OneDrive oder SharePoint fehlschlägt:

Mit dem Microsoft® OneDrive® Connector können Sie Befehle in einer Kette verwenden, um Dateien und Ordner in Microsof...