To setup a Google Workspace for integration with XVWeb, a few settings must be configured.
Create custom XVWeb settings for users
XVWeb permissions are translated from custom attributes defined in a Google Workspace. To create a new custom attribute, go to Users → More options → Manage custom attributes.
Create a category called XVWeb Claims
the value type is Text
the field is Multi-value
Save these changes.
For each user in your Google Workspace, we must then assign a set of permissions for that user.
Click on Users → Select the user → User information → Scroll down to the XVWeb Claims category.
Assign permissions by adding a value the
XVWebClaims
multi-value that corresponds with a permission set for XVWeb.
Below is a set of valid claim permissions that correlate to their respective XVWeb User Roles and Privileges. These values are not case-sensitive.
XVWebAdmin
XVWebQuery
XVWebEdit
XVWebCapture
XVWebExport
XVWebPrint
XVWebShare
Create a new custom SAML app registration for XVWeb
After users have been configured with the appropriate permissions, we must then configure XVWeb as an app that can be signed into using this Google Workspace.
Go to Apps → Web and mobile apps → Add app → Add custom SAML app.
Set the App name field to XVWeb. You may optionally fill out the other fields.
Click Continue.
Click Download Metadata. This will download a GoogleIDPMetadata.xml file.
If you don't already have an open ticket regarding your switch to Google SSO, you can submit a new ticket here. Be sure to include the xml file in your communication.
Click Continue.
Under Service provider details, set the ACS URL and the Entity ID.
Example:
Given my XVWeb URL is mydentist.xvweb.net
The ACS URL will be https://apteryx-identity.xvweb.net/federation/gwrk-mydentist-xvweb-net/Saml2/Acs
The Entity ID will be https://apteryx-identity.xvweb.net/federation/gwrk-mydentist-xvweb-dev/Saml2
Note: The URLs are similar but the ACS URL must end in /Acs.
Click Continue.
Under Attribute mapping we must map our custom attribute category from earlier.
Click Add Mapping, select XVWebClaims and set the App attributes to also be XVWebClaims.
Group membership settings are optional and will not affect XVWeb integration.
Service Status
Set service status to ON for everyone (may vary by organization) to grant users access to service.
Article Version 1.0 12/13/2024