[Advanced] Google Connector (Conf)¶
It is possible to create two types of providers:
Business provider.
Personal provider.
Personal Provider¶
Before starting the configuration on the Configuration Tool, perform the following steps:
If it is not already created, create a Google Drive service account (using an email @gmail.com).
Perform the login, press Create project and then Create again.
Enter the project name and then press Create.
Select ENABLE APIS AND SERVICES and then search Google Drive API.
Double click on Google Drive API and then press ENABLE.
Select Credentials, press Create credentials and choose OAuth client ID.
Press Configure consent screen, fill in the fields (the Product name shown to users is sufficient) and press Save.
Select Other, enter the Client name (alias) and press Create.
Press OK and download the client_secret.json file.
Warning
The Google Drive account creation process could change, refer to [external link] https://developers.google.com/identity/protocols/OAuth2WebServer to check which is the right process.
Now it is possible to start the configuration on the Configuration Tool.
To create a personal provider, select New personal provider, enter the provider name and then press Save.
Configure the following settings:
Personal Account¶
The alias of the datastore: the alias of the datastore.
The path to client secret file: the path of the folder where the downloaded jason file is.
Print enabled: if checked, the external queue of Google is enabled.
User mapping expression: the expression that relates the Google user to the user on the Genius Server (e.g.
${identity.username}@gmail.com).
Once finished the configuration, select < Tests > and choose Authorize application to user from the list.
Selecting Authorize application to user, the user who performs the login is authorized to use Google Drive.
To save the provider, press Save.
To edit a provider, select the Edit button near the provider to modify.
To delete a provider, select the Delete button near the provider to eliminate.
The order of priorities can be established pressing the blue arrows on the right.
Business Provider¶
Before starting the configuration on the Configuration Tool, perform the following steps:
If it is not already created, create a Google Drive service account.
Perform the login, press Create project and then Create again.
Enter the project name and then press Create.
Select ENABLE APIS AND SERVICES and then search Google Drive API.
Double click on Google Drive API and then press ENABLE.
Select Credentials, press Create credentials and choose OAuth client ID.
Press Configure consent screen, fill in the fields (the Product name shown to users is sufficient) and press Save.
Select Other, enter the Client name (alias) and press Create.
Press OK and download the p12 key.
Warning
The Google Drive account creation process could change, refer to [external link] https://developers.google.com/identity/protocols/OAuth2WebServer to check which is the right process.
Now it is possible to start the configuration on the Configuration Tool.
To create a business provider, select New business provider, enter the provider name and then press Save.
Configure the following settings:
Business Account¶
p12 File: upload the downloaded keystore file selecting Browse.
p12 Alias: the alias name of the key (by default is privatekey).
p12 Password: the password of the key (by default is notasecret).
Confirm the p12 password: confirmation of above password.
Service account ID: the email of the service account.
The default user of the service: the email of the service account default user (the entered account is used only when no specific user is defined in the BPM process) .
Print enabled: if checked, the external queue of Google is enabled.
User mapping expression: the expression that relates the Google user to the user on the Genius Server (e.g.
${identity.username}@gmail.com).
Once finished the configuration, select < Tests > and choose Add p12 to keystore from the list.
Selecting Add p12 to keystore, the following window opens:
Once uploaded the file, press Add p12 to keystore.
The key has been saved on the Genius Server. Delete the default-keystore.jks file.
To save the provider, press Save.
To edit a provider, select the Edit button near the provider to modify.
To delete a provider, select the Delete button near the provider to eliminate.
The order of priorities can be established pressing the blue arrows on the right.