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.
- 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).
- 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
- Gå til portal.azure.com, og log ind med en administratorkonto
- Gå til Azure Active Directory
- Gå til App-registreringer
- Klik på + Ny registrering
- Giv denne applikation et navn, for eksempel: GoBright View
- Understøttede kontotyper: Kun konti i denne organisationsmappe (enkelt lejer)
- Klik på Registrer
Opret en klienthemmelighed
- Åbn den app, du lige har registreret
- Gå til Certificerede & hemmeligheder
- Gå til klienthemmeligheder
- Klik på + Ny klienthemmelighed
- Beskrivelse - Giv den en beskrivelse
- Udløber - indstil en udløbsdato
- Marker denne dato i din kalender, og husk at forny hemmeligheden, før den udløber.
- 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
- Åbn den app, du lige har oprettet
- Gå til API-tilladelser
- Klient + Tilføj en tilladelse
- Vælg Microsoft Graph
- Vælg delegerede tilladelser
- Tilføj disse tilladelser:
- Directory.AccessAsUser.All (delegeret)
- Filer.læs.alle (uddelegeret)
- User.Read (delegeret)
- Klik på Giv administratortilladelse til [Azure-domæne].
- Gå til oversigt
- Skriv applikationens (klientens) ID ned
- Skriv Directory-id'et (lejer-id'et) ned
Opret en servicekonto
- Gå til Azure Active Directory
- Gå til brugere
- Klik på + Ny bruger og derefter på + Opret ny bruger
- Vælg skabelon - Opret bruger
- Identitet
- Brugernavn - for eksempel: gobright[Azure-Domain].
- Navn - for eksempel: GoBright View Service-konto
- Adgangskode
- Vælg automatisk generering af adgangskode eller Lad mig oprette adgangskoden
- Skriv adgangskoden ned
- Klik på Opret
- Åbn brugeren
- Gå til Licenser
- Klik på + Opgaver
- Vælg Microsoft 365 Business Basic
Denne licens inkluderer OneDrive-adgang, som vi har brug for. - Klik på Gem
- Vælg Microsoft 365 Business Basic
Du bør nu have disse oplysninger:
- Applikation (klient) ID
- Directory (lejer) ID
- Klientens hemmelige værdi
- Brugernavn på servicekontoen
- 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:
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
- 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
- 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
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:
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.
- 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.