De Graph API configureren (Excel, OneDrive)

Vereisten

• Een Office 365 beheerdersaccount
• Rechten om API-machtigingen te verlenen
• Een serviceaccount met toegang tot OneDrive

Binnen Azure

Registreer een aanvraag

1. Ga naar portal.azure.com en meld u aan met een beheerdersaccount
2. Ga naar Azure Active Directory
3. Ga naar App registraties
4. Klik op + Nieuwe registratie
   1. Geef deze toepassing een naam, bijvoorbeeld: GoBright Bekijk
   2. Ondersteunde accounttypes: Alleen accounts in deze organisatiedirectory (Single Tenant)
   3. Klik Registreer
      

Maak een klantgeheim

1. Open de app die je net geregistreerd hebt
2. Ga naar Gecertificeerd & geheimen
3. Ga naar Klantengeheimen
4. Klik op + Nieuw cliëntengeheim
   1. Beschrijving - Geef het een beschrijving
   2. Verloopt - stel een vervaldatum in
   3. Markeer deze datum in uw agenda en vergeet niet het geheim te vernieuwen voor het verstrijkt
   4. Noteer de Geheime Waarde, want deze wordt maar één keer weergegeven. Deze waarde is later nodig binnen GoBright View. De Geheime ID hebben we niet nodig.
      Als u de Geheime Waarde bent vergeten of vergeten, verwijder dan dit Klantgeheim en maak een nieuwe aan.

API-rechten instellen

1. Open de app die je net gemaakt hebt
2. Ga naar API-machtigingen
3. Klant + Een toestemming toevoegen
4. Selecteer Microsoft Graph
5. Kies Gedelegeerde machtigingen
6. Voeg deze rechten toe:
   1. Directory.AccessAsUser.All (gedelegeerd)
   2. Bestanden.lezen.alle (gedelegeerd)
   3. User.Read (Gedelegeerd)
7. Klik op Beheerders toestemming verlenen voor [Azure-Domain]
8. Ga naar Overzicht
   1. Noteer de ID van de toepassing (cliënt)
   2. Noteer de Directory (huurder) ID

Maak een service account aan

1. Ga naar Azure Active Directory
2. Ga naar Gebruikers
3. Klik op + Nieuwe gebruiker en vervolgens op + Nieuwe gebruiker aanmaken
   1. Selecteer sjabloon - Gebruiker aanmaken
   2. Identiteit
      1. Gebruikersnaam - bijvoorbeeld: gobright-view@[Azure-Domain]
      2. Naam - bijvoorbeeld: GoBright Bekijk Service Account
   3. Wachtwoord
      1. Kies Automatisch wachtwoord genereren of Laat mij het wachtwoord maken
      2. Schrijf het wachtwoord op.
   4. Klik op Maken
   5. Open de gebruiker
   6. Ga naar Licenties
   7. Klik + Opdrachten
      1. Selecteer Microsoft 365 Business Basic
         Deze licentie bevat OneDrive toegang die we nodig hebben.
      2. Klik op Opslaan

U zou nu over deze informatie moeten beschikken:

1. ID van de toepassing (cliënt)
2. Directory (huurder) ID
3. Geheime waarde cliënt
4. Gebruikersnaam van de dienstaccount
5. Wachtwoord van de dienstaccount

Dit waren alle stappen die moeten worden uitgevoerd door een Azure Admin. Geef deze credentials door aan degenen die doorgaan met het opzetten hiervan. Raadpleeg de volgende gidsen om verder te gaan:

Excel 365

OneDrive diavoorstelling

Vereisten

• Een Office 365 beheerdersaccount
• Rechten om API-machtigingen te verlenen

Binnen Azure

De volgende stappen moeten worden genomen om de Graph API te configureren:

Registreer een aanvraag

• https://portal.azure.com/#home
• Navigeer naar Azure Active Directory
• Druk op App registraties
  
• Een nieuwe registratie aanmaken
• Voer een naam in (bijv. GoBright View)
• Laat de andere instellingen op standaard staan en druk op de Registreer knop onderaan

Stel machtigingen in

• Open de toepassing en druk op de API-machtigingen bekijken knop
  
• Druk op de knop Toestemming toevoegen en een nieuw venster wordt geopend
• Selecteer Microsoft Graph wanneer u om een API wordt gevraagd
• Stel het type toestemming in op Toepassingspermissies
• Een lange lijst van rechten wordt getoond, afhankelijk van welke toepassingen je gaat gebruiken moeten de volgende rechten worden toegekend:
  • APIConnectors.Read.All - Type: Application - Voor authenticatie
  • Application.Read.All - Type: Application - Voor navigatie
  • Directory.Read.All - Type: Applicatie - Voor navigatie tussen verschillende mappen
  • Files.Read.All - Type: Application - Gebruikt door OneDrive
  • Rapporten.lezen.alle - Type: Toepassing - Gebruikt door Excel
  • Sites.Read.All - Type: Application - Gebruikt door SharePoint

    Zorg ervoor dat de permissies zijn toegekend als "Applicatie" permissies.

• Wanneer de juiste rechten zijn toegevoegd druk dan op de Verleen admin toestemming knop
  

Verzamel alle informatie en maak een cliëntengeheim

Om verbinding te maken met de applicatie, heeft GoBright View drie stukjes informatie nodig:

• Klant ID: Deze is te vinden op de overzichtspagina
• Clientgeheim: moet worden aangemaakt in Certificaten & geheimen
• Huurder ID: Deze is te vinden op de overzichtspagina

Laten we eerst de Klant ID en Huurder ID kopiëren van het Overzicht binnen de applicatie. Deze zijn te vinden bovenaan de pagina:

De volgende is de waarde van het Clientgeheim, hiervoor moeten we naar Certificaten & geheimen gaan.

Het Klantgeheim bestaat uit een ID en een Waarde, we hebben de Waarde nodig.

• Maak een Nieuw cliëntengeheim onderaan deze pagina
• U kunt een beschrijving toevoegen(b.v. gebruik binnen GoBright View)
• Kies wanneer de sleutel verloopt(let op: we raden aan om de vervaldatum zo ver mogelijk in de toekomst te zetten. Stel ook een herinnering in om deze sleutel te vernieuwen.
• Wanneer het Klantgeheim is aangemaakt, kopieer en noteer onmiddellijk de Geheime Waarde, aangezien deze maar één keer zal worden getoond. Als u de Waarde niet heeft gekregen, kunt u deze stappen verwijderen om een nieuwe te maken. We hebben de Secret ID niet nodig.

Dat is alle informatie die we nodig hebben, nu kunnen we deze informatie gebruiken binnen de GoBright Widget.