OAuth2 Google Service: Unterschied zwischen den Versionen

Aus MoodleDocs
Wechseln zu:Navigation, Suche
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(8 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{OAuth2}}
{{OAuth2}}
{{Zum Übersetzen}}
==Funktionalitäten, die einen OAuth2 Google Service benötigen==


{{Neu}}
Sie müssen einen OAuth2 Google Service einrichten, um folgende Funktionalitäten nutzen zu können:
==Einen OAuth2 Client in Google aufsetzen==
 
Um einen OAuth2 Client in Google aufzusetzen, müssen Sie sich als erstes in der [https://console.developers.google.com/ Google Developers Console] anmelden und ein neues Projekt anlegen.
* [[Google Drive Repository]]
* [[OAuth2 Authentifizierung]], damit Nutzer/innen sich mit ihrem Google-Nutzerkonto in Moodle anmelden können
* [[Google Drive Konverter]], damit Dateien in Aufgabenabgaben in PDFs umgewandelt werden können und Trainer/innen diese annotieren können
 
==Einen OAuth2 Client für Google aufsetzen==
Um einen OAuth2 Client für Google aufzusetzen, müssen Sie sich als erstes in der [https://console.developers.google.com/ Google Developers Console] anmelden und ein neues Projekt anlegen.
* Verwenden Sie dazu das Menü oben auf der Seite.
* Verwenden Sie dazu das Menü oben auf der Seite.
[[File:google-1-create-new.png|400px]]
:[[File:google-1-create-new.png|300px]]
*Geben Sie dem Projekt einen beliebigen Namen. Der Name wird bei der Anmeldung nirgends angezeigt.
*Geben Sie dem Projekt einen beliebigen Namen. Der Name wird bei der Anmeldung nirgends angezeigt.
[[File:google-2-create-new-modal.png|400px]]
:[[File:google-2-create-new-modal.png|300px]]
*Im Menü auf der linken Seite wählen Sie die Option ''Credentials" aus.
*Im Menü auf der linken Seite wählen Sie die Option ''Credentials" aus.
[[File:google-3-credentials.png|400px]]
:[[File:google-3-credentials.png|300px]]
 
*Füllen Sie das Einverständnis-Formular für Ihre Web-Applikation aus. Tragen Sie hier die Informationen ein, die Nutzer/innen über die Web-Anwendung benötigen, wenn sie sich anmelden wollen, mindestens jedoch den Namen der Web-Applikation. Je mehr Informationen Sie angeben, desto vertrauenswürdiger erscheint Ihre Anwendung.
Setup the consent screen for your application. This is where you provide the public information that is shown to users when they are asked to authorise your application. Setting a product name is the minimum information that is required, but the more information you provide here - the more confidence users will have when granting this authorisation.
:[[File:google-4-consent.png|300px]]
 
*Jetzt benötigen Sie Zugangsdaten. Wechseln Sie zum Reiter ''Credentials'' und legen Sie eine neue OAuth Client ID an.  
[[File:google-4-consent.png|none|frame|Setup consent screen]]
:[[File:google-5-oauth-credentials.png|300px]]
 
*Konfigurieren Sie die Zugangsdaten für die Web-Anwendung. Die wichtigste Einstellung ist die Callback URL. Sie muss wie folgt lauten: ''IhreMoodleSiteURL/admin/oauth2callback.php''.
Now you can create some client credentials. Switch to the credentials tab and create a new OAuth client ID.  
:'''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>''.
 
:[[File:google-6-web-application-credentials.png|300px]]
[[File:google-5-oauth-credentials.png|none|frame|Create an OAuth Client ID]]
*Wenn Sie die Einstellungen gespeichert haben, bekommen Sie von Google eine Client ID und ein Client Kennwort, das Sie in Moodle hinterlegen müssen. Gehen Sie dazu in Moodle auf die Seite ''Website-Administration > Server > OAuth 2 Services''. Klicken Sie auf den Button ''Neuen Google Service anlegen'' und tragen Sie diese Client ID und das Client Kennwort ein.
 
:[[File:google-7-oauth-details.png|300px]]
Setup the credentials for a Web Application. The most important setting here is to set the callback URL. This must be set to "your moodle site url + /admin/oauth2callback.php". If your moodle site was accessible at <nowiki>https://lemon.edu/</nowiki> then this callback URL should be set to <nowiki>https://lemon.edu/admin/oauth2callback.php</nowiki>.
*Schließlich müssen Sie die Drive API aktivieren (wenn Sie das Google Drive Repository oder Dokumentkonverter-Plugins nutzen wollen).
 
:[[File:google-8-library.png|300px]]
[[File:google-6-web-application-credentials.png|none|frame|Set the callback URL]]
:[[File:google-9-select-drive.png|300px]]
 
:[[File:google-10-enable-drive.png|300px]]
When you have saved the information on this page, Google will give you the client ID and client secret that you need to enter into Moodle.
 
[[File:google-7-oauth-details.png|none|frame|Got my secrets!]]
 
Finally we have to enable the Drive API (if we want to use the google drive repository or file converter plugins).
 
[[File:google-8-library.png|none|frame|View the Library tab]]
 
[[File:google-9-select-drive.png|none|frame|Select Drive API]]
 
[[File:google-10-enable-drive.png|none|frame|Enable the API]]


==Siehe auch==
==Siehe auch==
Zeile 42: Zeile 36:


[[en:OAuth 2 Google service]]
[[en:OAuth 2 Google service]]
[[es:Servicio OAuth 2 Google]]

Aktuelle Version vom 3. Mai 2019, 14:23 Uhr

Funktionalitäten, die einen OAuth2 Google Service benötigen

Sie müssen einen OAuth2 Google Service einrichten, um folgende Funktionalitäten nutzen zu können:

Einen OAuth2 Client für Google aufsetzen

Um einen OAuth2 Client für Google aufzusetzen, müssen Sie sich als erstes in der Google Developers Console anmelden und ein neues Projekt anlegen.

  • Verwenden Sie dazu das Menü oben auf der Seite.
google-1-create-new.png
  • Geben Sie dem Projekt einen beliebigen Namen. Der Name wird bei der Anmeldung nirgends angezeigt.
google-2-create-new-modal.png
  • Im Menü auf der linken Seite wählen Sie die Option Credentials" aus.
google-3-credentials.png
  • Füllen Sie das Einverständnis-Formular für Ihre Web-Applikation aus. Tragen Sie hier die Informationen ein, die Nutzer/innen über die Web-Anwendung benötigen, wenn sie sich anmelden wollen, mindestens jedoch den Namen der Web-Applikation. Je mehr Informationen Sie angeben, desto vertrauenswürdiger erscheint Ihre Anwendung.
google-4-consent.png
  • Jetzt benötigen Sie Zugangsdaten. Wechseln Sie zum Reiter Credentials und legen Sie eine neue OAuth Client ID an.
google-5-oauth-credentials.png
  • Konfigurieren Sie die Zugangsdaten für die Web-Anwendung. Die wichtigste Einstellung ist die Callback URL. Sie muss wie folgt lauten: IhreMoodleSiteURL/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.
google-6-web-application-credentials.png
  • Wenn Sie die Einstellungen gespeichert haben, bekommen Sie von Google eine Client ID und ein Client Kennwort, das Sie in Moodle hinterlegen müssen. Gehen Sie dazu in Moodle auf die Seite Website-Administration > Server > OAuth 2 Services. Klicken Sie auf den Button Neuen Google Service anlegen und tragen Sie diese Client ID und das Client Kennwort ein.
google-7-oauth-details.png
  • Schließlich müssen Sie die Drive API aktivieren (wenn Sie das Google Drive Repository oder Dokumentkonverter-Plugins nutzen wollen).
google-8-library.png
google-9-select-drive.png
google-10-enable-drive.png

Siehe auch