Selecting a logon mode
1. On the Select logon mode page, select the type of credentials that you will provide to be used by the application to access the backup source.
It is assumed that you have already generated the required credentials in advance in Google API Console. For details on prerequisites, see the Knowledge Base article in
“Backup from the Cloud (Google G Suite)”.
• Client ID for native application – Select this option to provide a client ID for native application. DS-Client will use this client ID to access the Google account for which the client ID was generated. This option allows DS-Client to access only one Google account.
• Service account logon – Select this option to provide the credentials of a service account. DS-Client will use the service account credentials to access one or multiple accounts on your G Suite domain.
• www – Type the name of the G Suite cloud service domain for which you want to back up data. Ensure the name is typed correctly; otherwise, DS‑Client will be unable to log on to the domain for you to select items for backup. This field appears only when you select Service account logon.
The Enter API Access Credentials dialog box appears. The fields displayed in this dialog box are determined by the logon mode that you have selected.
2. Provide the credentials required for the logon mode that you have selected, then, and then click OK:
• If you have selected Client ID for native application, do the following for each field:
a) Client ID: Click [...], browse, and then select the JSON file that contains the OAuth 2.0 client ID and the client secret for the G Suite account for which you want to back up data. The name of the file begins with client_secret. Alternatively, type the client ID.
b) Client secret: If you have selected a JSON file for the Client ID box, this box is automatically filled. Otherwise, ensure that you have selected the appropriate JSON file. If you have typed the client ID instead of selecting a JSON file, type the client secret that corresponds with the client ID.
After you click OK, DS-Client will attempt to connect to the G Suite API using the client ID and client secret you have just provided. If connection is successful, the Google sign-in page will be displayed in the Request for Permission dialog box.
• If you have selected Service account logon, do the following for each field:
a) Google account – Type the user name of the Google administrative account that you have used to create the service account that you will now use for API access. The domain name that you have typed in the previous dialog box is displayed.
b) Email address – Click [...], browse, and then select the JSON file that contains the client email address of the same service account. Alternatively, type the service account client email address.
c) Private key – Click [...], browse, and then select the PKCS12-format (or P12) private key generated for the same service account. This private key is a binary file with a .p12 extension.
4. (This step and subsequent steps apply only if you have selected Client ID for native application.) On the Google sign-in page displayed in the Request for Permission dialog box, sign in to the Google account for which you want to back up data and, therefore, to which the application needs permission to access.
NOTE: This Google account must be the same account with which you generated the credentials that you have provided in the Enter API Access Credentials dialog box. If not, sign out and then sign in with the correct account.
On successful sign-in, a permission request is displayed in the Request for Permission dialog box.
5. Grant the application the permission to access data on the Google account.
If you allow access permission, a verification code is displayed on the Google account page shown in the Request for Permission dialog box.
6. In the Request for Permission dialog box, copy the entire string of the verification code, paste the code into the Code box, and then click OK.
Successful authentication with G Suite at this step enables DS-Client to access the data of this account.