OAuth2 LinkedIn Service: Unterschied zwischen den Versionen

Aus MoodleDocs
Wechseln zu:Navigation, Suche
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
Zeile 2: Zeile 2:
{{Neu}}
{{Neu}}


{{Zum Überarbeiten}}
==Einen OAuth2 LinkedIn Service aufsetzen==
==Einen OAuth2 LinkedIn Service aufsetzen==
Um einen OAuth2 LinkedIn Service aufzusetzen, gehen Sie folgendermaßen vor:
Um einen OAuth2 LinkedIn Service aufzusetzen, gehen Sie folgendermaßen vor:
*Gehen Sie auf die Seite [https://developer.linkedin.com/ LinkedIn Developers page] und legen Sie eine neue App an.
*Gehen Sie auf die Seite [https://developer.linkedin.com/ LinkedIn Developers page] und legen Sie eine neue App an.
:[[File:linkedin-1-new-app.png|400px]]
:[[File:linkedin-1-new-app.png|400px]]
*Enable the r_basicprofile and r_emailaddress permissions and enter the OAuth 2 authorized redirect URL. This is your site url followed by /admin/oauth2callback.php (e.g. for a Moodle site of <nowiki>https://teach.me/moodle/</nowiki> the callback url should be <nowiki>https://teach.me/moodle/admin/oauth2callback.php</nowiki>).
*Im Abschnitt ''Default Application Permissions'' markieren Sie die Checkboxen ''r_basicprofile'' und ''r_emailaddress'' permissions.
*Im Abschnitt ''OAuth 2.0'' tragen Sie die ''Authorized Redirect URL'' 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 URL ''<nowiki>https://lemon.edu/admin/oauth2callback.php</nowiki>''.
:[[File:linkedin-2-configure-app.png|400px]]
:[[File:linkedin-2-configure-app.png|400px]]
*Make sure you save your changes and record your client id and client secret.
*Speichern Sie die Einstellungen und notieren Sie sich die Client ID und das Client Secret, das beim Anlegen der App erzeugt wird.


Now you have configured your LinkedIn App - you can add the required information to Moodle.
Nachdem die App angelegt ist, müssen Sie den OAuth 2 Service in Moodle konfigurieren. LinkedIn hat keine eigene Service-Vorlage in Moodle, so dass Sie einen eigenen Service erstellen müssen.
*Gehen Sie in Moodle auf die Seite ''Website-Administration > Server > OAuth 2 Services'', Klicken Sie auf den Button ''Neuen eigenen Service anlegen''.
*Tragen Sie ''LinkedIn'' als Namen ein (dieser wird auf der Anmeldeseite angezeigt).
*Tragen Sie die Client ID und das Client Secret der LinkedIn-App unter ''Client ID'' und ''Client Kennwort'' ein.
*In den Feldern ''Scopes included in a login request'' und ''Scopes included in a login request for offline access'' tragen Sie  ''r_basicprofile r_emailaddress'' ein.
*Tragen Sie eine Logo-URl ein.
*Markieren Sie die Checkbox ''Auf der Login-Seite anzeigen''.
*Klicken Sie auf den Button ''Änderungen speichern''.


LinkedIn does not have a "template" in Moodle so we will need to configure it as a "Custom OAuth 2 Service".  
Nun müssen wir noch die URL angeben, um auf die LinkedIn APIs zuzugreifen.  
*From the "Site administration > Server > OAuth 2 services" page click on "Create new custom service".
*Klicken Sie dazu auf der Seite ''Website-Administration > Server > OAuth 2 Services'' auf das Symbol ''Endpoints konfigurieren'' [[Image:endpoints.jpg]] hinter dem neu angelegten LinkedIn Service.
*Use "LinkedIn" as the name (This is displayed on the login page).
*Fügen Sie drei Endpunkte wie folgt hinzu:
*Enter your client id and secret for the LinkedIn App that you created earlier.
*For the "Scopes included in a login request" and "Scopes included in a login request for offline access" use "r_basicprofile r_emailaddress" which means fetch basic profile information as well as the users email address.
*Enter a url to a logo image.
*Check the box for "Show on login page".
*Save the details and you should be returned to the list of OAuth 2 Services.
 
We still need to provide information on the mappings between linked in user fields and moodle fields as well as the URL's to access the LinkedIn APIs. First we will setup the API URL's.
*Click on the "Configure Endpoints" icon for the LinkedIn service.  
*Add 3 endpoints as listed below.


<code>
<code>
Zeile 34: Zeile 33:
</code>
</code>


Now we need to add the mapping from LinkedIn user fields to Moodle user fields. From the list of OAuth services click on the "Configure user field mappings" icon.  
Schließlich müssen wir noch hinterlegen, wie die Nutzerdatenfelder von LinkedIn und Moodle aufeinander abgebildet werden. Außerdem müssen wir
*Add the following user field mappings:
*Klicken Sie dazu auf der Seite ''Website-Administration > Server > OAuth 2 Services'' auf das Symbol ''Profilfeldübernahmen konfigurieren'' [[Image:mapping.jpg]] hinter dem neu angelegten LinkedIn Service.
*Tragen Sie folgende Zuordnungen ein:


<code>
<code>
Zeile 45: Zeile 45:
</code>
</code>


The final step is to make sure the OAuth 2 authentication plugin is enabled and you should now be able to login with LinkedIn.
Zum Schluss prüfen Sie, ob die  [[OAuth2 Authentifizierung]] funktioniert und Sie sich mit Ihren LinkedIn-Anmeldedaten in Moodle anmelden können.


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

Version vom 19. Juni 2017, 09:29 Uhr

Neue Funktionalität
in Moodle 3.5!


Einen OAuth2 LinkedIn Service aufsetzen

Um einen OAuth2 LinkedIn Service aufzusetzen, gehen Sie folgendermaßen vor:

linkedin-1-new-app.png
  • Im Abschnitt Default Application Permissions markieren Sie die Checkboxen r_basicprofile und r_emailaddress permissions.
  • Im Abschnitt OAuth 2.0 tragen Sie die Authorized Redirect URL 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 URL https://lemon.edu/admin/oauth2callback.php.
linkedin-2-configure-app.png
  • Speichern Sie die Einstellungen und notieren Sie sich die Client ID und das Client Secret, das beim Anlegen der App erzeugt wird.

Nachdem die App angelegt ist, müssen Sie den OAuth 2 Service in Moodle konfigurieren. LinkedIn hat keine eigene Service-Vorlage in Moodle, so dass Sie einen eigenen Service erstellen müssen.

  • Gehen Sie in Moodle auf die Seite Website-Administration > Server > OAuth 2 Services, Klicken Sie auf den Button Neuen eigenen Service anlegen.
  • Tragen Sie LinkedIn als Namen ein (dieser wird auf der Anmeldeseite angezeigt).
  • Tragen Sie die Client ID und das Client Secret der LinkedIn-App unter Client ID und Client Kennwort ein.
  • In den Feldern Scopes included in a login request und Scopes included in a login request for offline access tragen Sie r_basicprofile r_emailaddress ein.
  • Tragen Sie eine Logo-URl ein.
  • Markieren Sie die Checkbox Auf der Login-Seite anzeigen.
  • Klicken Sie auf den Button Änderungen speichern.

Nun müssen wir noch die URL angeben, um auf die LinkedIn APIs zuzugreifen.

  • Klicken Sie dazu auf der Seite Website-Administration > Server > OAuth 2 Services auf das Symbol Endpoints konfigurieren endpoints.jpg hinter dem neu angelegten LinkedIn Service.
  • Fügen Sie drei Endpunkte wie folgt hinzu:

userinfo_endpoint https://api.linkedin.com/v1/people/~:(id,email-address,first-name,last-name,picture-url)?format=json

authorization_endpoint https://www.linkedin.com/oauth/v2/authorization

token_endpoint https://www.linkedin.com/oauth/v2/accessToken

Schließlich müssen wir noch hinterlegen, wie die Nutzerdatenfelder von LinkedIn und Moodle aufeinander abgebildet werden. Außerdem müssen wir

  • Klicken Sie dazu auf der Seite Website-Administration > Server > OAuth 2 Services auf das Symbol Profilfeldübernahmen konfigurieren mapping.jpg hinter dem neu angelegten LinkedIn Service.
  • Tragen Sie folgende Zuordnungen ein:

firstName firstname lastName lastname emailAddress username emailAddress email pictureUrl picture

Zum Schluss prüfen Sie, ob die OAuth2 Authentifizierung funktioniert und Sie sich mit Ihren LinkedIn-Anmeldedaten in Moodle anmelden können.

Siehe auch