Workiva kundestøttesenter

Med Microsoft® OneDrive®-koblingen kan du bruke kommandoer i en kjede for å administrere filer og mapper i Microsoft OneDrive eller SharePoint®. Med denne kontakten kan du for eksempel:

• Kopier, slett og søk etter filer og mapper
• Last ned og last opp filer
• Liste over tilgjengelige stasjoner

Merknad : Denne koblingen er bygget av Workiva og kobles til et tredjepartssystem. Selv om supportteamet vårt kan hjelpe deg med å konfigurere denne koblingen i arbeidsområdet ditt, kan vi ikke feilsøke eller på annen måte hjelpe med problemer som oppstår utenfor Workiva-plattformen.

Forutsetninger

For å aktivere tilkoblingen bruker koblingen Microsoft Graph API. For å sikre tilkoblingen bruker koblingen OAuth-autentisering via et angitt program registrert hos Microsoft-programregistreringsportalen eller Azure® Active Directory®.

For å sette opp koblingen trenger du:

• En applikasjon registrert hos Microsofts applikasjonsregistreringsportal eller Azure Active Directory . Registrer applikasjons-ID-en din
• Azure-applikasjonens OAuth-klient-ID og hemmelighet
• Azure-applikasjonens omfang, passende for kommandoene koblingen skal utføre

• Type og ID-en til stasjonen som skal kobles til.

  Merknad : Du kan bruke Microsofts Graph Explorer for å hente disse fra SharePoint.

• Prosjektets omdirigerings-URI:
  • PRODUKT: https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
  • Asia-Stillehavsregionen: 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

Eksempel på oppsett av Microsoft Azure for OneDrive

Registrering av en søknad

1. Logg inn på Microsoft Azure-portalen din: https://azure.microsoft.com/en-us/account/
2. Naviger til Azure Active Directory -tjenestene dine.
3. Naviger til Appregistreringer under Administrer og klikk på Ny registrering .
4. Oppgi et ønsket programnavn og trykk deretter på Registrer .

Konfigurer programgodkjenning

1. Logg inn på Microsoft Azure-portalen din: https://azure.microsoft.com/en-us/account/
2. Naviger til Azure Active Directory -tjenestene dine.
3. Naviger til Appregistreringer under Administrer.
4. Naviger til Autentisering under det oppdaterte Administrer-panelet.
5. Under «Støttede kontotyper» velger du Kontoer i en hvilken som helst organisasjonsmappe (enhver Microsoft Entra ID-leier – flerleier) .
6. Under Legg til en plattform velger du Nett .
7. Under Omdirigerings-URI skriver du inn den gyldige tilbakeringings-URL-en ovenfor.
8. Sørg for å merke av i boksen for MultiTenant under Støttede kontotyper .

Merk: Siden OneDrive Connector krever at MultiTenant-alternativet er aktivert, er det opp til Azure-administratorene å sørge for at applikasjonene er riktig konfigurert for sikkerhetssamsvar. Dette alternativet, når det brukes riktig med Azure-sikkerhet, åpner ikke applikasjonen for alle. Nedenfor finner du forslag til ytterligere tiltak som kan iverksettes.

• Se gjennom dokumentasjonen fra Microsoft relatert til MultiTenant-oppsett.
• Aktiver sikkerhet for den enkelte applikasjonen, og følg Microsofts instruksjoner om hvordan du begrenser appen din til et sett med brukere .
• Tildel/gi brukere tilgang til applikasjonen ved å følge Microsofts instruksjoner om tildeling av appen til brukere og grupper .

Konfigurere sertifikater og hemmeligheter

1. Logg inn på Microsoft Azure-portalen din: https://azure.microsoft.com/en-us/account/
2. Naviger til Azure Active Directory -tjenestene dine.
3. Naviger til Appregistreringer under Administrer .
4. Naviger til Sertifikater under det oppdaterte Administrer -panelet.
5. Klikk på Ny klienthemmelighet i midtpanelet.
6. Etter å ha oppgitt en kort Beskrivelse og Utløpsdato , vil en klienthemmelighet vises. Dette må lagres for sikker oppbevaring og tilgang til Microsoft OneDrive-koblingen.

Konfigurere API-tillatelser

1. Logg inn på Microsoft Azure-portalen din: https://azure.microsoft.com/en-us/account/
2. Naviger til Azure Active Directory -tjenestene dine.
3. Naviger til Appregistreringer under Administrer .
4. Naviger til API-tillatelser under det oppdaterte Administrer -panelet.
5. Klikk på Legg til en tillatelse i midtpanelet.
6. Velg Microsoft Graph under Microsoft API-er .
7. Velg Delegertillatelser som Forespørselstype .
8. Fra listen over tillatelser trenger du:
   User.Read , alt under FILES og OpenId.offline_access .
9. Klikk på Gi administratorsamtykke .
10. Definer tilgangsnivået som kreves av koblingen.
    Følgende omfang støttes av Microsoft OneDrive-koblingen:
    • Filer.LesSkriv.Valgt
    • Files.ReadWrite.AppFolder
    • Filer.LesSkriv.Alle
    • Filer.LesSkriv
    • Filer.Lest.Valgt
    • Filer.Les.Alle
    • Filer.Les
    • offline_tilgang

Som et minimum kreves omfanget offline_access .

Hvorfor Files.Read.All og Files.ReadWrite.All er nødvendige

Workiva OneDrive Connector kommuniserer med Microsoft-miljøet ditt via Microsoft Graph API ved hjelp av OAuth-delegerte tillatelser – som betyr at koblingen autentiserer og handler på vegne av en autentisert bruker.

Hvorfor Sites.Selected ikke kan brukes

Sites.Selected er en SharePoint-spesifikk tillatelse som er utformet for tilgangsflyter på applikasjonsnivå (kun app); den er ikke kompatibel med delegert tillatelsesmodell som Workiva-koblingen bruker. Den begrenser også tilgangen til kun forhåndsgodkjente SharePoint-nettsteder, noe som hindrer koblingen i å utføre dynamiske, banebaserte operasjoner som Søk, Kopier element og Slett element.

Aktivering av sikkerhet

1. Logg inn på Microsoft Azure-portalen din: https://azure.microsoft.com/en-us/account/
2. Naviger til Azure Active Directory -tjenestene dine.
3. Klikk på Bedriftsapplikasjoner under Administrer .
4. Velg applikasjonen din fra listen for å starte redigeringsprosessen. Hvis applikasjonen din ikke er oppført som standard, klikker du på Alle applikasjoner under Administrer .
5. Klikk på Egenskaper under Administrer .
6. På skjermbildet Egenskaper angir du følgende egenskaper for å tillate bruk av API-tilgangen som ble opprettet ovenfor:

   • Aktivert for brukere å logge på? = Ja

   • Kreves brukertildeling? = Ja

   • (Valgfritt) Synlig for brukere? = Nei

7. Klikk på Brukere og grupper under Administrer .
8. Du kan nå bruke standard Azure AD-prosesser for å legge til brukerne dine etter behov. Dette
   er listen over brukere som har tillatelse til å bruke OneDrive og som har en gyldig Microsoft OneDrive-lisens.

Konfigurer Microsoft OneDrive-koblingen

Merk: For å gjøre koblingen tilgjengelig for bruk i organisasjonens kjeder, må en sikkerhetsadministrator i organisasjonen først aktivere den fra Konfigurasjon .

1. Fra Kjedebygger klikker du på Tilkoblinger compare_arrows og deretter på Opprett øverst til høyre.
2. Under Koblingstilkobling velger du Microsoft OneDrive og standard CloudRunner.
   
3. Under Grunnleggende informasjon skriver du inn et unikt navn og en beskrivelse for å identifisere koblingen.
4. Under OAuth skriver du inn OAuth-klient-ID-en og -hemmeligheten for koblingens Azure-applikasjon.
   
5. For å bestemme koblingens tilgangsnivå, angi Azure-applikasjonens autentiseringsomfang .
   Som et minimum kreves omfanget offline_access .
6. For å autorisere tilkoblingen og OAuth-legitimasjonen, klikk på Koble til .

7. Under Egenskaper skriver du inn tilkoblingsdetaljene:
   

   Egenskap	Detaljer
   Stasjonstype	Velg typen stasjon du vil koble til, for eksempel Stasjon, Gruppe, Bruker eller Sted. For å koble til din egen brukerstasjon, velg Gjeldende bruker (meg) .
   Stasjonstype-ID	Skriv inn ID-en til stasjonen du skal koble til, basert på Stasjonstype . Hvis for eksempel Stasjonstype er «Bruker», skriver du inn bruker-ID-en. Hvis det er «Sted», skriver du inn steds-ID-en.

   Merk: Du kan bruke Microsofts Graph Explorer for å hente disse fra SharePoint.

8. Velg miljøene som skal brukes med tilkoblingen, og klikk på Lagre .
9. For å teste tilkoblingen, opprett og kjør en kjede med -koblingens Last ned fil -kommando , og bekreft at den returnerer en gyldig utdata.

Feilsøking

Hvis tilkoblingen til Microsoft OneDrive eller SharePoint mislykkes:

• Kontroller at koblingens OAuth-legitimasjon for Azure-applikasjonen er til stede, korrekt og gyldig. OAuth-legitimasjon har definerte utløpsdatoer, og sertifikatet kan ha utløpt. Hvis dette er tilfelle, må du opprette et nytt sertifikat og angi den nye klienthemmeligheten i koblingen. Se
  Opprette sertifikater og hemmeligheter for detaljer om hvordan du oppretter en ny hemmelighet.
• Sjekk stasjonstypen og ID-en som er angitt for kontakten. Du kan bruke Microsofts Graph Explorer for å hente disse fra Sharepoint.
• Bekreft prosjektets omdirigerings-URI:
  • PRODUKT: https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
  • Asia-Stillehavsregionen: 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