- Link a Google account to a Kanboard user profile.
- Show Google Avatar image.
- Frédéric Guillot
- License MIT
- Kanboard >= 1.0.37
- Access to the Google Developer Console
- OAuth2 Google API credentials
You have the choice between 3 methods:
- Install the plugin from the Kanboard plugin manager in one click
- Download the zip file and decompress everything under the directory
plugins/GoogleAuth
- Clone this repository into the folder
plugins/GoogleAuth
Note: Plugin folder is case-sensitive.
- Follow the official Google documentation to create a new application
- In Kanboard, you can get the redirect url in Settings > Integrations > Google Authentication
There are two different methods to configure Kanboard:
- The easiest way is to copy and paste the Google Client credentials in the form Settings > Integrations > Google Authentication.
- Or add the credentials in your custom config file
If you use the second method, use these parameters in your config.php
:
<?php
// Google client id (Get this value from the Google developer console)
define('GOOGLE_CLIENT_ID', 'YOUR_CLIENT_ID');
// Google client secret key (Get this value from the Google developer console)
define('GOOGLE_CLIENT_SECRET', 'YOUR_CLIENT_SECRET');
- As administrator, enable the account creation in Settings > Integrations > Google Authentication
- If you are using Google Apps for Work, you can allow only your own domain name to avoid unwanted people
- People just need to click on link "Login with my Google Account" on the login page to create a new account
Notes:
- If you don't apply any domain restriction, everybody with a Google Account will be able to sign-up
- The local part of the email address is used to generate Kanboard's username
- Users created by this way will be marked as remote user and the login form will be disabled for them (no local password)
- Go to your user profile
- Click on External accounts
- Click on the link Link my Google Account
- You are redirected to the Google Consent screen
- Authorize Kanboard by clicking on the button Accept
- Your account is now linked
Now, on the login page you can be authenticated in one click with the link Login with my Google Account.
Your name and email are automatically updated from your Google Account.
Kanboard uses these information from your Google profile:
- Full name
- Email address
- Google unique id
The Google unique id is used to link together the local user account and the Google account.
To disable the Google Avatar go to your user profile > integrations, and change the value of the checkbox.