Plugin Google Authentication
Author: Frédéric Guillot | License: MIT | Version: 1.0.4 | Kanboard >=1.0.37
Use Google as authentication provider.
- 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
- Clone this repository into the folder
Note: Plugin folder is case-sensitive.
Setting up OAuth 2.0 in Google Developer Console
- Follow the official Google documentation to create a new application
- In Kanboard, you can get the redirect url in Settings > Integrations > Google Authentication
Setting up Kanboard
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
<?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');
Automatic account creation
- 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
- 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)
Procedure to link a Google Account
- 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.