diff --git a/README.md b/README.md index 0b98289d..282a327e 100644 --- a/README.md +++ b/README.md @@ -61,15 +61,25 @@ Test coverage report of unit and integration test can be found in wisemapping-op ## Google authorization -You must configure the following properties (app.properties) in order to get google authorization working +You must configure the following wisemapping properties (app.properties) in order to get google authorization working * `google.oauth2.callbackUrl`: url where google will redirect after user authentication, tipically {frontendBaseUrl}/c/registration-google. Also, this url must be defined in google app configuration * `google.oauth2.clientId`: client id from google app * `google.oauth2.clientSecret`: client secret from google app -Be sure your google app has the following scopes allowed: - * `https://www.googleapis.com/auth/userinfo.profile` - * `https://www.googleapis.com/auth/userinfo.email` +First you must create a google application and complete all the information required by Google. Here are the most important properties. + +Oauth consent screen + * Authorized domains: wisemapping domain (ex: wisemapping.com), and you can add domains of other environments if needed + * Permissions + * `https://www.googleapis.com/auth/userinfo.profile` + * `https://www.googleapis.com/auth/userinfo.email` + * Test users: emails for testing, those can be used before the application is validated by google +After that, in Credentials, you must create an `Oauth Client Id` credential + * Authorized JavaScript origins: list of authorized domains from which to redirect to google. Ex: `https://wisemaping.com`, `https://wisemapping-testing.com:8080` + * Authorized redirect URIs: list of allowed urls to which google will redirect after authenticating . Ex: `https://wisemaping.com/c/registration-google`, `https://wisemapping-testing.com:8080/c/registration-google` + +After credential is created, google will show you the clientId and clientSecret to configure your application. ## Members