OAuth2 Microsoft Service: Unterschied zwischen den Versionen

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


==Einen OAuth2 Client für Microsoft aufsetzen==
==Einen OAuth2 Client für Microsoft aufsetzen==
Um einen OAuth2 Client für Microsoft aufzusetzen, müssen Sie sich als erstes auf der Seite [https://apps.dev.microsoft.com/#/appList Microsoft Application Console] anmelden und 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''.
[[Image:microsoft-1-create-new.png|none|frame|Create new project]]
:[[Image:microsoft-1-create-new.png|400px]]
 
:'''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.
Note: 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".
:[[File:microsoft-1-1-alternate-app-page.png|400px]]
 
*Wählen Sie einen passenden Namen - dieser wird den Nutzer/innen angezeigt, wenn sie sich anmelden sollen.  
[[File:microsoft-1-1-alternate-app-page.png|none|frame|Create new project with older APIs enabled]]
:[[File:microsoft-2-name-it.png|400px]]
 
*Als nächstes müssen Sie eine Plattform hinzufügen. Klicken Sie dazu auf den Button ''Add Platform''.
Choose a good name as this is what is shown to users when they are asked to approve the permissions.  
:[[File:microsoft-3-add-platform.png|150px]]
 
*Klicken Sie auf ''Web'', um eine Web-Applikation anzulegen.
[[File:microsoft-2-name-it.png|none|frame|Name it]]
:[[File:microsoft-3.1-web-platform.png|400px]]
 
*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>''.
Next you have to add a platform to your application.  
:'''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-3-add-platform.png|none|frame|Add platform]]
:[[File:microsoft-4-platform-settings.png|400px]]
 
*Stellen Sie sicher, dass im Abschnitt ''Microsoft Graph Permissions'' das Recht ''User.Read'' eingetragen ist.
Choose "Web platform"
:[[File:microsoft-5-permissions.png|400px]]
 
*Tragen Sie die Einstellungen für die Einverständniserklärung ein.
[[File:microsoft-3.1-web-platform.png|none|frame|Web platform]]
:[[File:microsoft-6-consent.png|400px]]
 
*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.
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.
:[[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-4-platform-settings.png|none|frame|Platform settings]]
:[[File:microsoft-8-got-it.png|400px]]
 
Make sure the "Microsoft Graph Permissions" section contains the "User.Read" permission.
 
[[File:microsoft-5-permissions.png|none|frame|Permissions]]
 
Set the options for the consent screen.
 
[[File:microsoft-6-consent.png|none|frame|Consent]]
 
Save all the details and then generate a new password.
 
[[File:microsoft-7-new-password.png|none|frame|Generate a new password]]
 
Enter the password in Moodle as the "Client secret" and the Application ID as the "Client id".
 
[[File:microsoft-8-got-it.png|none|frame|Got it]]


==Siehe auch==
==Siehe auch==
Zeile 50: Zeile 31:
* [[OAuth2 Authentifizierung]] - ermöglicht es Nutzer/innen, sich mit ihrem Microsoft-Nutzerkonto in Moodle anzumelden
* [[OAuth2 Authentifizierung]] - ermöglicht es Nutzer/innen, sich mit ihrem Microsoft-Nutzerkonto in Moodle anzumelden


[[en:OAuth 2 Microsoftservice]]
[[en:OAuth 2 Microsoft service]]

Aktuelle Version vom 16. November 2017, 09:27 Uhr


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