Workiva-ondersteuningscentrum

Met de Microsoft® OneDrive®-connector kunt u opdrachten in een keten gebruiken om bestanden en mappen in Microsoft OneDrive of SharePoint® te beheren. Met deze connector kunt u bijvoorbeeld het volgende doen:

• Bestanden en mappen kopiëren, verwijderen en zoeken.
• Bestanden downloaden en uploaden
• Lijst met beschikbare schijven

Opmerking : Deze connector is gebouwd door Workiva en maakt verbinding met een systeem van derden. Hoewel ons supportteam u kan helpen bij het configureren van deze connector binnen uw werkruimte, kunnen we geen problemen oplossen of anderszins ondersteuning bieden bij problemen die buiten het Workiva-platform ontstaan.

Voorwaarden

Om de verbinding tot stand te brengen, maakt de connector gebruik van de Microsoft Graph API. Om de verbinding te beveiligen, gebruikt de connector OAuth-authenticatie via een aangewezen toepassing die is geregistreerd bij de Microsoft-toepassingsregistratieportal of Azure® Active Directory®.

Om de connector in te stellen, hebt u het volgende nodig:

• Een applicatie geregistreerd bij de Microsoft-applicatieregistratieportal of Azure Active Directory . Noteer uw aanvraag-ID
• De OAuth-client-ID en het geheim van de Azure-applicatie
• De scopes van de Azure-applicatie, geschikt voor de opdrachten die de connector zal uitvoeren.

• Het type en de ID van de schijf waarmee verbinding moet worden gemaakt.

  Opmerking : U kunt Microsofts Graph Explorer gebruiken om deze gegevens uit SharePoint op te halen.

• De redirect-URI van het project:
  • PROD: https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
  • APAC: https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  • CA: https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
  • EU: https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback

Voorbeeld van de configuratie van Microsoft Azure voor OneDrive

Een aanvraag registreren

1. Meld u aan bij uw Microsoft Azure-portal: https://azure.microsoft.com/en-us/account/
2. Navigeer naar uw Azure Active Directory -services.
3. Ga naar App-registraties onder Beheer en klik op Nieuwe registratie .
4. Geef een gewenste applicatienaam op en druk vervolgens op registreren .

Applicatieverificatie configureren

1. Meld u aan bij uw Microsoft Azure-portal: https://azure.microsoft.com/en-us/account/
2. Navigeer naar uw Azure Active Directory -services.
3. Navigeer naar App-registraties onder Beheer.
4. Navigeer naar Authenticatie in het bijgewerkte beheerpaneel.
5. Selecteer onder 'Ondersteunde accounttypen' Accounts in elke organisatiedirectory (Elke Microsoft Entra ID-tenant - Multitenant) .
6. Selecteer onder 'Een platform toevoegen' de optie Web .
7. Voer onder Redirect URI de geldige callback-URL van hierboven in.
8. Zorg ervoor dat u het vakje voor MultiTenant aanvinkt onder Ondersteunde accounttypen .

Opmerking: Aangezien de OneDrive-connector vereist dat de optie MultiTenant is ingeschakeld, is het aan de Azure-beheerders om ervoor te zorgen dat toepassingen correct zijn geconfigureerd voor naleving van de beveiligingsvoorschriften. Deze optie zorgt er, mits correct gebruikt met Azure-beveiliging, voor dat de applicatie niet voor iedereen toegankelijk is. Hieronder volgen suggesties voor aanvullende stappen die genomen kunnen worden.

• Raadpleeg de documentatie van Microsoft met betrekking tot de MultiTenant-configuratie.
• Schakel de beveiliging in voor de individuele applicatie, volgens de instructies van Microsoft over hoe u uw app kunt beperken tot een groep gebruikers .
• Wijs gebruikers toegang tot de applicatie toe volgens de instructies van Microsoft over het toewijzen van de app aan gebruikers en groepen .

Certificaten en geheimen instellen

1. Meld u aan bij uw Microsoft Azure-portal: https://azure.microsoft.com/en-us/account/
2. Navigeer naar uw Azure Active Directory -services.
3. Navigeer naar App-registraties onder Beheer .
4. Navigeer naar Certificaten onder het bijgewerkte Beheer paneel.
5. Klik op Nieuw clientgeheim in het middenpaneel.
6. Na het invoeren van een korte Beschrijving en Vervaldatum wordt een Client Secret weergegeven. Dit moet worden opgeslagen voor veilige bewaring en invoer in de Microsoft OneDrive-connector.

API-machtigingen instellen

1. Meld u aan bij uw Microsoft Azure-portal: https://azure.microsoft.com/en-us/account/
2. Navigeer naar uw Azure Active Directory -services.
3. Navigeer naar App-registraties onder Beheer .
4. Navigeer naar API-machtigingen onder het bijgewerkte Beheer paneel.
5. Klik op Een machtiging toevoegen in het middenpaneel.
6. Kies Microsoft Graph onder Microsoft API's .
7. Kies Machtigingen delegeren als het Verzoektype .
8. Uit de lijst met machtigingen heb je nodig:
   User.Read , alles onder FILES en OpenId.offline_access .
9. Klik op Beheerderstoestemming verlenen .
10. Definieer het toegangsniveau dat de connector vereist.De
    volgende bereiken worden ondersteund door de Microsoft OneDrive- connector :
    • Bestanden.Lezen.Schrijven.Geselecteerd
    • Bestanden.Lezen.Schrijven.AppMap
    • Bestanden.Lezen.Schrijven.Alles
    • Bestanden.LezenSchrijven
    • Bestanden.Lezen.Geselecteerd
    • Bestanden.Lezen.Alles
    • Bestanden.Lezen
    • offline_toegang

Minimaal is de scope offline_access vereist.

Waarom Files.Read.All en Files.ReadWrite.All nodig zijn

De Workiva OneDrive Connector communiceert met uw Microsoft-omgeving via de Microsoft Graph API met behulp van OAuth Delegated Permissions. Dit betekent dat de connector zich authenticeert en namens een geauthenticeerde gebruiker handelt.

Waarom Sites.Selected niet gebruikt kan worden

Sites.Selected is een SharePoint-specifieke machtiging die is ontworpen voor toegangsstromen op applicatieniveau (alleen voor apps); deze is niet compatibel met het model voor gedelegeerde machtigingen dat de Workiva-connector gebruikt. Het beperkt de toegang ook tot alleen vooraf goedgekeurde SharePoint-sites, waardoor de connector geen dynamische, padgebaseerde bewerkingen zoals Zoeken, Item kopiëren en Item verwijderen kan uitvoeren.

Beveiliging inschakelen

1. Meld u aan bij uw Microsoft Azure-portal: https://azure.microsoft.com/en-us/account/
2. Navigeer naar uw Azure Active Directory -services.
3. Klik op Bedrijfstoepassingen onder Beheer .
4. Selecteer uw toepassing uit de lijst om het bewerkingsproces te starten. Als uw toepassing niet standaard wordt weergegeven, klikt u op Alle toepassingen onder Beheer .
5. Klik op Eigenschappen onder Beheer .
6. Stel op het scherm Eigenschappen de volgende eigenschappen in om het gebruik van de hierboven gecreëerde API-toegang mogelijk te maken:

   • Is het mogelijk voor gebruikers om in te loggen? = Ja

   • Gebruikerstoewijzing vereist? = Ja

   • (Optioneel) Zichtbaar voor gebruikers? = Nee

7. Klik op Gebruikers en groepen onder Beheer .
8. Je kunt nu de standaard Azure AD-processen gebruiken om je gebruikers naar behoefte toe te voegen. Dit
   is de lijst met gebruikers die OneDrive mogen gebruiken en over een geldige Microsoft OneDrive-licentie beschikken.

Stel de Microsoft OneDrive-connector in.

Opmerking: Om de connector beschikbaar te maken voor gebruik in de ketens van uw organisatie, moet een beveiligingsbeheerder van de organisatie deze eerst inschakelen via Configuratie .

1. Klik in Chain Builder op Connections compare_arrows en vervolgens op Create rechtsboven.
2. Selecteer onder Connector Connection de optie Microsoft OneDrive en de standaard CloudRunner.
   
3. Voer onder Basisinfo een unieke naam en beschrijving in om de connector te identificeren.
4. Voer onder OAuth de OAuth-client-ID en het OAuth-geheim in voor de Azure-toepassing van de connector.
   
5. Om het toegangsniveau van de connector te bepalen, voert u het authenticatiebereik van de Azure-toepassing in .
   Minimaal is de scope offline_access vereist.
6. Om de verbinding en OAuth-gegevens te autoriseren, klikt u op Verbinden .

7. Onder Eigenschappen kunt u de verbindingsgegevens invoeren:
   

   Eigendom	Details
   Aandrijftype	Selecteer het type schijf waarmee u verbinding wilt maken, zoals Schijf, Groep, Gebruiker of Site. Om verbinding te maken met uw eigen gebruikersschijf, selecteert u Huidige gebruiker (Ik) .
   Schijftype-ID	Voer de ID in van het station waarmee u verbinding wilt maken, op basis van Stationstype . Als bijvoorbeeld het schijftype Gebruiker" is, voer dan de gebruikers-ID in; als het "Site" is, voer dan de site-ID in.

   Opmerking: U kunt Microsofts Graph Explorer gebruiken om deze uit SharePoint op te halen.

8. Selecteer de omgevingen die u met de verbinding wilt gebruiken en klik op Opslaan .
9. Om de verbinding te testen, maak en voer een keten uit met het Downloadbestand - commando van de connector en controleer of er een geldige uitvoer wordt geretourneerd.

Probleemoplossing

Als de verbinding met Microsoft OneDrive of SharePoint mislukt:

• Controleer of de Azure-applicatie-OAuth-referenties van de connector aanwezig, correct en geldig zijn. OAuth-referenties hebben een vastgestelde vervaldatum en het certificaat kan verlopen zijn. In dat geval moet u een nieuw certificaat aanmaken en het nieuwe clientgeheim in de connector invoeren. Zie Certificaten en geheimen
  instellen voor meer informatie over het aanmaken van een nieuw geheim.
• Controleer het type aandrijving en de ID die voor de connector zijn ingevoerd. Je kunt Microsofts Graph Explorer gebruiken om deze gegevens uit SharePoint op te halen.
• Controleer de redirect-URI van het project:
  • PROD: https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
  • APAC: https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  • CA: https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
  • EU: https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback