HTTPS SSO Setup Guide

This page guides you through the steps in getting started with the SSO Proxy Server.

For more advanced options, see Entry Settings.

NOTE: SSO currently is not compatible with logins where a username and password are entered on different pages
(e.g. Gmail).

Introduction

The following instructions include an example using HTTPS SSO to sign into a Wikipedia account.
To get started with this example, ensure that the proxy setup for your device has been completed according to the appropriate Client Setup instructions.

Example login information:
Username

JohnSmithSSO

Password

changeme123

NOTE: These credentials are for demonstration only.

1. Browser Configuration

Follow the Client Setup steps for your browser so the proxy settings are used.

2. (Optional) Enter a SSO Credential into Pleasant Password Server

HTTPS will work with existing or new credentials. For use in the example, a new credential will be entered.

  1. Open the Pleasant Password Server website and log in.
  2. Click on a folder from the left sidebar of the home page.
  3. Click the Folder Actions drop down button and choose Add Entry.
  4. In the Credential Details popup, enter the Title, Username, Password for the credential.  

    My Login Account

    and the following text in the Username field:

    JohnSmithSSO

    and the following text in the Password field:

    changeme123

    HTTPS-SSO-Credential-Details.png
  5. Press the Save button and a row for the entry should now appear in main grid.

3. SSO Settings

  1. For the credential to be used with HTTPS SSO, click on the Actions dropdown and choose SSO.
  2. You may keep or change the existing placeholders.  Placeholders can be inherited through the folder hierarchy, allowing the same placeholder to be used for multiple logins.

    Important Notes
    If the placeholders are customized, they should be atyptical values (ie. login@ rather than login). Common values may result in failed login attemps.
    While SSO obscures the Username on login, the webpage may display it regardless. ie. "Welcome JohnSmithSSO".

    For this example the placeholders are changed to:
    SSO-Settings-Wikipedia.png
  3. In the SSO Dialog popup, enter the part of the address of the login page before the question mark in the Post URL field. From the example of Wikpedia

    https://en.wikipedia.org/w/index.php...dReturn%3Dtrue

    is shorted to the following in the Post URLs field:

    https://en.wikipedia.org/w/index.php

    Redirect Early URLs are a list of URLs (i.e. website addresses), separated by spaces or on separate lines, for which the proxy server should authenticate earlier than usual. This setting is mainly for certain websites on which the proxy login does not work properly even when the Post URLs are specified, and can be left blank for most entries.
     
  4. Press the Save button. 

4. Signing into the SSO account.

You can now sign into your email account as follows:

  1. Navigate to the browser login page. (ie https://en.wikipedia.org/w/index.php)
  2. In the Username field, enter the placeholder username for the credential. (ie. login@)
  3. In the Password field, enter the placeholder password for the credential. (ie. pass@)
  4. Press the Login In button, or equivalent.
  5. If your browser is not logged in to Pleasant Password Server you will be redirected to the SSO server login page - to enter your Pleasant Password Server username and password and verify your SSO access.
  6. The service will now be logged in to with the placeholder credentials taking the place of the true username and password.

Sign-in.png

Tag page
You must login to post a comment.