416.467.9100 | Dundas Data Visualization | Login
Welcome Guest
Dashboard v5.0

This site makes extensive use of JavaScript.

Please enable JavaScript in your web browser and reload the page before proceeding.

Single Sign On

Hide navigation
RSS
Modified on Wed, 11 Dec 2013 02:15 PM Categorized as Administration, Configuration, FAQs, Security, SharePoint, Viewer
Click to return to: Documentation


Overview

Single sign on (SSO) allows users to log in once on their workstation, and gain access to multiple systems without being prompted to log in again at each of the systems. This article provides guidelines on how to use SSO within the Dundas Dashboard application.

Using the built-in Dundas Dashboard pages

The following are the built-In pages that can be used to View the dashboard.


Note: There are differences or limitations when viewing the dashboard in HTML. See HTML Viewing Limitations for details.

Note: Dundas Dashboard Explorer for iPad does not support Windows authentication login. As an alternative, you can use the HtmlExplorer.ashx or HtmlHome.ashx from the Safari browser.

If your Dundas Dashboard Developers and/or Users log in via their Windows accounts, you can configure Dundas Dashboard to also use Windows authentication so users won't have to sign-in twice. See Using Windows Login to Access Dundas Dashboard for the configuration steps.

For a quick reference, the following are the steps needed to enable users to automatically log in using their Windows account:

  1. In Dundas Dashboard Administration, create either a Windows User or a Windows Group account.
  2. In the Dundas Dashboard configuration file, set the
    1. Set the AuthenticationMode to either LocalAndWindows or Windows
    2. Set the AutoWindowsLoginEnabled to True. When Windows login is enabled, and this key is set to True, users are automatically logged in by default (⪚ no need to click the Windows Login button).
  3. Restart IIS.

Note: If you have enabled Windows Log in, but did not set the AutoWindowsLoginEnabled to True, you should see the Windows Login button below when you try to access the application.

Windows Login button in Silverlight

Windows Login button in Silverlight

Windows Login button in HTML

Windows Login button in HTML


Using the Dashboard Viewer in your applications

The Dundas Dashboard Enhanced Viewer makes it easy to add Dashboard viewing to your applications. Refer to the Using the Dashboard Viewer in Your Applications article for more information.

  • To log in using a Dundas Dashboard local user account, use the IntegrationHelper.LoginLocal() method.
    Tip: In case you need to use an already existing set of local user accounts in your database, refer to the Creating Custom Accounts and Groups Providers article.
  • To log in using the user's Windows account, use the IntegrationHelper.GetWindowsLoginToken() method.

Viewing Dundas Dashboard within SharePoint

Integrate the Dundas Dashboard Silverlight Viewer using the Viewer Web Part

Dundas Dashboard for SharePoint is a Web Part that lets your SharePoint users view and interact with available dashboards from your Dundas Dashboard server. You install the Dundas Dashboard Viewer Web Part on your SharePoint server after your Dundas Dashboard installation has already been configured and some dashboards have been created.

If your SharePoint users log in via their Windows accounts, you can configure Dundas Dashboard to use Windows authentication so users won't have to sign-in twice. To use Windows Login in SharePoint:
  1. Enable Windows Login for Dundas Dashboard. See Using Windows Login to Access Dundas Dashboard for the configuration steps.
  2. Create a Windows User or Windows Groups account in Dundas Dashboard.
  3. On the Dundas Dashboard Viewer Web Part connection settings, select Windows.
    Using Windows Login in Dundas Dashboard Viewer Web Part for SharePoint

    Using Windows Login in Dundas Dashboard Viewer Web Part for SharePoint


    Tip: If you run into connection issues, see Troubleshooting SharePoint WebPart Connection.
  4. Set the required WindowsLoginType option from the App.config file. Default key value is LoginOnClient. The available options are:
    • LoginOnClient - This will ping the Dundas Dashboard server to ensure that it is valid and the actual session is created in the Silverlight client.
    • LoginOnServer - This will make a call on the SharePoint server to get a Windows login token. The call will use the current credentials running in SharePoint (⪚ the Windows user accessing the web page).

Integrate the Dundas Dashboard HTML Viewer Page using the SharePoint Page Viewer Web Part

If you need to Integrate the HTML Explorer with SharePoint, follow the steps below:
  1. Enable Windows Login for Dundas Dashboard. See Using Windows Login to Access Dundas Dashboard for the configuration steps.
  2. Create a Windows User or Windows Groups account in Dundas Dashboard.
  3. Add Microsoft's Page Viewer Web Part to a SharePoint page.
  4. Configure the Web Part to point to the HTML Explorer URL.

You can find additional information on the Integrating the HTML Explorer with SharePoint page.

Automatic HTML login using a local user account

If your Dundas Dashboard instance is using local user accounts (⪚ not using Windows accounts), you can optionally enable automatic login by directly specifying the credentials of a local user in the Dundas Dashboard Configuration File.

The automatic login option is useful if you plan on setting up a public demo or kiosk for displaying HTML5 dashboards without requiring users to log in first.

To enable automatic HTML login, go to the HTML SETTINGS section near the end of the config file, uncomment the three HtmlAutoLogin keys and set their values as shown below:

... ...

Afterwards, you must restart the Dundas Dashboard website for the changes to take effect.



Related topics


Click to return to: Documentation

About Dundas | Contact Us Follow us on Twitter! | Privacy Statement | Report Site Issues

Copyright © 2009-2014 Dundas Data Visualization, Inc.