SSOGoogle Workspace
Google Workspace SSO Setup Guide
Configure SAML 2.0 Single Sign-On with Google Workspace (formerly G Suite)
⏱️ 8 min read•Last updated: December 2025
1Add a Custom SAML App
- Sign in to your Google Admin console (admin.google.com)
- Go to Apps → Web and mobile apps
- Click Add App → Add custom SAML app
- Enter "ViksaAI" as the app name and click Continue
2Download Google IdP Metadata
On the Google Identity Provider details page, copy or download:
- SSO URL - This is your IdP SSO URL
- Entity ID - This is your IdP Entity ID/Issuer
- Certificate - Download the certificate
Click Continue.
3Configure Service Provider Details
Enter the following values:
| ACS URL | https://api.viksaai.com/auth/auth/sso/saml/callback |
| Entity ID | https://viksaai.com/saml/metadata |
| Start URL | https://os.viksaai.com/login |
| Name ID format | EMAIL |
Click Continue.
4Configure Attribute Mapping
Add these attribute mappings:
| Google Directory attribute | App attribute |
|---|---|
| Primary email | email |
| First name | first_name |
| Last name | last_name |
Click Finish.
5Enable the App for Users
- In the app details, click User access
- Select ON for everyone or specific organizational units
- Click Save
6Configure ViksaAI
- Go to Settings → SSO in ViksaAI
- Select SAML 2.0 and Google Workspace
- Enter your email domain
- Paste the IdP details from Step 2
- Complete domain verification and enable SSO
🎉 Complete! Your Google Workspace users can now sign in via SSO.