Hinweis: Sie sind auf den Seiten der Moodle 3.3 Dokumentation. Die Dokumentation der aktuellsten Moodle-Version finden Sie hier: OAuth2 Microsoft Service.

OAuth2 Microsoft Service: Unterschied zwischen den Versionen

Aus MoodleDocs
Wechseln zu:Navigation, Suche
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(3 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
{{OAuth2}}
{{OAuth2}}
{{Zum Übersetzen}}
{{Neu}}
{{Neu}}


Zeile 7: Zeile 5:
Um einen OAuth2 Client für Microsoft aufzusetzen, müssen Sie sich als erstes eine neue App anlegen.
Um einen OAuth2 Client für Microsoft aufzusetzen, müssen Sie sich als erstes eine neue App anlegen.
*Melden Sie sich auf der Seite [https://apps.dev.microsoft.com/#/appList Microsoft Application Console] an und klicken Sie auf den Button ''Add an app''.
*Melden Sie sich auf der Seite [https://apps.dev.microsoft.com/#/appList Microsoft Application Console] an und klicken Sie auf den Button ''Add an app''.
:[[Image:microsoft-1-create-new.png|300px]]
:[[Image:microsoft-1-create-new.png|400px]]
:'''Hinweis''': If you have previously registered Applications with an older API your Application Console may look different. In this case you should create a new "Converged Application".
:'''Hinweis''': Wenn Sie bereits früher Applikationen mit einer älteren API angelegt haben, dann kann die Seite anders aussehen. In diesem Fall müssen Sie eine neue ''Converged application'' anlegen.
:[[File:microsoft-1-1-alternate-app-page.png|300px]]
:[[File:microsoft-1-1-alternate-app-page.png|400px]]
*Choose a good name as this is what is shown to users when they are asked to approve the permissions.  
*Wählen Sie einen passenden Namen - dieser wird den Nutzer/innen angezeigt, wenn sie sich anmelden sollen.  
:[[File:microsoft-2-name-it.png|300px]]
:[[File:microsoft-2-name-it.png|400px]]
*Next you have to add a platform to your application.  
*Als nächstes müssen Sie eine Plattform hinzufügen. Klicken Sie dazu auf den Button ''Add Platform''.
:[[File:microsoft-3-add-platform.png|300px]]
:[[File:microsoft-3-add-platform.png|150px]]
*Choose "Web platform"
*Klicken Sie auf ''Web'', um eine Web-Applikation anzulegen.
:[[File:microsoft-3.1-web-platform.png|300px]]
:[[File:microsoft-3.1-web-platform.png|400px]]
*Uncheck the "Allow Implicit Flow" checkbox and set the callback URL. The callback URL should point to "your Moodle site URL + /admin/oauth2callback.php". If your Moodle site was available at <nowiki>https://lemon.edu/</nowiki> the callback URL would be <nowiki>https://lemon.edu/admin/oauth2callback.php</nowiki>. It is important that your Moodle site uses https and not http. Microsoft will not allow the callback url if it is not using https.
*Entfernen Sie das Häkchen in der Checkbox ''Allow Implicit Flow'' und tragen Sie die Callback URL zu Ihrer Moodle-Site ein. Diese URLsieht so aus ''<nowiki>IhrMoodleSiteURL + /admin/oauth2callback.php</nowiki>''.
:[[File:microsoft-4-platform-settings.png|300px]]
:'''Beispiel''': Wenn Ihre Moodle-Site unter der URL <nowiki>https://lemon.edu/</nowiki> erreichbar ist, dann lautet die zugehörige Callback URL ''<nowiki>https://lemon.edu/admin/oauth2callback.php</nowiki>''.
*Make sure the "Microsoft Graph Permissions" section contains the "User.Read" permission.
:Es ist wichtig, dass Ihre Moodle Site unter '''https''' (und nicht unter '''http''') läuft. Microsoft erlaubt sonst keinen Callback.
:[[File:microsoft-5-permissions.png|300px]]
:[[File:microsoft-4-platform-settings.png|400px]]
*Set the options for the consent screen.
*Stellen Sie sicher, dass im Abschnitt ''Microsoft Graph Permissions'' das Recht ''User.Read'' eingetragen ist.
:[[File:microsoft-6-consent.png|300px]]
:[[File:microsoft-5-permissions.png|400px]]
*Save all the details and then generate a new password.
*Tragen Sie die Einstellungen für die Einverständniserklärung ein.
:[[File:microsoft-7-new-password.png|300px]]
:[[File:microsoft-6-consent.png|400px]]
*Enter the password in Moodle as the "Client secret" and the Application ID as the "Client id".
*Speichern Sie alle Einstellungen und klicken Sie dann auf den Button ''Generate New Password'', um eine Client ID und ein Client Passwort für Moodle zu erzeugen.
:[[File:microsoft-8-got-it.png|300px]]
:[[File:microsoft-7-new-password.png|400px]]
*Gehen Sie in Moodle auf die Seite ''Website-Administration > Server > OAuth 2 Services'', klicken Sie auf den Button ''Neuen Microsoft Service anlegen'' und tragen Sie diese Client ID und das Client Kennwort ein.
:[[File:microsoft-8-got-it.png|400px]]


==Siehe auch==
==Siehe auch==

Aktuelle Version vom 19. Juni 2017, 09:14 Uhr

Neue Funktionalität
in Moodle 3.3!


Einen OAuth2 Client für Microsoft aufsetzen

Um einen OAuth2 Client für Microsoft aufzusetzen, müssen Sie sich als erstes eine neue App anlegen.

microsoft-1-create-new.png
Hinweis: Wenn Sie bereits früher Applikationen mit einer älteren API angelegt haben, dann kann die Seite anders aussehen. In diesem Fall müssen Sie eine neue Converged application anlegen.
microsoft-1-1-alternate-app-page.png
  • Wählen Sie einen passenden Namen - dieser wird den Nutzer/innen angezeigt, wenn sie sich anmelden sollen.
microsoft-2-name-it.png
  • Als nächstes müssen Sie eine Plattform hinzufügen. Klicken Sie dazu auf den Button Add Platform.
microsoft-3-add-platform.png
  • Klicken Sie auf Web, um eine Web-Applikation anzulegen.
microsoft-3.1-web-platform.png
  • Entfernen Sie das Häkchen in der Checkbox Allow Implicit Flow und tragen Sie die Callback URL zu Ihrer Moodle-Site ein. Diese URLsieht so aus IhrMoodleSiteURL + /admin/oauth2callback.php.
Beispiel: Wenn Ihre Moodle-Site unter der URL https://lemon.edu/ erreichbar ist, dann lautet die zugehörige Callback URL https://lemon.edu/admin/oauth2callback.php.
Es ist wichtig, dass Ihre Moodle Site unter https (und nicht unter http) läuft. Microsoft erlaubt sonst keinen Callback.
microsoft-4-platform-settings.png
  • Stellen Sie sicher, dass im Abschnitt Microsoft Graph Permissions das Recht User.Read eingetragen ist.
microsoft-5-permissions.png
  • Tragen Sie die Einstellungen für die Einverständniserklärung ein.
microsoft-6-consent.png
  • Speichern Sie alle Einstellungen und klicken Sie dann auf den Button Generate New Password, um eine Client ID und ein Client Passwort für Moodle zu erzeugen.
microsoft-7-new-password.png
  • Gehen Sie in Moodle auf die Seite Website-Administration > Server > OAuth 2 Services, klicken Sie auf den Button Neuen Microsoft Service anlegen und tragen Sie diese Client ID und das Client Kennwort ein.
microsoft-8-got-it.png

Siehe auch