Konfigurering av Graph API (Excel, OneDrive)
For å kommunisere med Excel 365, OneDrive og andre produkter som er en del av Office 365, vil vi bruke den såkalte Graph API for å etablere en forbindelse med GoBright Utsikt. I trinnene nedenfor finner du alle krav til konfigurasjon.
Husk at disse trinnene bare kan utføres av en Azure-administrator.
Hvordan gjør det GoBright få tilgang til filen(e)?
GoBright View har tilgang til Excel-filen eller bildefilen(e) ved hjelp av en tjenestekonto. Filen(e) kan enten deles med (1) tjenestekontoen eller eies av (2) tjenestekontoen.
- En bruker oppretter en fil eller mappe et sted i OneDrive og gir deretter tjenestekontoen tilgang til den filen eller mappen (detaljert trinn nedenfor).
- Filen eller mappen kan opprettes i OneDrive til selve tjenestekontoen.
Bruke en tjenestekonto
Krav
- En Office 365-administratorkonto
- Rettigheter til å gi API-tillatelser
- En tjenestekonto med OneDrive-tilgang
Innenfor Azure
Registrer en søknad
- Gå til portal.azure.com og logg på med en adminkonto
- Gå til Azure Active Directory
- Gå til App-registreringer
- Klikk på + Ny registrering
- Gi denne applikasjonen et navn, for eksempel: GoBright Utsikt
- Støttede kontotyper: Kun kontoer i denne organisasjonskatalogen (enkelt leietaker)
- Klikk på Registrer
Lag en klienthemmelighet
- Åpne appen du nettopp har registrert
- Gå til Sertifisert og hemmeligheter
- Gå til klienthemmeligheter
- Klikk på + Ny klienthemmelighet
- Beskrivelse – Gi den en beskrivelse
- Utløper – angi en utløpsdato
- Merk av denne datoen i kalenderen din og husk å fornye hemmeligheten før den utløper
- Skriv ned den hemmelige verdien da denne bare vises én gang. Denne verdien er nødvendig innenfor GoBright Se senere. Vi trenger ikke hemmelig ID.
Hvis du gikk glipp av eller glemte den hemmelige verdien, slett denne klienthemmeligheten og lag en ny.
Angi API-tillatelser
- Åpne appen du nettopp har opprettet
- Gå til API-tillatelser
- Klient + Legg til en tillatelse
- Velg Microsoft Graph
- Velg Delegerte tillatelser
- Legg til disse tillatelsene:
- Directory.AccessAsUser.All (delegert)
- Files.Read.All (delegert)
- User.Read (Delegert)
- Klikk Gi administratorsamtykke for [Azure-Domain]
- Gå til Oversikt
- Skriv ned applikasjons-ID (klient).
- Skriv ned Directory (leietaker) ID
Opprett en tjenestekonto
- Gå til Azure Active Directory
- Gå til Brukere
- Klikk på + Ny bruker og deretter + Opprett ny bruker
- Velg mal – Opprett bruker
- Identitet
- Brukernavn – for eksempel: gobright -view@[Azure-Domain]
- Navn – for eksempel: GoBright Se tjenestekonto
- Passord
- Velg autogenerer passord eller La meg opprette passordet
- Skriv ned passordet
- Klikk på Opprett
- Åpne brukeren
- Gå til Lisenser
- Klikk på + Oppdrag
- Velg Microsoft 365 Business Basic
Denne lisensen inkluderer OneDrive-tilgang som vi trenger. - Klikk Lagre
- Velg Microsoft 365 Business Basic
Du bør nå ha denne informasjonen:
- Søknad (klient) ID
- Katalog (leietaker) ID
- Klientens hemmelige verdi
- Brukernavnet til tjenestekontoen
- Passordet til tjenestekontoen
Dette var alle trinn som må utføres av en Azure-administrator. Vennligst oppgi denne legitimasjonen til de som fortsetter å konfigurere dette. Se følgende veiledninger for å fortsette:
Bruke apptillatelser (legacy)
Fra slutten av 2022 støttes ikke dette lenger. Vi har oppdatert GoBright Se widgets deretter. Hvis du fortsatt bruker en eldre widget og ønsker å migrere, vennligst kontakt supportteamet vårt.
Krav
- En Office 365-administratorkonto
- Rettigheter til å gi API-tillatelser
Innenfor Azure
Følgende trinn må tas for å konfigurere Graph API:
Registrer en søknad
- https://portal.azure.com/#home
- Naviger til Azure Active Directory
- Pressen App registreringer
- Opprett en ny registrering
- Skriv inn et navn (f.eks GoBright Utsikt)
- La de andre innstillingene være standard og trykk på Registrer -knappen nederst
Angi tillatelser
- Åpne applikasjonen og trykk på Se API-tillatelser knapp
- Trykk på knappen Legg til en tillatelse og et nytt vindu åpnes
- Velg Microsoft Graph når du blir bedt om en API
- Angi typen tillatelse til Applikasjonstillatelser
- En lang liste med tillatelser vises, avhengig av hvilke applikasjoner du skal bruke, må følgende tillatelser gis:
- APIConnectors.Read.All – Type: Application – For autentisering
- Application.Read.All – Type: Application – For navigering
- Directory.Read.All – Type: Application – For navigering mellom ulike mapper
- Files.Read.All – Type: Applikasjon – Brukes av OneDrive
- Reports.Read.All – Type: Application – Brukes av Excel
- Sites.Read.All – Type: Application – Brukes av SharePoint
Sørg for at tillatelser gis som "Applikasjons"-tillatelser.
- Når de riktige tillatelsene er lagt til, trykk på Gi administratorsamtykke knapp
Samle all informasjon og lag en klienthemmelighet
For å koble til applikasjonen, GoBright View trenger tre typer informasjon :
- Klient-ID: Denne finner du på oversiktssiden
- Klienthemmelighet: Må opprettes i sertifikater og hemmeligheter
- Leietaker-ID: Denne finner du på oversiktssiden
La oss først kopiere klient-ID og leietaker-ID fra oversikten i applikasjonen. Disse finner du øverst på siden:
Neste er klientens hemmelige verdi , for dette må vi gå til sertifikater og hemmeligheter.
Klienthemmeligheten består av en ID og en verdi, vi trenger verdien.
- Opprett en ny klienthemmelighet nederst på denne siden
- Du kan legge til en beskrivelse ( f.eks. bruk i GoBright View )
- Velg når nøkkelen utløper ( merk: vi anbefaler å sette utløpsdatoen til så langt frem i fremtiden som mulig. Angi også en påminnelse om å fornye denne nøkkelen.
- Når klienthemmeligheten er opprettet, kopier og noter den hemmelige verdien umiddelbart, da den kun vises én gang. Hvis du ikke fikk verdien, kan du slette disse trinnene for å opprette en ny. Vi trenger ikke hemmelig ID.
Det er all informasjonen vi trenger, deretter kan vi bruke denne informasjonen innenfor GoBright Widget.