Deze handleiding beschrijft hoe u SmartSpeaker integreert met uw D2L Brightspace-instantie met behulp van uw Client-ID en Client secret. Zorg ervoor dat u toegang hebt tot uw SmartSpeaker-platform voordat u de onderstaande stappen uitvoert. Neem bij vragen over de stappen in dit proces contact op met uw vaste accountmanager.
Een D2L Brightspace Client-ID en secret genereren
- Meld u als Super Admin aan bij D2L Brightspace.
- Klik op het tandwiel > Uitbreidbaarheid beheren.
- Klik op OAuth 2.0 > Een app registreren.
- Vul de gegevens in zoals hieronder weergegeven.
- Applicatienaam: SmartSpeaker OAuth API
-
Omleidings-URL: Voer de URL in op basis van uw zone.
- VS-zone: https://smartspeaker-api.yuja.com/d2l-auth/oauth
- CA-zone: https://smartspeaker-api-cz.yuja.com/d2l-auth/oauth
- EU-zone: https://smartspeaker-api-ez.yuja.com/d2l-auth/oauth
- AUS-zone: https://smartspeaker-api-az.yuja.com/d2l-auth/oauth
-
Bereik: U kunt twee bereiken invoeren, afhankelijk van het toegangsniveau dat u aan SmartSpeaker wilt verlenen.
-
Standaard (aanbevolen): Met het standaardbereik is SmartSpeaker toegankelijk in alle cursusinhoud, inclusief de sectie Opdrachten. Kopieer en plak het volgende bereik om deze machtigingen te verlenen:
- organizations:organization:read orgunits:course:read enrollment:orgunit:read checklists:checklist:read content:modules:readonly content:topics:readonly content:file:read content:toc:read discussions:forums:readonly discussions:topics:readonly dropbox:folders:read managefiles:files:read news:newsitems:read quizzing:quizzes:read surveys:surveys:read checklists:checklist:write content:modules:manage content:topics:manage discussions:forums:manage discussions:topics:manage dropbox:folders:write managefiles:files:manage news:newsitems:manage quizzing:quizzes:write surveys:surveys:update core:*:*
-
Toegang tot opdrachten uitschakelen: Als u SmartSpeaker GEEN toegang wilt geven tot de sectie Opdrachten van uw D2L Brightspace-instantie, kopieer en plak dan het volgende bereik:
- organizations:organization:read orgunits:course:read enrollment:orgunit:read checklists:checklist:read content:modules:readonly content:topics:readonly content:file:read content:toc:read discussions:forums:readonly discussions:topics:readonly dropbox:folders:read managefiles:files:read news:newsitems:read quizzing:quizzes:read surveys:surveys:read checklists:checklist:write content:modules:manage content:topics:manage discussions:forums:manage discussions:topics:manage dropbox:folders:write managefiles:files:manage news:newsitems:manage quizzing:quizzes:write surveys:surveys:update
-
Standaard (aanbevolen): Met het standaardbereik is SmartSpeaker toegankelijk in alle cursusinhoud, inclusief de sectie Opdrachten. Kopieer en plak het volgende bereik om deze machtigingen te verlenen:
- Levensduur van toegangstoken (seconden): 7200
-
Vink het volgende aan:
- Vraag om toestemming van de gebruiker
- Vernieuwingstokens inschakelen
- Ik accepteer de ontwikkelaarsovereenkomst voor niet-commercieel gebruik (Non-Commercial Developer Agreement)
- Klik op Registreren.
- U wordt doorgestuurd naar de details van de geregistreerde app. Noteer de Client-ID en het Client secret, want u hebt deze nodig om de installatie te voltooien in het volgende gedeelte van deze handleiding.
D2L Brightspace integreren met SmartSpeaker
Nadat u uw Client-ID en Client secret hebt verkregen, moet u een verbinding tot stand brengen tussen uw D2L Brightspace-instantie en SmartSpeaker.
- Meld u aan bij uw SmartSpeaker-platform. Klik op Configuratie, en selecteer vervolgens Integratie-instellingen.
- Kies in het keuzemenu Selecteer integratie de optie LMS API.
- Klik op Toegangssleutel toevoegen.
- Selecteer Client-ID.
- Voer de Client-ID en het Client secret in met de gegevens uit stap 6 van het vorige gedeelte.
- Als u in stap 4 van het vorige gedeelte het standaardbereik hebt geselecteerd, stel dan Toegang tot opdrachten toestaan in op Ingeschakeld. Laat de optie anders uitgeschakeld.
Belangrijk: Als u de optie Schrijftoegang toestaan ziet, zorg er dan voor dat deze is uitgeschakeld. - Klik op Verifiëren met D2L Brightspace.
- Kopieer in het nieuwe tabblad dat wordt geopend het verificatieantwoord en plak het in het daarvoor bestemde veld onder Verificatieantwoord van D2L Brightspace.
- Klik op Toegangssleutel toevoegen.
- Klik op Wijzigingen opslaan. SmartSpeaker kan nu informatie ophalen uit uw D2L Brightspace-instantie. U kunt kiezen tot welke cursussen of organisaties SmartSpeaker toegang heeft via Configuratie > Bereikinstellingen in de navigatiebalk.
SmartSpeaker toevoegen aan de D2L Brightspace-navigatiebalk
Ga verder met dit gedeelte van de handleiding zodra SmartSpeaker met succes is toegevoegd aan uw D2L Brightspace-instantie.
- Meld u aan als beheerder of docent en selecteer de cursus waaraan u het SmartSpeaker-platform wilt toevoegen.
- Klik vervolgens op het pictogram Acties voor navigatiebalk en selecteer Deze navigatiebalk bewerken.
- Voer een naam in voor de navigatiebalk.
- Klik op Links toevoegen.
- Klik op Aangepaste link maken.
- Voer in het veld Naam SmartSpeaker in en klik vervolgens op Quicklink invoegen.
- Zoek en selecteer Externe tool in de lijst met cursusmateriaal.
- Gebruik de zoekbalk om naar de SmartSpeaker-tool te zoeken.
- Klik op de tool om deze toe te voegen aan uw aangepaste link.
- Stel het gedrag in op Hetzelfde venster en klik op Maken om de SmartSpeaker-tool aan uw navigatiebalk toe te voegen.