====== oAuthGoogle Plugin ======

---- plugin ----
description: Google Service for use with the oAuth Plugin
author     : Andreas Gohr 
email      : dokuwiki@cosmocode.de
type       : action
lastupdate : 2022-01-13
compatible : Hogfather
depends    : oauth
conflicts  : 
similar    : authgoogle
tags       : oauth, authentication

downloadurl: https://github.com/cosmocode/dokuwiki-plugin-oauthgoogle/zipball/master
bugtracker : https://github.com/cosmocode/dokuwiki-plugin-oauthgoogle/issues
sourcerepo : https://github.com/cosmocode/dokuwiki-plugin-oauthgoogle/
donationurl: 

screenshot_img :
----

This plugin implements the oAuth workflow needed to authenticate users with Google as Identity Provider.

===== Installation =====
[[https://www.cosmocode.de/en/open-source/dokuwiki-plugins/|{{ http://cosmocode.de/static/img/dokuwiki/dwplugins.png?recache|A CosmoCode Plugin}}]]

:!: **External requirements:** This plugin requires the [[plugin:oauth|oAuth Plugin]].

Install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.


===== Configuration =====

You need to set the Client ID and Secret of your Google Authentication application.

  * Go to https://console.cloud.google.com/apis/credentials
  * Select a existing project at the top or create a new one
  * Select "create credentials"
  * Pick oAuth Client ID
    * Application type: Web application
    * Name: DokuWiki
    * Add Redirect URI: //insert the URL displayed in your wiki's config manager//
  * Copy the displayed ClientID and Client Secret to the settings in your wiki's config manager
  * Optionally edit the data in the "oAuth consent screen" tab

{{https://i.imgur.com/YGF69DZ.png}}

===== Development =====

=== Change Log ===

{{rss>https://github.com/cosmocode/dokuwiki-plugin-oauthgoogle/commits/master.atom date}}