Before logging in to the Admin Portal, follow the steps described in the second welcome email to allow Synappx to communicate with your Google Workspace instance. This includes creating a custom scope for Google users who also need to configure or manage Synappx. The steps are below.
- Select Google Workspace as your cloud service provider in the initial welcome email.
- Upon receiving the second welcome email, follow the instructions to set up your Google Workspace Admin Console to communicate with Synappx.
- In Google Chrome or Microsoft Edge web browser, go to https://admin.google.com.
- On the left menu, select Account. Select Admin roles. Then select Create new role. [View Image]
- In Role info, enter a custom role name (e.g. Synappx Admin), add a description (if desired), and select Continue. [View Image]
- Scroll to Admin API privileges, scroll down or search to find three privileges below, configure as shown, and select Continue.
[View Image]
- Enable Users, Read.
- Enable Groups, Read.
- Enable Domain Management.
- Select CREATE ROLE. [View Image]
- On the left menu, select Account. Select Admin roles. Select the new custom role name (e.g. Synappx Admin). Then select ASSIGN ROLE. [View Image]
- Select Assign Users. [View Image]
- Type a few characters for each user name you want to add for this custom role, select the name from the dropdown, and continue until you've added all the users. [View Image]
- Select ASSIGN ROLE. [View Image]
- Open https://synappxadminportal.sharpusa.com to navigate to the Synappx Admin Portal. If you're already logged-in to the Admin Portal, please press F5 and refresh the page.
- Go to Admin Settings, select Admin Users, then select the plus icon (+) to add additional admins from the newly created Google custom role. See Admin Settings for details.
Below is a summary of the three types of Google users. Additional Synappx Admin Portal features not shown in the table are supported for all.
Synappx Admin Portal Features |
Google Workspace Administrator |
Google User with Custom Role |
Google User without Custom Role |
Domain Page |
feature supported |
feature supported |
feature not supported |
Admin User Import |
feature supported |
feature supported |
feature not supported |
Workspace Import (Individual) |
feature supported |
feature supported |
feature supported |
Workspace Import (Group) |
feature supported |
feature supported |
feature supported |
Mobile User Import (Individual) |
feature supported |
feature supported |
feature not supported |
Mobile User Import (Group) |
feature supported |
feature supported |
feature not supported |
Notes:
- A Google User without a custom role added as an Admin to the Synappx Admin Portal will have limitations to select features and receive an error message if attempting to access.
- If before using Synappx Go V3.4, you imported recommended scopes to support Synappx Go via a service account, delete those before proceeding with custom role creation.