OAuth2 Microsoft Service: Unterschied zwischen den Versionen

Aus MoodleDocs
Wechseln zu:Navigation, Suche
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
Zeile 1: Zeile 1:
{{OAuth2}}
{{OAuth2}}
{{Zum Übersetzen}}
{{Neu}}
{{Neu}}


Zeile 8: Zeile 6:
*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|400px]]
:[[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|400px]]
:[[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|400px]]
:[[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|150px]]
:[[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|400px]]
:[[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>''.
:'''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>''.
:Es ist wichtig, dass Ihre Moodle Site unter '''https''' (und nicht unter '''http''') läuft. Microsoft erlaubt sonst keinen Callback.
:[[File:microsoft-4-platform-settings.png|400px]]
:[[File:microsoft-4-platform-settings.png|400px]]
*Make sure the "Microsoft Graph Permissions" section contains the "User.Read" permission.
*Stellen Sie sicher, dass im Abschnitt ''Microsoft Graph Permissions'' das Recht ''User.Read'' eingetragen ist.
:[[File:microsoft-5-permissions.png|400px]]
:[[File:microsoft-5-permissions.png|400px]]
*Set the options for the consent screen.
*Tragen Sie die Einstellungen für die Einverständniserklärung ein.
:[[File:microsoft-6-consent.png|400px]]
:[[File:microsoft-6-consent.png|400px]]
*Save all the details and then generate a new password.
*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-7-new-password.png|400px]]
:[[File:microsoft-7-new-password.png|400px]]
*Enter the password in Moodle as the "Client secret" and the Application ID as the "Client id".
*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]]
:[[File:microsoft-8-got-it.png|400px]]



Version vom 19. Juni 2017, 08:51 Uhr

Neue Funktionalität
in Moodle 3.6!


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