Konfiguration af Graph API (Excel, OneDrive)

For at kunne kommunikere med Excel 365, OneDrive og andre produkter, der er en del af Office 365, bruger vi den såkaldte Graph API til at etablere en forbindelse med GoBright View. I nedenstående trin finder du alle krav til konfigurationen.

Husk, at disse trin kun kan udføres af en Azure-administrator.

Hvordan får GoBright adgang til filen/filerne?

GoBright View har adgang til Excel-filen eller billedfilen (-erne) ved hjælp af en servicekonto. Filerne kan enten deles med (1) servicekontoen eller ejes af (2) servicekontoen.

  1. En bruger opretter en fil eller mappe et sted i sit OneDrive og giver derefter servicekontoen adgang til den fil eller mappe (detaljerede trin nedenfor).
  2. Filen eller mappen kan oprettes i OneDrive på selve servicekontoen.
Brug af en servicekonto

Kravene

  • En Office 365-administratorkonto
  • Rettigheder til at give API-tilladelser
  • En servicekonto med OneDrive-adgang

Inden for Azure

Registrer en ansøgning

  1. Gå til portal.azure.com, og log ind med en administratorkonto
  2. Gå til Azure Active Directory
  3. Gå til App-registreringer
  4. Klik på + Ny registrering
    1. Giv denne applikation et navn, for eksempel: GoBright View
    2. Understøttede kontotyper: Kun konti i denne organisationsmappe (enkelt lejer)
    3. Klik på Registrer
       Knappen 'Registrer' i Microsoft AzureAD

Opret en klienthemmelighed

  1. Åbn den app, du lige har registreret
  2. Gå til Certificerede & hemmeligheder
  3. Gå til klienthemmeligheder
  4. Klik på + Ny klienthemmelighed
    1. Beskrivelse - Giv den en beskrivelse
    2. Udløber - indstil en udløbsdato
    3. Marker denne dato i din kalender, og husk at forny hemmeligheden, før den udløber.
    4. Skriv den hemmelige værdi ned, da den kun vises én gang. Denne værdi er nødvendig i GoBright View senere. Vi har ikke brug for det hemmelige ID.
      Hvis du overså eller glemte den hemmelige værdi, skal du slette denne klienthemmelighed og oprette en ny.

Indstil API-tilladelser

  1. Åbn den app, du lige har oprettet
  2. Gå til API-tilladelser
  3. Klient + Tilføj en tilladelse
  4. Vælg Microsoft Graph
  5. Vælg delegerede tilladelser
  6. Tilføj disse tilladelser:
    1. Directory.AccessAsUser.All (delegeret)
    2. Filer.læs.alle (uddelegeret)
    3. User.Read (delegeret)
  7. Klik på Giv administratortilladelse til [Azure-domæne].
  8. Gå til oversigt
    1. Skriv applikationens (klientens) ID ned
    2. Skriv Directory-id'et (lejer-id'et) ned

Opret en servicekonto

  1. Gå til Azure Active Directory
  2. Gå til brugere
  3. Klik på + Ny bruger og derefter på + Opret ny bruger
    1. Vælg skabelon - Opret bruger
    2. Identitet
      1. Brugernavn - for eksempel: gobright[Azure-Domain].
      2. Navn - for eksempel: GoBright View Service-konto
    3. Adgangskode
      1. Vælg automatisk generering af adgangskode eller Lad mig oprette adgangskoden
      2. Skriv adgangskoden ned
    4. Klik på Opret
    5. Åbn brugeren
    6. Gå til Licenser
    7. Klik på + Opgaver
      1. Vælg Microsoft 365 Business Basic
        Denne licens inkluderer OneDrive-adgang, som vi har brug for.
      2. Klik på Gem

Du bør nu have disse oplysninger:

  1. Applikation (klient) ID
  2. Directory (lejer) ID
  3. Klientens hemmelige værdi
  4. Brugernavn på servicekontoen
  5. Adgangskode til servicekontoen

Alle disse trin skal udføres af en Azure-administrator. Giv venligst disse legitimationsoplysninger til dem, der fortsætter med at sætte dette op. Se følgende vejledninger for at fortsætte:

Excel 365

OneDrive-slideshow

Brug af app-tilladelser (ældre)

Fra slutningen af 2022 understøttes dette ikke længere. Vi har opdateret GoBright View-widgetterne i overensstemmelse hermed. Hvis du stadig bruger en ældre widget og ønsker at migrere, bedes du kontakte vores supportteam.

Kravene

  • En Office 365-administratorkonto
  • Rettigheder til at give API-tilladelser

Inden for Azure

Følgende trin skal tages for at konfigurere Graph API:

Registrer en ansøgning

  • https://portal.azure.com/#home
  • Naviger til Azure Active Directory
  • Tryk på App-registreringer
    mceclip0.png
  • Opret en ny registrering
  • Indtast et navn (f.eks. GoBright View)
  • Lad de andre indstillinger være standard, og tryk på knappen Register i bunden.

Indstil tilladelser

  • Åbn programmet, og tryk på Se API-tilladelser knap
    mceclip1.png
  • Tryk på knappen Tilføj en tilladelse, og et nyt vindue åbnes
  • Vælg Microsoft Graph, når du bliver bedt om at vælge en API
  • Indstil typen af tilladelse til Applikationstilladelser
  • Der vises en lang liste med tilladelser, og afhængigt af hvilke programmer du bruger, skal følgende tilladelser gives:
    • APIConnectors.Read.All - Type: Applikation - Til godkendelse
    • Application.Read.All - Type: Applikation - Til navigation
    • Directory.Read.All - Type: Applikation - Til navigation mellem forskellige mapper
    • Files.Read.All - Type: Applikation - Brugt af OneDrive
    • Reports.Read.All - Type: Applikation - Brugt af Excel
    • Sites.Read.All - Type: Ansøgning - Bruges af SharePoint

      Sørg for, at tilladelserne er givet som "Application"-tilladelser.

  • Når de korrekte tilladelser er tilføjet, skal du trykke på Giv administratorens samtykke knap
    mceclip2.png

Saml alle oplysninger, og opret en klienthemmelighed

For at få forbindelse med applikationen skal GoBright View bruge tre oplysninger:

  • Klient-id: Dette kan findes på oversigtssiden
  • Klienthemmelighed: Skal oprettes under Certifikater og hemmeligheder
  • Lejers ID: Dette kan findes på oversigtssiden

Lad os først kopiere klient-id 'et og lejer-id 'et fra oversigten i applikationen. De findes øverst på siden:

mceclip3.png

Det næste er klientens hemmelige værdi, og her skal vi gå til Certifikater og hemmeligheder.

Klienthemmeligheden består af et ID og en værdi, og vi skal bruge værdien.

Piktogram for certifikater og hemmelige værdier

  • Opret en ny kundehemmelighed nederst på denne side
  • Du kan tilføje en beskrivelse (f.eks. brug i GoBright View)
  • Vælg, hvornår nøglen skal udløbe(bemærk: Vi anbefaler at indstille udløbsdatoen så langt ude i fremtiden som muligt. Indstil også en påmindelse om at forny denne nøgle.
  • Når klienthemmeligheden er oprettet, skal du straks kopiere og notere den hemmelige værdi, da den kun vises én gang. Hvis du ikke fik værdien, kan du slette disse trin for at oprette en ny. Vi har ikke brug for det hemmelige ID.

Det er alle de oplysninger, vi har brug for, og nu kan vi bruge dem i GoBright Widget.

Denne artikel kommer fra GoBright hjælpecenter.

Se den oprindelige artikel

Ofte Stillede Spørgsmål

Spørg os om hvad som helst! Find svarene på de oftest stillede spørgsmål her.

Gennemse de ofte stillede spørgsmål

Hjælpecenter

En guldgrube for alle IT- og Facility Managers. Dyk ned i det tekniske omkring vores produkter og løsninger.

Besøg hjælpecentret

Nyhedsbrev

Vil du holde dig orienteret om al udvikling inden for smart office og vores nye funktioner? Tilmeld dig nu.

Tilmeld dig nu