Hypersocket SSO Getting Started Guide Lee Painter HYPERSOCKET LIMITED Unit 1, Vision Business Centre, Firth Way, Nottingham, NG6 8GF, United Kingdom Table of Contents PREFACE ...................................................................................................................................... 4 DOCUMENT OBJECTIVE ............................................................................................................................ 4 Audience ......................................................................................................................................... 4 Document Organization ................................................................................................................. 4 DOCUMENT CONVENTION ........................................................................................................................ 5 DOCUMENTATION FEEDBACK .................................................................................................................... 5 OBTAINING TECHNICAL ASSISTANCE ........................................................................................................... 5 INTRODUCTION ........................................................................................................................... 6 WHAT IS A SSO? .................................................................................................................................... 6 KEY BENEFITS OF HYPERSOCKET SSO .......................................................................................................... 6 INSTALLING HYPERSOCKET SSO .................................................................................................... 7 NETWORK DEPLOYMENT .......................................................................................................................... 7 LAN ................................................................................................................................................. 7 DMZ ................................................................................................................................................ 8 FIREWALL RULES ..................................................................................................................................... 8 SUPPORTED PLATFORMS .......................................................................................................................... 8 INSTALLING HYPERSOCKET ........................................................................................................................ 9 THE SETUP WIZARD ................................................................................................................................. 9 Step 1 – License Agreement ......................................................................................................... 10 Step 2 – Set Password .................................................................................................................. 10 Step 3 – Upload License Key ......................................................................................................... 11 Step 4 – Download/Install Components ....................................................................................... 11 Step 5 – Configure SSL Certificate ................................................................................................ 11 Step 6 – Complete Setup............................................................................................................... 13 Logging in for the First Time ......................................................................................................... 13 INSTALLING SSO EXTENSIONS ..................................................................................................... 14 AVAILABLE FEATURES ............................................................................................................................. 15 Passwords->Browser Password Manager .................................................................................... 15 Passwords->SAML Identity Provider ............................................................................................. 15 Passwords->Password Server ....................................................................................................... 15 SETTING UP RESOURCES ............................................................................................................. 16 REALMS ............................................................................................................................................... 16 BROWSER CREDENTIALS RESOURCES ........................................................................................................ 18 What is a Browser Credentials Resource? .................................................................................... 18 Configuring form detection .......................................................................................................... 18 An example browser credential configuration ............................................................................. 19 SAML RESOURCES ................................................................................................................................ 22 What is a SAML Resource? ........................................................................................................... 22 An example SAML configuration .................................................................................................. 22 PASSWORD RESOURCES ......................................................................................................................... 27 What is a Password Resource? ..................................................................................................... 27 A password resource example ...................................................................................................... 27 PLEASANT PASSWORD SERVER SUPPORT ................................................................................................... 30 What is Pleasant Password Server? ............................................................................................. 30 An example configuration ............................................................................................................ 30 INSTALLING THE BROWSER SSO EXTENSION ............................................................................... 32 LAUNCHING RESOURCES ............................................................................................................ 33 SSO RESOURCES ................................................................................................................................... 33 Usernames and Passwords ........................................................................................................... 33 Web GUI ....................................................................................................................................... 34 Browser SSO Extension ................................................................................................................. 34 Direct URL Access ......................................................................................................................... 35 PASSWORD RESOURCES ......................................................................................................................... 35 TROUBLESHOOTING ................................................................................................................... 37 CONNECTION IS NOT PRIVATE/CERTIFICATE ERRORS..................................................................................... 37 CANNOT CONNECT TO THE WEB UI .......................................................................................................... 37 Has the service started? ............................................................................................................... 37 Check firewall port forwarding ..................................................................................................... 38 HYPERSOCKET CLIENT DOESN’T REMEMBER THE SERVER URL ....................................................................... 38 BROWSER SSO EXTENSION DOES NOT CLICK LOG ON .................................................................................. 38 I HAVE A PROBLEM BUT IT’S NOT ANSWERED HERE ...................................................................................... 38 Preface This preface introduces the Hypersocket SSO Getting Started Guide. It has been broken down into the following sections: . Document Objective . Document Convention . Documentation Feedback . Obtaining Technical Assistance Document Objective The objective of this document is to provide the System Administrator with an overview of installing and configuring the Hypersocket SSO product from Hypersocket Software. Hypersocket SSO allows your users to automatically pass their credentials to any website and log them on. Audience This guide is for anyone who wishes to successfully install and administrate the Hypersocket SSO product. Although this is often someone concerned with product installation and administration, it may also be a useful guide to managers whom may be considering deploying the Hypersocket SSO as a solution. This guide is expected to be useful if you are performing any of the following tasks . Installing an instance of the Hypersocket SSO . Configuring