Maintained by Picture of Sergio RabellinoSergio Rabellino
Sign-in with an Oauth2 provider. The first time you sign-in, a new account is created.
1185 sites
269 fans
Current versions available: 3

Plugin end of life starting from Moodle 3.3

starting from Moodle 3.3, Oauth2 should be implemented in Moodle core. It will require you to upgrade to Moodle 3.3 and switch to the Oauth2 core authentication (and probably do some migration), but it is a great news as authentication is a really sensible matter and having Oauth2 plugins in core will guarantee their maintenance. So starting from Moodle 3.3 I highly recommend to use the new Oauth2 core plugins (( ) . Missing core providers will likely be implemented by someone and published in the plugin repository. There will probably be a new Oauth2 category in the Moodle plugin repository. Wait and see...

I will try to mantain this plugin until Moodle 3.1 (LTS) runs out of security upport  (13 May 2019).

Warning for Facebook users 

The plugin stopped working the 27th March 2017 as Facebook closed the API 2.2. The last versions of this plugin have been updated to support Facebook 2.8 API. As usual carefully test before upgrading a third party plugin if your Moodle site is important to you (especially as it is an authentication plugin)


  1. add the plugin into /auth/googleoauth2/
  2. in the Moodle administration, enable the plugin (Admin block > Plugins > Authentication)
  3. in the plugin admin page, follow the displayed instructions.

I also created a free mini-course on how to install a Moodle plugin using Oauth2 plugin as example.

Documentation and support

You can search in all existing issues on Github. Go to the issues page, next to the filter button there is a search field. Remove the default content, type your keywords and press enter.

There is a FAQ too.

Alternative plugins

There are many alternatives to this plugin, if you have any trouble with this plugin it may be a good idea to try them:


This plugin is part of set OAuth2.


Screenshot #0


Picture of Sergio Rabellino
Sergio Rabellino (Lead maintainer)
Picture of Jérôme Mouneyrac
Jérôme Mouneyrac: Original author and previous maintainer
Please login to view contributors details and/or to contact them

Comments RSS


  • Picture of Daniel Tillman
    Tue, Nov 24, 2015, 1:02 AM
    Scott, you can set it up that way. Under the Site Admin menu, go to Plugins -> Authentication -> Manage Authentication. Here is the important part -> SCROLL DOWN until you find Allowed email domains. Enter your Google Apps domains there. (I always forget that there are more options when you scroll down on that page.)
  • Renaat
    Wed, Nov 25, 2015, 6:55 PM
    Even when the plugin is not enabled, the authentication method writes log entries with no respect for the debugging settings:
    error_log(print_r($event, true));
    error_log(print_r($event->userid, true));
    This should be documented in the readme file.
  • Picture of Justin Kim
    Thu, Dec 3, 2015, 4:15 AM
    I have installed auth_googleoauth2 and configured the settings for google and facebook, and login works with google, however I cannot login using facebook. It displays the error message: "The site succeed to connect to the selected provider but failed to retrieve your user details. If you are using Google, check that your site administrator has enabled the Google+ API in the Google developer console. It is the most common reason for this error."
    What is the solution to this problem?
  • Picture of Dominik Stuerzer
    Sat, Dec 12, 2015, 1:28 AM
    Thanks for the great plugin! Is it possible to show the buttons for oauth also on the signup page?
    I want to direct people to the signup from a landing page. They should be able to sign up with Facebook and google...
  • Picture of Sourabh Maheshwari
    Sun, Dec 13, 2015, 4:32 PM
    Hi Jerome,

    I am getting the following error:

    401. That’s an error.

    Error: invalid_client

    The OAuth client was not found.

    Request Details
    scope=profile email

    also What should be the name of the Product in OAth consent screen.

    Thanks in advance,
  • Picture of Phuong Hoang
    Wed, Dec 16, 2015, 12:39 PM
    Hi guys,
    At first, I failed to install this plugin, but finally it works like a charm. In my opinion, the reason why I failed was that I used the same email as the one I had registered in my moodle site. I'm not sure! Let consider, guys!
  • Picture of Lars Richter
    Thu, Dec 31, 2015, 6:13 PM
    Is it possible to receive the userpic of the social media (like g+ or facebook profile picture)?
  • Picture of abdoul kassoum Thimobiano Yendanl
    Fri, Jan 8, 2016, 11:22 AM
    Hi i'm new in using moodle and plugins also. This error whe trying to connect with g+ button
    " The site succeed to connect to the selected provider but failed to retrieve your user details. If you are using Google, check that your site administrator has enabled the Google+ API in the Google developer console. It is the most common reason for this error. "
    Can someone help it will very cool thanks in advance.
  • Picture of Dinis Medeiros
    Fri, Jan 29, 2016, 8:05 AM
    Can't login with Microsoft. Google and Facebook OK. Any help?
  • Picture of Dinis Medeiros
    Thu, Feb 4, 2016, 6:58 AM
    Any help for this? Using hotmail account!!!
    We're unable to complete your request
    Microsoft account is experiencing technical problems. Please try again later.
  • Picture of Pedro Contreras
    Fri, Feb 5, 2016, 1:39 AM
    Is there any way to configure this plugin so that the new user can use her/his email as username insted of the prefix? Thank you.
  • Picture of Jay Pfaffman
    Fri, Mar 4, 2016, 2:16 AM
    I've configured Facebook, Gmail, and Github. I don't get any errors, but after I log in and give the app permission, it returns to the home page with "You are not logged in." Do I have to do something to allow accounts to be created? Do I have to use https?
  • Picture of Rajesh Kumar
    Thu, Mar 17, 2016, 11:10 AM
    Great plugin!

    But there is a small mistake in documentation. For Messenger redirect domain should be your website name + "/auth/googleoauth2/microsoft_redirect.php". For e.g if your website is then redirect url should be "
  • Picture of Alosies George
    Fri, Apr 1, 2016, 4:35 PM
    We have been quite happy with this plugin. We moved to a new hosting account and from then facebook login redirects to the same page and prompts from log-in again. Please see this screencast -

    Has anybody faced a similar problem? Please help
  • Picture of Ken Task
    Fri, Apr 15, 2016, 12:33 AM
    Been using this plugin ... good work!
    However, am seeing this in apache error logs of server now (broken down for readability - sorry for length):
    Linux CentOS el5PAE PHP 5.5.34 Moodle 3.0.3+ (Build: 20160407)

    core\\event\\user_loggedin Object
    [data:protected] => Array\
    [eventname] => \\core\\event\\user_loggedin
    [component] => core
    [action] => loggedin
    [target] => user
    [objecttable] => user
    [objectid] => 837
    [crud] => r
    [edulevel] => 0
    [contextid] => 1
    [contextlevel] => 10
    [contextinstanceid] => 0
    [userid] => 837
    [courseid] => 0
    [relateduserid] => [anonymous] => 0
    [other] => Array
    [username] => social_user_2
    [timecreated] => 1460649341
    [logextra:protected] => [context:protected] => context_system Object
    [_id:protected] => 1
    [_contextlevel:protected] => 10
    [_instanceid:protected] => 0
    [_path:protected] => /1
    [_depth:protected] => 1
    [triggered:core\\event\\base:private] => 1
    [dispatched:core\\event\\base:private] =>
    [restored:core\\event\\base:private] => [recordsnapshots:core\\event\\base:private] => Array
    Thanks, in advance, for any clue! ;)
Please login to post comments