Troubleshoot single sign-on (SSO)

This document provides steps to resolve common error messages encountered during the integration or use of SAML-based unmarried sign-on (SSO) with Google Workspace when Google is the service provider (SP).

Configuration and Activation

"This domain is not configured to use single sign-on."

This error typically indicates that yous're trying to utilise single sign-on with a Standard (Complimentary) Edition of One thousand Suite, which doesn't back up SSO. If y'all're certain that you're using a Google Workspace edition that supports SSO, check the configuration in your identity provider to ensure that you lot have entered your Google Workspace domain proper name correctly.

"This account cannot be accessed considering the domain is incorrectly configured. Delight try once more later on."

This error indicates you haven't ready up SSO correctly in the Google Admin console. Please review the following steps to right the situation:

  1. In the Admin console, go toSecurityand thenSet single sign-on (SSO) with a 3rd party IdP, and cheque theReady SSO with third-party identity provider box.
  2. Provide URLs for your organisation'due south sign-in page, sign-out page, and change password folio in the corresponding fields.
  3. Choose and upload a valid verification certificate file.
  4. Click Save, wait a few minutes for your changes to take effect, and test your integration again.

Parsing the SAML Response

"The required response parameter SAMLResponse was missing"

This error message indicates that your Identity Provider is non providing Google with a valid SAML response of some kind. This problem is nigh certainly due to a configuration issue in the Identity Provider.

  • Cheque your Identity Provider logs and make sure that there is zero preventing it from correctly returning a SAML Response.
  • Ensure that your Identity Provider is not sending Google Workspace an encrypted SAML Response. Google Workspace only accepts SAML Responses that are unencrypted. In particular, please notation that Microsoft's Active Directory Federation Services two.0 often sends encrypted SAML Responses in default configurations.

"The required response parameter RelayState was missing"

The SAML 2.0 specification requires that Identity Providers think and send dorsum a RelayState URL parameter from Resource Providers (such as Google Workspace). Google Workspace provides this value to the Identity Provider in the SAML Request, and the exact contents can differ in every login. For authentication to complete successfully, the exact RelayState must exist returned in the SAML Response. According to the SAML standard specification, your Identity Provider should not modify the RelayState during the login period.

  • Diagnose this issue further by capturing HTTP headers during a login attempt. Extract the RelayState from the HTTP headers with both the SAML Request and Response, and brand sure that the RelayState values in the Request and Response match.
  • Most commercially-available or open-source SSO Identity Providers transmit the RelayState seamlessly by default. For optimum security and reliability, we recommend that you use one of these existing solutions and cannot offering back up for your own custom SSO software.

Contents of the SAML Response

"This service cannot be accessed because your login request contained invalid [destination|audience|recipient] information. Please log in and try once again."

This error indicates that the destination,audience or recipient elements in the SAML exclamation independent invalid data or were empty. All elements must be included in the SAML assertion. Check the following table for descriptions and examples for each element.

Element <Audience>
Description URI that identifies the intended audience which requires the value of ACS URI. Note: chemical element value cannot exist empty
Required Value https://world wide web.google.com/a/<example.com>/acs
Example

<saml:Conditions NotBefore="2014-eleven-05T17:31:37Z"
NotOnOrAfter="2014-11-05T17:37:07Z">
<saml:AudienceRestriction>
<saml:Audience>https://www.google.com/a/example.com/acs
</saml:Audience>
</saml:AudienceRestriction>
</saml:Weather>

Element Destination attribute of the <StatusResponseType> type
Description URI the SAML assertion is sent to. Optional, just if alleged information technology volition demand a value of the ACS URI.
Required Value https://www.google.com/a/<instance.com>/acs
Instance

<saml:Response
xmlns:samlp="urn:oasis:names:tc:SAML:2.0:protocol"
xmlns:saml="urn:oasis:names:tc:SAML:ii.0:assertion"
ID="7840062d379d82598d87ca04c8622f436bb03aa1c7"
Version="2.0"
IssueInstant="2014-eleven-05T17:32:07Z"
Destination="https://www.google.com/a/instance.com/acs"
InResponseTo="midihfjkfkpcmbmfhhoehbokhbkeapbbinldpeen">

Element Recipient aspect of <SubjectConfirmationData>
Description
  • Defines the entity intended to receive the Field of study.
  • Required attribute, which must contain the ACS URI.
  • Case sensitive.
Required Value https://world wide web.google.com/a/<example.com>/acs
Example

<saml:Subject>
<saml:NameID SPNameQualifier="google.com/a/case.com"
Format="urn:haven:names:tc:SAML:ii.0:nameid-format:e-mail">user@example.com</saml:NameID>
<saml:SubjectConfirmation Method="urn:oasis:names:tc:SAML:2.0:cm:bearer">
<saml:SubjectConfirmationData NotOnOrAfter="2014-11-05T17:37:07Z"
Recipient="https://world wide web.google.com/a/example.com/acs"
InResponseTo="midihfjkfkpcmbmfhjoehbokhbkeapbbinldpeen"/>
</saml:SubjectConfirmation>
</saml:Subject>

For details of all the required elements, delight review the commodity SSO exclamation requirements.

"This service cannot be accessed because your login request contained no recipient data. Delight log in and try again."

This error normally indicates that the SAML Response from your Identity Provider lacks a readable Recipient value (or that the Recipient value is incorrect). The Recipient value is an important component of the SAML Response.

  1. Diagnose this issue farther by capturing HTTP headers during a login attempt.
  2. Extract the SAML Request and Response from the HTTP headers.
  3. Ensure that the Recipient value in the SAML Response exists and that it matches the value in the SAML Request.

Note: this error message may also announced as "This service cannot exist accessed because your login asking contained invalid recipient data. Please log in and endeavour again."

"This account cannot exist accessed because the login credentials could not be verified."

This error indicates a problem with the certificates y'all're using to sign the authentication catamenia. It ordinarily means the individual key used to sign the SAML Response doesn't match the public key certificate that Google Workspace has on file.

It can also occur if your SAML Response doesn't contain a viable Google Accounts username. Google Workspace parses the SAML Response for a XML element chosen a NameID, and expects this element to comprise a Google Workspace username or a full Google Workspace electronic mail address.

  • Ensure that you've uploaded a valid certificate to Google Workspace, and if necessary supervene upon the certificate. In the Google Admin console, get toSecurityand thenPrepare single sign-on (SSO) with a third party IdP and click Supersede certificate.
  • If you're using a total email address in your NameID element (you lot must be if you are using SSO with a multidomain Apps environment), ensure that the Format attribute of the NameID element specifies that a total email accost is to exist used, as in the following example: Format="urn:oasis:names:tc:SAML:two.0:nameid-format:email"
  • Ensure that y'all're populating the NameID chemical element with a valid username or electronic mail address. To be sure, extract the SAML Response you're sending to Google Workspace, and check the value of the NameID element.
  • NameID is case-sensitive: ensure that the SAML Response is populating NameID with a value that matches the instance of the Google Workspace username or electronic mail address.
  • If your Identity Provider is encrypting your SAML Exclamation, disable encryption.
  • Ensure that the the SAML Response doesn't include whatsoever non-standard ASCII characters. This upshot most commonly occurs in the DisplayName, GivenName, and Surname attributes in the AttributeStatement, for example:
    • <Aspect Name="http://schemas.microsoft.com/identity/claims/displayname">
      <AttributeValue>Blüte, Eva</AttributeValue> </Attribute>
    • <Attribute Name="http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname">
      <AttributeValue>Blüte</AttributeValue> </Attribute>

For more information on how to format the NameID element, see SSO exclamation requirements.

"This service cannot exist accessed considering your login credentials have expired. Please log in and attempt again."

For security reasons, the SSO login flow must complete inside a certain timeframe, or hallmark will fail. If the clock on your Identity Provider is incorrect, well-nigh or all login attempts will appear to exist out of the acceptable timeframe, and authentication will fail with the above error bulletin.

  • Bank check the clock on your Identity Provider's server. This error is almost always caused by the Identity Provider's clock being incorrect, which adds incorrect timestamps to the SAML Response.
  • Re-sync the Identity Provider server clock with a reliable internet time server. When this issue suddenly occurs in a production environment, it is typically because the last time sync failed, causing the server time to become inaccurate. Repeating the time sync (maybe with a more reliable time server) volition quickly remedy this issue.
  • This result can also occur if you are re-sending SAML from a previous login endeavor. Examining your SAML Request and Response (obtained from HTTP header logs captured during a login try) can help y'all debug this further.

"This service cannot be accessed because your login credentials are non yet valid. Delight log in and try once more."

For security reasons, the SSO login period must complete inside a sure timeframe, or authentication will fail. If the clock on your Identity Provider is incorrect, nigh or all login attempts volition appear to be out of the acceptable timeframe, and hallmark will fail with the to a higher place error message.

  • Check the clock on your Identity Provider'southward server. This fault is almost always caused by the Identity Provider's clock beingness incorrect, which adds incorrect timestamps to the SAML Response.
  • Re-sync the Identity Provider server clock with a reliable cyberspace fourth dimension server. When this issue of a sudden occurs in a product surroundings, it is typically because the last time sync failed, causing the server time to get inaccurate. Repeating the time sync (possibly with a more reliable time server) will quickly remedy this effect.

Was this helpful?

How can we better information technology?