Security Assertion Markup Language (SAML)

SAML is a widely-used XML-based authentication standard that enables federated Single Sign-On (SSO). It allows users to log into Zoho Analytics using credentials from a central Identity Provider (IdP) such as Azure AD, Okta, or OneLogin.

How It Works:

  1. The user tries to access Zoho Analytics.
  2. They are redirected to your Identity Provider (IdP) for authentication.
  3. After successful login, the IdP sends a SAML assertion (a secure message) back to Zoho Analytics.
  4. The user is granted access based on the attributes in the assertion.

Structure of SAML Assertion:

  • Contains user identity and metadata.
  • Signed using X.509 certificates for integrity and authenticity.
  • Includes optional attributes like email, user role, etc.

Configuring SAML for White Label Instance:

Once the White Label solution has been enabled for your account, easily configure it by using the following steps:

  1. Login to your Zoho Analytics account.
  2. Click the Settings icon at the top right corner.
  3. The Settings page will open. Navigate to the White Label section on the left side pane.
  4. The White Label Settings page will open. Provide the following rebranding details.
Rebranding DetailsDescription
Domain Name

Specify the custom domain where your White Label solution will be hosted (e.g., analytics.finepick.com).

Note: Once the domain is set, it cannot be modified directly by you. To request changes, please contact us at support@zohoanalytics.com.

Product NameEnter the name of your product. This name will replace all instances of “Zoho Analytics” across the user interface and communications.
Product Logo

Upload the logo to be used in your White Label application.

Supported formats: .gif, .jpg, .png, .bmp

Recommended dimensions: 300 x 60 px

This logo will replace the Zoho Analytics logo in the portal.

Favicon

Upload an icon to be displayed in the browser tab alongside the page title.

Recommended dimensions: 30 x 30 px

Support Email AddressProvide a support email address that will be shown in all system communications, replacing the default Zoho Analytics support address (support@zohoanalytics.com).
Metadata FileUpload the SAML metadata XML file that contains configuration details required for integration with your Identity Provider.

After completing the configuration, click Submit. You will then be prompted to complete Domain Verification. Click the link below for detailed instructions.