The SSO Tester utility allows you to test the Kentor configuration on a system with predefined SSO without the need to install the full CloudShell Portal version. The SSO Tester utility is used to ensure that the SSO implementation works with your IdP and local configurations. It is recommended to use the SSO Tester utility on your staging environment before implementing CloudShell with Kentor SSO in your production environment.
Before using the SSO Tester utility, make sure to:
- Install the SSO Tester utility
- Create a new website in IIS Manager
- Configure CloudShell to work with SAML SSO
Note: Make sure you have IIS installed on your machine. The SSO Tester utility does not work on machines on which the default IIS Express is installed.
The SSO Tester package includes a web application that tests SSO integration with the CloudShell Portal.
To install the SSO Tester utility:
- Download the SSO Tester package file.
- Extract the contents of the compressed archive to your local directory.
To create a new website in IIS Manager:
Open IIS Manager.
In the Connections pane, right-click Sites.
Select Add Website.
- In the Site name field, specify a name for the site.
- In the Content Directory field, specify a Physical Path, pointing to the Portal folder that resides in the previously extracted SSO Tester.
- In the Binding field, specify an available port and click OK.
In the Connections pane, click Application Pools.
- In the Application Pools window, double-click your new website.
- In the Edit Application Pool window, edit the application pool that was created for your website.
- Verify that the .NET CLR version is 4.0.*.
- Select the Start application pool immediately checkbox, and click OK.
- In the Connections pane, click your website, then in the Actions pane, under Manage Website, click Restart.
- If you are using IIS 8 with Windows Server 2012 or Windows Server 2012 R2, make sure to install the 'Web Server' role within the server manager.
After selecting the web server role, click Next and in the Role Services section, under Application Development, select ASP.NET 4.5.
This sub-role enables IIS to use the ASP.NET 4.5 for running the CloudShell Portal.
Using the SSO Tester utility
To use the SSO Tester utility:
- Browse to the location to which you extracted the tester. Open the customer.config file, and add the URL of the newly created website to the following key:
<add key="CustomAbsoluteLoginPage" value="http://[server]/AuthServices/SignIn" />
- In the same folder, open the kentor.config file, and add the URL of the newly created website as the value of both the
returnUrlattributes of the following key:
- Edit the kentor.config file, according to the requirements described in Sample file requirements.
- Open the CloudShell Portal.
You are redirected to the IdP login page.
- Log in with the credentials of one of the users you defined in the IdP.
A test page with the attributes returned by the IdP is displayed.
If errors are displayed, make the required changes and reload the website.
- if error message HTTP Error 500.19 is issued, change the permissions of the SSO Tester's Portal folder and reload the website.
- If changes were made to the kentor.config file, reset the application in the IIS Manager.