Workiva supportcenter

Med Microsoft® OneDrive® Connector kan du använda kommandon i en kedja för att hantera filer och mappar i Microsoft OneDrive eller SharePoint®. Med den här kontakten kan du t.ex:

• Kopiera, radera och söka efter filer och mappar
• Hämta och ladda upp filer
• Lista tillgängliga enheter

Obs: Denna kontakt är byggd av Workiva och ansluts till ett system från tredje part. Vår support kan hjälpa till att konfigurera den här anslutningen i din arbetsyta, men vi kan inte felsöka eller på annat sätt hjälpa till med problem som uppstår utanför Workiva-plattformen.

Förkunskapskrav

För att aktivera anslutningen använder connectorn Microsoft Graph API. För att säkra anslutningen använder connectorn OAuth-autentisering via ett angivet program som är registrerat på Microsofts portal för programregistrering eller Azure® Active Directory®.

För att sätta upp kontakten behöver du:

• Ett program som registrerats med Microsofts portal för programregistrering eller Azure Active Directory. Posta ditt ansöknings-ID
• Azure-applikationens OAuth-klient-ID och -hemlighet
• Azure-applikationens scopes, lämpliga för de kommandon som kontakten kommer att utföra

• Typ och ID för den enhet som ska anslutas till.

  Obs : Du kan använda Microsofts Graph Explorer för att hämta dessa från SharePoint.

• Projektets URI för omdirigering:
  • 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

Exempel på installation av Microsoft Azure för OneDrive

Registrering av en ansökan

1. Logga in på din Microsoft Azure-portal: https://azure.microsoft.com/en-us/account/
2. Navigera till dina Azure Active Directory -tjänster.
3. Navigera till Appregistreringar under Hantera och klicka på Ny registrering .
4. Ange önskat applikationsnamn och tryck sedan på Registrera .

Konfigurera autentisering av applikationer

1. Logga in på din Microsoft Azure-portal: https://azure.microsoft.com/en-us/account/
2. Navigera till dina Azure Active Directory -tjänster.
3. Navigera till Appregistreringar under Hantera.
4. Navigera till Autentisering under den uppdaterade Hantera-panelen.
5. Under "Kontotyper som stöds" väljer du Konton i valfri organisationskatalog (valfri Microsoft Entra ID-klient - Multiklient) .
6. Under Lägg till en plattform väljer du Webb .
7. Under Omdirigerings-URI anger du den giltiga återuppringnings-URL:en ovan.
8. Se till att markera rutan för MultiTenant under Kontotyper som stöds .

Obs: Eftersom OneDrive Connector kräver att alternativet MultiTenant är aktiverat är det upp till Azure-administratörerna att se till att programmen är korrekt konfigurerade för att uppfylla kraven på värdepapper. Det här alternativet, när det används korrekt med Azure-säkerhet, öppnar inte programmet för alla. Nedan finns förslag på ytterligare åtgärder som kan vidtas.

• Granska dokumentationen från Microsoft relaterad till installation av MultiTenant.
• Aktivera säkerhet för den enskilda applikationen, följ Microsofts instruktioner om hur du begränsar din app till en viss grupp användare .
• Tilldela/tillåt användare åtkomst till applikationen enligt Microsofts instruktioner om att tilldela appen till användare och grupper .

Konfigurera certifikat och hemligheter

1. Logga in på din Microsoft Azure-portal: https://azure.microsoft.com/en-us/account/
2. Navigera till dina Azure Active Directory -tjänster.
3. Navigera till Appregistreringar under Hantera .
4. Navigera till Certifikat under den uppdaterade panelen Hantera .
5. Klicka på Ny klienthemlighet i mittpanelen.
6. Efter att en kort Beskrivning och Utgångsdatum angetts visas en klienthemlighet. Detta måste lagras för säker förvaring och åtkomst till Microsoft OneDrive-anslutningen.

Konfigurera API-behörigheter

1. Logga in på din Microsoft Azure-portal: https://azure.microsoft.com/en-us/account/
2. Navigera till dina Azure Active Directory -tjänster.
3. Navigera till Appregistreringar under Hantera .
4. Navigera till API-behörigheter under den uppdaterade panelen Hantera .
5. Klicka på Lägg till en behörighet i mittpanelen.
6. Välj Microsoft Graph under Microsoft API: er .
7. Välj Delegera behörigheter som Begärantyp .
8. Från listan över behörigheter behöver du:
   User.Read , allt under FILES och OpenId.offline_access .
9. Klicka på Ge administratörsmedgivande .
10. Definiera den åtkomstnivå som krävs för anslutningen.
    Följande omfång stöds av Microsoft OneDrive-anslutningen:
    • Filer.LäsSkriv.Valda
    • Files.ReadWrite.AppFolder
    • Filer.LäsSkriv.Alla
    • Filer.LäsSkriv
    • Filer.Läs.Valda
    • Filer.Läs.Alla
    • Filer.Läs
    • offlineåtkomst

Som minimum krävs omfattningen offline_access .

Varför Files.Read.All och Files.ReadWrite.All behövs

Workiva OneDrive Connector kommunicerar med din Microsoft-miljö via Microsoft Graph API med hjälp av OAuth-delegerade behörigheter – vilket innebär att connectorn autentiserar och agerar på uppdrag av en autentiserad användare.

Varför Sites.Selected inte kan användas

Sites.Selected är en SharePoint-specifik behörighet utformad för åtkomstflöden på applikationsnivå (endast appar); den är inte kompatibel med modellen för delegerad behörighet som Workiva-anslutningen använder. Det begränsar också åtkomsten till endast förhandsgodkända SharePoint-webbplatser, vilket förhindrar att kopplingen utför dynamiska, sökvägsbaserade åtgärder som Sök, Kopiera objekt och Ta bort objekt.

Möjliggörande av värdepapper

1. Logga in på din Microsoft Azure-portal: https://azure.microsoft.com/en-us/account/
2. Navigera till dina Azure Active Directory -tjänster.
3. Klicka på Företagsapplikationer under Hantera .
4. Välj din ansökan från listan för att starta redigeringsprocessen. Om din applikation inte visas som standard klickar du på Alla applikationer under Hantera .
5. Klicka på Egenskaper under Hantera .
6. På skärmen Egenskaper ställer du in följande egenskaper för att tillåta användning av API-åtkomsten som skapats ovan:

   • Aktiverat för användare att logga in? = Ja

   • Krävs användartilldelning? = Ja

   • (Valfritt) Synligt för användare? = Nej

7. Klicka på Användare och grupper under Hantera .
8. Du kan nu använda standardprocesser för Azure AD för att lägga till dina användare efter behov. Detta
   är listan över användare som har tillstånd att använda OneDrive och har en giltig Microsoft OneDrive-licens.

Konfigurera Microsoft OneDrive-anslutningen

Obs: För att göra kontakten tillgänglig för användning i din organisations kedjor, en org säkerhetsadministratör först aktivera den från Konfiguration.

1. Från Kedjebyggare klickar du på Anslutningar compare_arrows och sedan på Skapa längst upp till höger.
2. Under Anslutning för anslutning väljer du Microsoft OneDrive och standard CloudRunner.
   
3. Under Basic Info anger du ett unikt namn och en beskrivning som hjälper dig att identifiera kontakten.
4. Under OAuth anger du OAuth-klient-ID och -hemlighet för connectorens Azure-applikation.
   
5. För att bestämma kontaktens åtkomstnivå anger du Azure-applikationens autentiseringsomfång.
   Som minimum krävs omfånget offline_access .
6. För att godkänna anslutningen och OAuth-autentiseringsuppgifterna klickar du på Connect.

7. Under Properties anger du information om anslutningen:
   

   Egenskap	Information
   Typ av drivenhet	Välj vilken typ av enhet du vill ansluta till, t.ex. enhet, grupp, användare eller plats. För att ansluta till din egen användarenhet, välj Nuvarande användare (Jag) .
   ID för drivtyp	Ange ID för den enhet som du vill ansluta till, baserat på Enhetstyp. Om till exempel Enhetstyp är "Användare", ange användar-ID:t; om det är "Plats", ange plats-ID:t.

   Obs: Du kan använda Microsofts Graph Explorer för att hämta dessa från SharePoint.

8. Välj de miljöer som ska användas med anslutningen och klicka på Save.
9. Testa anslutningen genom att skapa och köra en kedja med kommandot Download File från connector och kontrollera att den returnerar en giltig utdata.

Felsökning

Om anslutningen till Microsoft OneDrive eller SharePoint misslyckas:

• Kontrollera att kontaktdonets OAuth-autentiseringsuppgifter för Azure-applikationen finns, är korrekta och giltiga. OAuth-inloggningsuppgifter har definierade utgångsdatum och certifikatet kan ha gått ut. Om så är fallet måste du skapa ett nytt certifikat och ange den nya klienthemligheten i Connector.
  Se Konfigurera certifikat och hemligheter för mer information om hur du skapar en ny hemlighet.
• Kontrollera vilken typ av enhet och vilket ID som har angetts för kontakten. Du kan använda Microsofts Graph Explorer för att hämta dessa från Sharepoint.
• Verifiera projektets omdirigerings-URI:
  • 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