This page shows how to configure Google Workspace Single Sign-On (SSO) using SAML 2.0. This allows users from your verified email domain to sign in to digital signage with their Google Workspace account.
Prerequisites
You have administrator access to your Google Workspace Admin console.
You have administrator access to your digital signage account.
You have an email domain that belongs to your organization.
You have a unique SP Entity ID value for digital signage. This value is used in both Google Workspace and digital signage, and it must be a valid identifier with no spaces.
After creating the SAML app in Google Workspace, add the Google Identity Provider details in digital signage.
Go to Settings.
Open Single Sign-On.
Select SAML 2.0 as the protocol.
Enter a Display name, for example Google Workspace.
Enter your organization email domain in Email domains, then press Enter. Example: example.com (it may appear as @example.com after saving).
Enter the SP Entity ID. This must exactly match the Entity ID configured in the Google Workspace service provider details. Use an ID-style value with no spaces, for example digital-signage-sso-example.
Next, provide the Google Identity Provider details: the IdP Entity ID, SSO URL (Sign-in URL), and X.509 Certificate(s). You can fill these in two ways: upload the metadata file to populate them automatically, or paste each value manually.
[image: Single Sign-On Settings]
Upload the metadata XML (recommended)
If you downloaded the metadata file in step 3, you can upload it to fill the identity provider fields automatically instead of copying each value by hand.
Click Upload metadata XML.
Select the metadata file you downloaded from Google Workspace, for example GoogleIDPMetadata.xml.
Digital Signage reads the file and fills in the IdP Entity ID, SSO URL (Sign-in URL), and X.509 Certificate(s) fields for you.
Review the values to confirm they are correct.
Click Save configuration.
Uploading the file only fills in the fields. Your configuration is not saved until you click Save configuration, so you can review or adjust the values first.
Enter the details manually
If you copied the individual values in step 3 instead of downloading the metadata file, enter them by hand.
Paste the Google Workspace Entity ID into IdP Entity ID.
Paste the Google Workspace SSO URL into SSO URL (Sign-in URL).
Paste the Google Workspace signing certificate, in PEM format, into X.509 Certificate(s). Include the full certificate, from -----BEGIN CERTIFICATE----- to -----END CERTIFICATE-----.
Click Save configuration.
Verify Your Domain
After saving the SSO configuration, Digital Signage will show a Domain verification section. Your SSO provider is not active until the domain is verified.
Copy the Host / Name value.
Copy the TXT value.
Open your DNS provider or domain host.
Add a new TXT record using the values shown in Digital Signage.
Save the DNS record and wait for DNS propagation.
Return to Digital Signage and click Verify domain.
After your DNS TXT record is verified, Digital Signage shows the domain as Verified and activates the SSO provider.
From this section, you can:
Copy the SSO login link and share it with users for one-click SSO sign-in.
Turn on Enforce SSO for these domains if users with the verified email domains should only sign in with SSO.
Keep enforcement off if you still want users to sign in with password or social login.
When SSO enforcement is enabled, users with the verified email domains can only sign in through SSO. Password and social logins are blocked for those domains. Account admins are exempt.
The setup above uses SAML 2.0, which is the recommended protocol for Google Workspace. If your identity provider supports OpenID Connect (OIDC), you can use that protocol with Digital Signage instead.
Go to Settings > Single Sign-On.
Select OpenID Connect (OIDC) as the protocol.
Enter a Display name and your organization Email domains.
Enter the Issuer URL from your identity provider.
Enter the Client ID and Client Secret from the application you registered with your identity provider.
Click Save configuration.
Verify your domain the same way as the SAML setup. See Verify Your Domain.
Issuer URL auto-discovery
With OIDC you only need to provide the Issuer URL. Digital Signage uses it to discover your provider’s endpoints automatically through the provider’s discovery document (/.well-known/openid-configuration), so you do not need to enter the authorization, token, or JWKS endpoints by hand.
You can paste the issuer in whatever form your provider gives you. When you click out of the field, Digital Signage cleans it up automatically:
It adds https:// if the address has no scheme.
It removes a trailing slash.
It trims a full discovery link that ends in /.well-known/openid-configuration down to the issuer.
Make sure the SP Entity ID in Digital Signage exactly matches the Entity ID in Google Workspace.
Make sure the SP Entity ID does not contain spaces. Use letters, numbers, hyphens, or underscores.
Make sure the ACS URL is entered exactly as shown in this guide.
Make sure the Google Workspace app is enabled for the user, group, or organizational unit.
Make sure the user’s email domain is added in Digital Signage and saved.
If the certificate was copied manually, make sure the full PEM certificate is included.
If uploading the metadata file does not fill the fields, make sure you selected the metadata XML downloaded from Google Workspace (for example GoogleIDPMetadata.xml) and not another file.
After uploading the metadata file, remember to click Save configuration. The upload fills the fields but does not save the configuration on its own.
For OIDC, make sure the Issuer URL is the base issuer, not the full discovery link. Digital Signage trims a pasted discovery link automatically, but you can also enter the issuer directly.
If the user cannot access Digital Signage immediately, wait a few minutes and test again.