iobroker.googleauth
v0.3.4
Published
ioBroker Google Authentication
Downloads
3
Readme
ioBroker.googleauth
This adapter is an extension on the web adapter. It enables you to login with your Google account. To extend the login page with an appropriate "Sign in with Google" Button, use the web extension adapter weblogin.
Of course the extension is only useful, if you have activated the authentication at your ioBroker web server.
Configuration
Google API
First of all, you need to create an application in the Google Developers Console. This way you get a client id and a client secret, which you need to make the Google Sign In work. You can find a Guide at Google Developers Page. But, here you get a shortened guidance:
Open Google Developers Console (if needed, login with your Google Account)
Select your prefered project or create a new one
Go to the Credentials page
Click Create credentials > OAuth client ID
Select the Web application application type
Give your application a name (e.g. ioBroker)
Specify an authorized redirect URI
- You need the used protocol (http or https)
- your host name (e.g. iobroker.example.com)
- your used port (e.g. 8090)
- and the fixed route /login/google/cb
Full Example: https://iobroker.example.com:8090/login/google/cb
After the creation of the application you get the client id and client secret, which you need in the next step.
Hints to authorized redirect URI
You can use several redirect URIs. The only thing which is always the same, is the fixed route /login/google/cb. The localhost is also allowed. You can use it for test purposes on your local system. But in general you need a host name with a top level domain (like .com or .org), so you need to configure a fitting name for your ioBroker server in your network like: iobroker.mynetwork.net.
Adapter
There are three fields you have to fill out.
Extended web adapter
Here you can choose the instance of the web adapter you want to extend by the Google Authentication. Default is All instances.
Client ID
In this field you have to specify the client id from your application you created in the step before.
Client Secret
In this field you have to specify the client secret from your application.
Usage
To use this extension in a meaningful manner, it is recommanded to use also the weblogin adapter. It provides on the login page of the web server a checkbox named First time login with Account and the button Sign in with Google, if configured accordingly.
Otherwise you have to manage it by your own to make the google authentication work.
If you sign in with your Google Account the first time, you have to check on the First time checkbox and you have to specify your username and password. This is necessary to associate your Google Account to your user profile in ioBroker. Instead of the Log in button you must push the Sign in with Google button.
After this first time login, on further logins, you only need to push the Sign in with Google button.
If you are currently not logged in into your Google Account, you will be redirected to Google to log in.
License
MIT License
Copyright (c) 2021 Armin Junge
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.