Google Workspace is an Identity Provider (IdP) that enables secure single sign-on (SSO), allowing your company’s users to access multiple applications with one login.
With Security Assertion Markup Language (SAML) SSO, employees sign in once using their company credentials (typically email and password). The IdP, such as Google Workspace, verifies their identity and grants seamless, secure access to all connected services, without requiring separate logins for each application.
Company owners or IT administrators can link their organization’s email domain (e.g., @mycompany.com) to the IdP so that anyone with a company email address is automatically recognized and can securely sign in to SAML-enabled tools.
Using Sevalla SAML SSO, you can connect Google Workspace to Sevalla by creating a SAML application within Google Workspace, verifying your company’s email domain, and adding the required Google Workspace details in Sevalla. This allows your team to log in with their existing company credentials, eliminating the need to create or manage separate Sevalla accounts.
When using SAML SSO with Sevalla, login must always be initiated from Sevalla. Logging in directly from your Identity Provider (IdP) is not supported.IdPs only support one active session per browser. If you have multiple Google Workspace accounts and are logged into one, attempting to log into another through Sevalla will result in an error. To switch accounts, log out of Google Workspace or use your browser’s Incognito/Private mode.
Enable SSO in Sevalla
When you set up SAML SSO, you can navigate away from the SSO setup at any stage to store your progress and return later.
In Sevalla, go to your Settings > Single sign-on, and click Enable.
Read through the introduction, which explains how SSO will be set up, and click Continue.
Introduction to the steps required to set up SSO.
The next page provides all the information you need to set up your SAML app within Google Workspace.
Create the app in Google Workspace
In Sevalla, the Create SAML app tab provides all the information you need to set up your SAML app within Google Workspace. The following steps explain where to add this information.
When using SAML SSO with Sevalla, all logins must be initiated directly from Sevalla. Logging in from your Identity Provider (IdP) dashboard is not supported. For this reason, you may want to hide the Sevalla app from users’ IdP dashboards to avoid confusion.
Information to create the SAML app at your IdP.
Log in to Google Workspace as a user with admin access, open the Google Apps menu, and select the Admin app.
Open the Admin app in Google.
Select Web and mobile apps, and then click Add app > Add custom SAML app.
Add a custom SAML app in Google.
In the App name, enter the App name from Sevalla. You can also download the App icon from Sevalla and upload this to the App Icon, and add a Description if required. Click Continue.
Enter the app details in Google.
Sevalla setup
In Sevalla, on Create SAML app, click Continue so that you are on the Sevalla setup page. We will return to the Create SAML app tab in the next step when adding the service provider details to Google Workspace.
Email domain
In the Domain name, enter the email domain users will use to sign in using SAML SSO, and click Add domain.
Only Sevalla accounts with an email address matching the verified domain can authenticate via SAML. For example, if SAML is enabled for example.com, only users with an @example.com email address will be able to sign in for that company.
Each email address can only be linked to one SAML configuration in Sevalla. This means a domain (e.g., example.com) can be associated with only one company at a time. Similarly, each Sevalla user can use SAML authentication for a single company only.
If the domain has already been verified in Sevalla through DNS management or as a site domain, it will automatically be verified. If it hasn’t, you’ll be prompted to add a TXT record to your DNS management service to confirm domain ownership.
Add the TXT record to your DNS to verify ownership.
Because DNS changes can take time to propagate, you can navigate away from the SSO setup to store your progress and return later.
Set up Sevalla SAML
In Google Workspace, the Google Identity Provider details tab provides all the information you need to set up SAML in Sevalla.
Google Identity Provider details to set up the Sevalla app.
In Sevalla, within the Single sign-on Sevalla setup tab, complete the fields as follows:
- SSO URL: Copy and paste the SSO URL from Google Workspace.
- Entity ID: Copy and paste the Entity ID from Google Workspace.
- Public certificate: Copy and paste the contents of the Certificate from Google Workspace.
Click Back.
Add the service provider details in Google Workspace
In Sevalla, within Single sign-on, ensure you are on the Create SAML app tab.
Within Google Workspace, click Continue to the Service provider details tab and complete as follows:
- **ACS URL: **Copy and paste the SSO/ACS URL from Sevalla.
- Entity ID: Copy and paste the Entity ID from Sevalla.
- Start URL: Copy and paste the Start URL from Sevalla.
- Signed response: Select this option.
- Name ID format: EMAIL.
- Name ID: Basic Information > Primary email.
Click Continue.
Enter the service provider details from Sevalla into Google.
Map your Google Workspace attributes
Within Attribute mapping, you can add the first name, last name, and email to the login credentials. Complete these as follows, and click ADD MAPPING after each entry:
| Google directory attributes | App attributes |
|---|
| Fiest name | firstName |
| Last name | lastName |
| Primary email | email |
Click Finish.
Map the first name, last name, and email in Google to the Sevalla fields.
Set up user access to the Google Workspace app
In Google Workspace, in the Admin app, go to Apps > Web and mobile apps, select the Sevalla application, and click User access.
Select User access on the Sevalla application in Google Workspace.
Select the Group(s) or Organisational unit(s) you want to grant access to Sevalla via SAML. Then select ON or ON for everyone and click SAVE. For more information about Groups and Organisational units, refer to Google Workspace Admin Help.
Select the Group(s) or Organisational unit(s) you want to grant access to Sevalla via SAML.
To test authentication, make sure the Sevalla user account you’re signed in with is assigned.
Test the authentication in Sevalla
You cannot enable SAML SSO within Sevalla without first testing the authentication.
In Sevalla, within Single sign-on, click Continue until you are on the Test and finish tab, and click Test authentication.
A notification appears if the test was successful or if the test fails.
If the test fails, click Back and check your SAML settings within your IdP and within Sevalla.
If the test is successful and you want to enable SAML, click Save and set SSO live.
Test your SSO setup and set SSO live.
Your Sevalla company users will now be able to sign in with SAML SSO or by entering their username and password. Users who sign in through an IdP are not required to complete Sevalla’s 2FA, as authentication is handled directly by the IdP.
If you want to force users to sign on via SAML, you can enable Mandatory SSO and add Exceptions. You can also enable JIT provisioning to allow users authorized by your IdP to access your Sevalla company without requiring an invitation.
Sign in to Sevalla with SAML SSO.
Change the session duration
Your Identity Provider (IdP) determines how long your SSO session remains active and when it expires. If your IdP doesn’t specify a session duration, Sevalla defaults to a 24-hour session.
When your SSO session expires, you’ll be logged out of SSO. If you’re working within a company that uses SSO, you’ll be prompted to reauthenticate. If you have access to multiple companies in Sevalla, you’ll remain logged in overall but will need to reauthenticate before accessing any company that requires SSO.
For details on adjusting session duration, refer to the Google Workspace Admin Help.