Google login is only for writing comments. For regular users, see Managing Users.
Prerequisites
Running ManualWorks over HTTPS
To log in with Google, ManualWorks must run over HTTPS.
Setting the Base URL
To log in with Google, you must set the base URL in General Settings. If the base URL is not set, the Google login button is not shown.
The redirect address is the base URL followed by
/r/oauth/auth. For example, if the base URL ishttps://dimdol.com, the redirect address ishttps://dimdol.com/r/oauth/auth.Users must access ManualWorks with the same host as the base URL. If they use a different host, they cannot complete the login.
The ManualWorks server gets tokens from Google's oauth2.googleapis.com and user information from openidconnect.googleapis.com. If you restrict the server's outbound connections with an allow list, we recommend adding both hosts to the allow list.
Setting Up Google
1
Log In to Google Cloud Platform
Log in to the following site.
https://console.cloud.google.com/
You need a Google account.
2
Create a Project
Click the 1 button on the left of the screen.
Click the <2New Project> link.
Enter the “3Project name”, and click the 4 button.
Creating a project can take a while.
Click the <1Credentials> menu.
Click the 2 button.
For “User Type”, select “3External”. Then click the 4 button.
In App information, enter the “5App name” and “6User support email”.
In App domain, enter the “7Application home page”.
In Authorized domains, click the 9 button, and enter the <8missing domain>.
Enter the 10developer contact information.
Click the 11 button.
3
Set the App Scopes
ManualWorks uses only the user's name and email address from Google. Set this up as follows.
Click the 1 button.
Select 2
userinfo.emailand 3userinfo.profile, and click the <Update> button.
4
Create Test Users
To test without publishing the app, you must create test users. Click the 1 button to create test users.
Click the 2 button.
5
Create Credentials
Click the <1Credentials> menu.
Click the <2Create credentials> link.
Select <3OAuth client ID>.
For “Application type”, select “4Web application”.
Enter the “5Name”.
Under Authorized redirect URIs, click the 6 button.
Enter the “7URI”, and click the 8 button.
Replace https://dimdol.com with the base URL set in the <Admin | Preferences | General> menu of ManualWorks. Enter /r/oauth/auth as is.
Check the 9client ID and 10client secret.
6
Publish the App
Click the <1OAuth consent screen> menu, and click the 2 button.
If you do not publish the app, only the test accounts you registered can log in.
Setting Up ManualWorks
Set up ManualWorks so that users can log in with Google.
Go to the <Admin | Preferences | API> menu.
Click the <Change> link in the <Log in with Google> panel.
Enter the Client ID and Client Secret.
Find the Client ID and Client Secret in Google Cloud Platform as follows.
Open the <1Credentials> menu.
Under OAuth 2.0 Client IDs, click 2the client to see its values.