Register
   
19 November 2017
Single Sign-On
Introduction

The Interzoic Single Sign-On application installs in a DotNetNuke (DNN) portal framework and provides User account management and auto-login/single sign-on (SSO) services from a remote website to the host DNN portal. The remote server utilizes REST based Web Services provided by the Interzoic SSO to query and set User account, profile and role data in the DNN portal. The Web Services also provide a secure Login Token that the remote website can include in a URL string that will allow an authorized User to auto-authenticate and auto-login to the DNN portal.

Included Products
  • Interzoic Single Sign-On Administrative Module
  • 1 Year of Maintenance and Enhancements
  • REST Based Web Services
  • .NET API Library
  • SSO Client Testing Harness with Source Code
  • Extensive Examples and VS Test Cases
  • Electronic CHM Documentation
  • PDF User's Guide
  • 4 Hours of Support

The Single Sign-On Tips blog article provides useful tips on how configure your site for better SSO integration: hide Login controls; redirect for secure content and redirect after Logout.

Auto-Login & Administrative Module

The SSO application is installed in a DNN portal framework using the standard procedure for installing a DNN module. Once installed, the SSO Auto-Login module can be added to any page that you want to be a target landing page from the remote server. The administrative/configuration options will be secured, only available for Users with “Edit” permissions to the module. The module does not have a visible UI, so non-Admin Users will not be able to detect its presence.

Installation and Configuration

The Interzoic Single Sign-On application installs in the DotNetNuke (DNN) portal framework using the standard module installation process.  Once installed, add the module to any page that you want to use as a “Landing” page.  Once SSO Administration options are set, the web services will be functional.  

Access the “SSO Configuration” UI from the Action Menu drop down.






  • Selected Portal: Portal Selection DropDown (Host can access all portals)
  • Web Services URI: Available URIs based on Portal Aliases
  • SSO Users: For the currently selected portals, the list of available SSO user accounts, which (when enabled) will be allowed to perform web services requests. You can add/edit/delete SSO user accounts from this page. 
    NOTE: By default no account will be created for you. You must create at least one SSO user in order to perform web services requests. 
  • Enable Web Services: Enable/Disable
  • Accept only HTTPS: Enable/Disable
  • SSO Token Timeout: Seconds that Token will remain valid
  • Success Redirect URL: URL to redirect to if successful login
  • Reject Redirect URL: URL to redirect to if rejected login
  • Enable SSO Failure Message: Enable/Disable
  • Audit 'View' Utilization: Enable/Disable
  • Audit 'Edit' Utilization: Enable/Disable
  • Audit Unauthorized Utilization: Enable/Disable
  • Password for POST Submissions: If a value has been set, the auto-login via POST will be enabled.


License Configuration

On the same “SSO Configuration” UI, under the "License Key and Details" section, you can see the current 'Server Signature' which you'll need to provide when requesting a 'Codebase' license. For regular licenses keys, you should provide us the 'Current Domain' value.
To apply/install your license, simply paste its content in the 'License Key' text box.
 

SSO Web Services

As part of the Interzoic SSO module installation, REST web services are deployed but not enabled. Once SSO Administration options are set, the web services will be functional.

A Help URI is available that provides the most current information about the available services and how to use them. For example:
http://demo.accordlms.com/DesktopModules/Interzoic-SSO/Service.svc/help




Authorization and Authentication

The authorization and authentication approach for the SSO module was drawn from Amazon S3 REST web services.

Single Sign-On Services

Token Services
  • UserLoginTokenGet (PortalID, Username)
User Services
  • UserGet (PortalID, Username)
  • UserDelete (PortalID, Username)
  • UserRemove (PortalID, Username)
  • UserUpdate (PortalID, Username, UserInfoDataContract)
User Roles Services
  • UserRolesGet (PortalID, Username)
  • UserRoleGet (PortalID, Username, Rolename)
  • UserRoleDrop (PortalID, Username, Rolename)
  • UserRoleUpdate (PortalID, Username, Rolename, UserRolesInfoDataContract)
Portal Roles Services
  • PortalRolesGet (PortalID)
Profile Services
  • UserProfileGet (PortalID, Username)
  • UserProfileUpdate (PortalID, Username, ArrayOfUserProfileInfoDataContract)

SSO Client - Testing Harness

A .NET Windows client testing harness, SSOClient.exe, is included at no additional cost.   It exercises the full range of SS0 web services.  Both the executable and all the VB.net source code are provided.  This makes it easy to create your own communications in any programming language and provides best practices working examples if you will be communicating from another platform.




SSO Client - .NET API library

A .NET client clibrary is included at no additional cost.   It exercises the full range of SS0 web services.  Both the DLL and all the VB.net source code are provided.  This makes it easy to create your own communications in any .NET language and provides best practices working examples if you will be communicating from another platform.

Sample Usages

Getting a Login Token
Dim credentials As New Interzoic.SSO.Client.API.Credentials(0, "AuthenticateUserName", "UserPassword")
Dim baseUri As String = "http://www.example.com/DesktopModules/Interzoic-SSO/Service.svc/"
Dim client As New Interzoic.SSO.Client.API.Connection(credentials, baseUri)
Dim statusCode As System.Net.HttpStatusCode
Dim token As String = client.GetUserLoginToken(0, "UserName", statusCode)

Getting a User's Roles
Dim credentials As New Interzoic.SSO.Client.API.Credentials(0, "AuthenticateUserName", "UserPassword")
Dim baseUri As String = "http://www.example.com/DesktopModules/Interzoic-SSO/Service.svc/"
Dim client As New Interzoic.SSO.Client.API.Connection(credentials, baseUri)
Dim statusCode As System.Net.HttpStatusCode
Dim userRolesList As List(Of UserRoleInfoDataContract) = client.UserRolesGet(0, "UserName", statusCode)


Documentation

Extensive and up to date PDF User's Guide and electronic .NET API documentation.





Free Trial
Free Trial Version Download Now

Accord LMS



  • SCORM Compliant
  • Blended Learning
  • Personalized Training
  • Management Delegation
  • Utilization Reports
  • eCommerce, Social Networking
  • Distributed Channels
  • Intuitive, Web 2.0
  • Full Documentation
  • Unmatched Value


  more information  

Copyright (c) 2017 Interzoic Media LLC   |  Privacy Statement  |  Terms Of Use  |  Contact Us