Directory Apps - G Suite | Marketplace Installation Guides - Zoho One

Google Workspace for Zoho Directory

Prerequisites

  1. Google Workspace admin role
  2. Zoho One admin role

Configure SAML in Zoho One

  1. If you're a Zoho Directory user:
    1. Sign in to Zoho Directory, then click Admin Panel in the left menu.
    2. Go to Applications, then click Add Application.
    3. Use the search bar to find and add Google Workspace and continue from step 5 in the next section.
  1. If you're a Zoho One user:
    1. Sign in to Zoho One, then click Directory in the left menu.
    2. Go to Marketplace, then click Browse Applications.
    3. Use the search bar to find and install Google Workspace.
    4. Check the Terms of Services given in Confirm Installation page and click Install. Upon installation, you will be taken to the Applications module.
    5. Name your app using Display name and enter your Google Workspace Domain Name.
      Info
      Note: In the Google Admin console, search for Domains, click Manage Domains to find your Domain Name.
    6. If needed, use the checkboxes to add Google Workspace's associated apps such as Gmail, Google Drive. You can also associate any unlisted Google apps with Google Workspace by adding them as non-directory associated apps.
      Info
      Note: For Single Sign-On (SSO) to work, the associated apps must be enabled in Google Workspace.
    7. If you want to test the SAML configuration before allowing users to access Google Workspace, uncheck Display app to users.
    8. Click Add, you will be redirected to the Google Workspace's details page.
    9. Go to Single Sign-On tab.
    10. Click Service Provider Details to check and verify the SP details. You can also edit them if needed.
    11. Click Identity Provider Details, download the X.509 Certificate. Make a note of the Sign-in URL, the Sign-out URL, and the Change Password URL.

Configure SAML in Google Workspace

  1. Sign in to your Google Workspace admin account.
  2. Click Security in the left menu, under Authentication section find and click SSO with third-party IDPs.
  3. Click ADD SAML PROFILE.
  4. Enter the IdP Sign-in URL in the Sign-in page URL field, the IdP Sign-out URL in the Sign-out page URL field, and the IdP Change Password URL in the Change password URL field.
  5. Upload the IdP X.509 Certificate under Verification certificate.
  6. Click Save.

Test the SAML connection

  1. Return to the Zoho Directory Admin Panel.
  2. Go to Applications, then click Google Workspace.
  3. Click Assign Users, choose yourself from the list, then click Assign. Users assigned to Google Workspace will also be assigned to the associated apps.
  4. Click  . If everything is working, you should be automatically signed in and taken to Google Workspace's homepage.

Make app visible to all users

After successfully testing the SSO, you can make Google Workspace available for all users to access from their My Apps pages.
To make Google Workspace visible to all users:
  1. Sign in to the Zoho One Admin Panel.
  2. Go to Applications, then click Google Workspace.
  3. Click Unhide.
    Info
    Note: If you've added any associated apps, ensure that they are also made visible to users.
  4. You can now access Google Workspace from Zoho One's My Apps page.