Konfigurera Graph API (Excel, OneDrive)
För att kunna kommunicera med Excel 365, OneDrive och andra produkter som ingår i Office 365 använder vi det så kallade Graph API för att upprätta en anslutning till GoBright View. I stegen nedan hittar du alla krav för konfiguration.
Tänk på att dessa steg endast kan utföras av en Azure-administratör.
Hur får GoBright tillgång till filen/filerna?
GoBright View har tillgång till Excel-filen eller bildfilen/bildfilerna med hjälp av ett servicekonto. Filen/filerna kan antingen delas med (1) servicekontot eller ägas av (2) servicekontot.
- En användare skapar en fil eller mapp någonstans i sin OneDrive och ger sedan servicekontot åtkomst till den filen eller mappen (detaljerade steg nedan).
- Filen eller mappen kan skapas i OneDrive för själva servicekontot.
Använda ett servicekonto
Krav och önskemål
- Ett administratörskonto för Office 365
- Rättigheter för att bevilja API-behörigheter
- Ett servicekonto med OneDrive-åtkomst
Inom Azure
Registrera en ansökan
- Gå till portal.azure.com och logga in med ett administratörskonto
- Gå till Azure Active Directory
- Gå till App-registreringar
- Klicka på + Ny registrering
- Ge denna applikation ett namn, till exempel: GoBright Visa
- Kontotyper som stöds: Endast konton i denna organisationskatalog (Single Tenant)
- Klicka på Registrera
Skapa en klienthemlighet
- Öppna den app som du just har registrerat
- Gå till Certifierade & hemligheter
- Gå till klienthemligheter
- Klicka på + Ny klienthemlighet
- Beskrivning - Ge den en beskrivning
- Expires - ange ett utgångsdatum
- Markera detta datum i din kalender och kom ihåg att förnya hemligheten innan den löper ut
- Skriv ner det hemliga värdet eftersom det bara visas en gång. Detta värde behövs inom GoBright View senare. Vi behöver inte det hemliga ID:t.
Om du har missat eller glömt det hemliga värdet tar du bort den här klienthemligheten och skapar en ny.
Ange API-behörigheter
- Öppna den app du just har skapat
- Gå till API-behörigheter
- Klient + Lägg till en behörighet
- Välj Microsoft Graph
- Välj Delegerade behörigheter
- Lägg till dessa behörigheter:
- Directory.AccessAsUser.All (delegerad)
- Filer.läs.alla (delegerad)
- User.Read (delegerad)
- Klicka på Ge administratörsmedgivande för [Azure-domän].
- Gå till Översikt
- Skriv ner applikationens (klientens) ID
- Skriv ner Directory (hyresgäst) ID
Skapa ett servicekonto
- Gå till Azure Active Directory
- Gå till Användare
- Klicka på + Ny användare och sedan på + Skapa ny användare
- Välj mall - Skapa användare
- Identitet
- Användarnamn - till exempel: gobright[Azure-Domain]
- Namn - till exempel: GoBright View Servicekonto
- Lösenord
- Välj Autogenererat lösenord eller Låt mig skapa lösenordet
- Skriv ner lösenordet
- Klicka på Skapa
- Öppna användaren
- Gå till Licenser
- Klicka på + Uppdrag
- Välj Microsoft 365 Business Basic
Denna licens inkluderar OneDrive-åtkomst som vi behöver. - Klicka på Spara
- Välj Microsoft 365 Business Basic
Du bör nu ha dessa uppgifter:
- Applikation (klient) ID
- Directory (hyresgäst) ID
- Klientens hemliga värde
- Användarnamn för servicekontot
- Lösenord för servicekontot
Detta var alla steg som måste utföras av en Azure-administratör. Vänligen ge dessa referenser till dem som fortsätter att konfigurera detta. Se följande guider för att fortsätta:
Använda appbehörigheter (äldre)
Från och med slutet av 2022 stöds detta inte längre. Vi har uppdaterat GoBright View-widgetarna i enlighet med detta. Om du fortfarande använder en äldre widget och vill migrera, vänligen kontakta vårt supportteam.
Krav och önskemål
- Ett administratörskonto för Office 365
- Rättigheter för att bevilja API-behörigheter
Inom Azure
Följande steg måste vidtas för att konfigurera Graph API:
Registrera en ansökan
- https://portal.azure.com/#home
- Navigera till Azure Active Directory
- Tryck på Registreringar av appar
- Skapa en ny registrering
- Ange ett namn (t.ex. GoBright View)
- Låt övriga inställningar vara standardinställningar och tryck på Register-knappen på undersidan
Ange behörigheter
- Öppna programmet och tryck på knappen Visa API-behörigheter knapp
- Tryck på knappen Lägg till en behörighet så öppnas ett nytt fönster
- Välj Microsoft Graph när du uppmanas att ange ett API
- Ange typ av behörighet till Application-behörigheter
- En lång lista med behörigheter visas, beroende på vilka applikationer du använder måste följande behörigheter beviljas:
- APIConnectors.Read.All - Typ: Applikation - För autentisering
- Ansökan.läs.alla - Typ: Applikation - För navigering
- Directory.Read.All - Typ: Application - För navigering mellan olika mappar
- Files.Read.All - Typ: Applikation - Används av OneDrive
- Rapporter.läs.alla - Typ: Applikation - Används av Excel
- Sites.Read.All - Typ: Ansökan - Används av SharePoint
Se till att behörigheterna beviljas som "Application"-behörigheter.
- När rätt behörigheter har lagts till trycker du på Ge administratörens samtycke knapp
Samla all information och skapa en kundhemlighet
För att kunna koppla upp sig mot applikationen behöver GoBright View tre typer av information:
- Klient-ID: Detta finns på översiktssidan
- Klienthemlighet: Måste skapas inom Certifikat & hemligheter
- Hyresgästens ID: Detta kan hittas på översiktssidan
Först kopierar vi Client ID och Tenant ID från Overview i programmet. Dessa finns högst upp på sidan:
Nästa är Client Secret Value, för detta måste vi gå till Certifikat & hemligheter .
Klienthemligheten består av ett ID och ett värde, vi behöver värdet.
- Skapa en ny kundhemlighet längst ner på denna sida
- Du kan lägga till en beskrivning (t.ex. användning inom GoBright View)
- Välj när nyckeln ska upphöra att gälla(Obs: vi rekommenderar att du ställer in utgångsdatumet så långt fram i tiden som möjligt. Ställ också in en påminnelse om att förnya nyckeln.
- När klienthemligheten har skapats ska du omedelbart kopiera och notera det hemliga värdet eftersom det bara kommer att visas en gång. Om du inte fick värdet kan du ta bort de här stegen för att skapa ett nytt. Vi behöver inte det hemliga ID:t.
Det är all information vi behöver, sedan kan vi använda den här informationen i GoBright Widget.
