- Obtain Client ID and Client Secret from the Google system. These values should be generated based on the public URL of the VergeIO system. See Google documentation for instructions, such as https://developers.google.com/identity/protocols/oauth2
Client ID and Secret can typically be generated at: https://console.developers.google.com
- From the VergeIO Main Dashboard, click System on the left menu.
- Click Authorization Sources on the left menu.
- Click New on the left menu.
- Enter a Name for the source (such as "Google"). This name will appear on the sign-in button of the VergeIO login page.
- In the Driver field (dropdown list), select Google.
- Redirect URI should be populated with URL of the VergeIO system . This must be a public address that can be accessed by the Google API.
- Enter the Client ID and Client Secret values obtained from Google.
- Remote User Fields is the list of fields used to initially find the Google user; this field is auto-populated with (sub,preferred_username,email nickname), a default list that can typically work for Google implementations. Note: For security reasons, it is not recommended to locate remote users based on fields that are changeable by the end user on the remote system.
-
- Update Remote User: - once user is located in the Google system, update VergeIO user Remote Username field to the corresponding Google unique ID (sub string)
Enabling the Update Remote User will allow the* VergeIO system to store the unique Google ID in the VergeIO *user record (after initially locating the Google user with fields defined in Remote User Fields), so the unique identifier can subsequently be used for finding the Google user; this is typically recommended since fields such as email address are subject to change.
- Update User Email Address: - update VergeIO user Email address to match email address within Google.
- Update User Display Name: - update VergeIO user display name to match display name within Google.
-
See Authorization Sources (General) for information regarding additional optional Fields.
After the authorization source is created, users can be created to utilize the Google source for login.
Create new VergeIO users with the following configuration:
- Authorization Source: Select the Google source from the dropdown list
- Username: unique name within the VergeIO system; typically it is recommended to use the same login name used within Google.
- Remote Username: use value of one of the fields defined as Remote User fields, which are fields that are searched on in Google;User email address or the sub string, which is equivalent to the user's Google ID, are typically best.
- Display Name: (optional) If Update User Display Name is enabled on the Google auth source, display name will synchronize from the Google user.
- Email Address: (optional) If Update User Email Address is enabled on the Google auth source, Email address will synchronize from the Google user.
Need more Help? Email support@verge.io or call us at (855) 855-8300