Microsoft Office 365 biedt instellingen een verzameling services voor zakelijke communicatie en productiviteit. Afhankelijk van de gekozen licentie kunnen deze services Exchange Online, SharePoint Online, OneNote, Lync Online en Office Professional Plus omvatten.
Dankzij hun integratieoplossingen verbeteren Brightspace® en Microsoft Office 365-services (E-mail, Agenda en meer) de manier waarop cursisten en docenten online communiceren. Instellingen kunnen kiezen uit alle integratieoplossingen die geschikt zijn voor hun gebruikers.
Browserinstellingen voor de Microsoft Office 365-widget
Gebruikerssessies in de Microsoft Office 365-widget worden opgeslagen op uw Brightspace®-account en zijn niet gekoppeld aan uw browsersessie. Hierdoor hoeft u zich niet telkens opnieuw aan te melden bij Office 365 wanneer u Brightspace® gebruikt.
Wanneer u zich aanmeldt via uw browser, wordt het eerste e-mailadres dat u gebruikt, opgeslagen in uw cookies. Elke volgende aanmelding vanuit uw browsersessie gebruikt dit e-mailadres. Het kan nodig zijn om uw cache te wissen of uw browsersessie opnieuw in te stellen om u met een ander e-mailadres bij de widget aan te melden.
Integratie instellen voor de Microsoft Office 365-widget
Om uw integratie van de Microsoft Office 365-widget in Brightspace® in te stellen, moet u verschillende taken uitvoeren, die verder worden uitgelegd in de volgende secties:
- Registreer Brightspace® bij Microsoft Azure.
- Schakel de Microsoft Office 365 in Brightspace® in.
- Configureer Brightspace® voor de Microsoft Office 365-plug-in.
- Voeg de widget toe aan een cursus of startpagina.
Brightspace® registreren bij Microsoft Azure
Als u toegang wilt krijgen tot beveiligde Microsoft Office 365-services in Brightspace®, moet u uw versie toegang verlenen tot deze services. Hiertoe registreert u Brightspace® bij een Microsoft Azure-tenant en vervolgens configureert u Brightspace® met de resulterende client(applicatie)-id en -sleutel. D2L® raadt aan om een instantie van één tenant te maken in plaats van instanties van meerdere tenants.
Zorg ervoor dat u over uw Azure AD-verificatiegegevens beschikt voordat u begint. Deze verificatiegegevens zijn een combinatie van een gebruikersnaam en wachtwoord.
Raadpleeg Snelstart: Een toepassing registreren bij het Microsoft Identity Platform voor gedetailleerde informatie.
Volg de onderstaande stappen om uw versie toegang te verlenen tot Microsoft Office 365-services. Deze informatie is bedoeld voor gebruikers met ervaring in het navigeren door de Azure-cloud (beheerders). Neem contact op met uw systeembeheerder als u niet zeker weet hoe u deze stappen moet uitvoeren:
- Ga naar de Azure-portal en meld u aan met uw Office 365-aanmeldingsgegevens.
- Selecteer in het linkerdeelvenster de optie Meer services > Azure Active Directory.
- Selecteer App-registraties.
- Selecteer Nieuwe registratie en voer een geschikte weergavenaam in.
- Stel het Type applicatie in op WebApp / API.
- Stel de URI omleiden in op de URL van uw Brightspace®-leeromgeving.
- Klik op Register en noteer de ApplicationId die wordt gegenereerd (deze is later in het proces nodig).
- Ga terug naar het scherm Verificatie. Controleer de URI omleiden. Schakel onder de sectie Impliciete verlening en hybride flows de selectievakjes voor Toegangstokens (gebruikt voor impliciete flows) en ID-tokens (gebruikt voor impliciete en hybride flows) in.
- Klik op Opslaan.
- Klik op de pagina API-machtigingen. Selecteer Een machtiging toevoegen.
- Voeg de API Office 365 SharePoint Online (Microsoft.SharePoint) toe en voeg de gedelegeerde machtiging Mijn bestanden > Gebruikersbestanden lezen toe. Klik vervolgens op Machtiging toevoegen.
- Voeg de Microsoft Graph-API toe en voeg de gedelegeerde machtigingen Kalenders > Gebruikersagenda's lezen, E-mail > Gebruikersmail lezen en Gebruiker > Aanmelden en gebruikersprofiel lezen toe. Klik op Machtiging toevoegen na elke geselecteerde machtiging.
- Zorg ervoor dat de optie Admin-toestemming voor studenten verlenen is geselecteerd. Klik op Ja.
- Selecteer op de pagina Verificatie onder URI's omleiden de optie URI toevoegen.
- Voeg /d2l/im/office365/authentication/authenticatereply toe aan het einde van de URL van uw Brightspace®-leeromgeving.
- Selecteer op de pagina Certificaten & geheimen de optie Nieuw klantgeheim.
- Voeg een geschikte beschrijving toe en kies een geschikte vervaldatum. De maximumwaarde is twee jaar.
-
Klik op Toevoegen en bekijk de sleutel die wordt weergegeven onder Waarde.
-
Kopieer de Waarde. (deze is niet zichtbaar zodra dit proces is voltooid en is vereist in de volgende stappen).
-
Meld u aan bij Brightspace®, selecteer Beheertools en klik op Browser voor configuratievariabelen.
-
Navigeer naar de configuratievariabele d2l.Tools.Office365.ClientId en voeg de ApplicationID uit stap 7 toe als de Organisatiewaarde.
-
Navigeer naar de configuratievariabele d2l.Tools.Office365.ClientSecret en voer de Waarde in die u in stap 19 hebt gekopieerd in als Organisatiewaarde. Let op: In elk tekstvak moet dezelfde waarde worden ingevoerd.
Verificatie van Office 365 Mail, Agenda en SharePoint
Nadat de Azure-tenant is geconfigureerd, werkt de widget alleen als alle services zijn geconfigureerd. De widget heeft toegang tot Office 365 Mail, Agenda en SharePoint, die allemaal beschikbaar moeten zijn wanneer u zich aanmeldt om de widget te laten werken. Gebruikersaccounts vereisen soms wat tijd om deze services in te stellen, dus is het belangrijk dat een gebruiker eerst controleert of hij/zij toegang tot deze services heeft in Office 365.
API-aanroepen
Met de Office 365-widget worden client- en serveraanroepen gedaan naar de API's van Microsoft Office 365 om gebruikersgegevens te verifiëren en op te halen uit de e-mail-, agenda- en OneDrive-account van een gebruiker.
Opmerking: deze aanvragen worden bepaald door Microsoft en kunnen worden gewijzigd als de API's veranderen.
Aan de clientzijde
De aanvragen die aan de clientzijde in de browser worden gedaan zijn:
Serverzijde
De aanvragen die aan de serverzijde worden gedaan zijn:
De laatste URL voor de SharePoint-aanroepen wordt teruggezonden naar het Brightspace®-platform van de eerdere Microsoft-aanroepen. De tenant van elke organisatie kan anders zijn en het pad van elke gebruiker kan anders zijn. Raadpleeg https://msdn.microsoft.com/en-us/office/office365/api/files-rest-operations voor meer informatie.