Not logged in - Login

  User Manual

  Tech Support

Single Sign On in ServicePRO

Setup Required in ServicePRO application

While authenticating via One Login, login is only possible via email address.

To authenticate OneLogin’s Single Sign-on settings in ServicePRO:

  1. From the ServicePRO Workbench, select Setup/Administration.
  2. From here, navigate to the Configuration Tab.
  3. Select System Options.
  4. Select the Single Sign-on Settings option on the left side bar.
  5. Enable Single sign-on functionality and edit details below by selecting the first checkbox option.

Provider tab

The following options are available under the Single Sign-on Settings page’s Provider tab. Information for each field can be found on OneLogin’s website, as noted in each section below.

  • Provider: OneLogin

  • Login URL: The first part of the URL will be unique for each client
    • https://[unique identifier].onelogin.com/api/v3/saml/assertion
    • In the example below, serviceproqa is the unique section of the URL

  • Automatically create user in self-service portal option: If checked, will sync the user from OneLogin to ServicePRO

Sync tab

The following options are available under the Single Sign-on Settings page’s Sync tab.

  • Sync URL: The first part of the URL will be unique for each client
    • https://[unique identifier].onelogin.com/api/v3/users.xml
    • In the example below, serviceproqa is the unique section of the URL

Interval: Set the frequency for User Imports f rom OneLogin by Starwatch Service , in hours  Import Users button : Manual ly import users from OneLogin  Fields that are sync ed upon User Import will include Email Addr ess, User Na me & Status ( active or inactive ) Help Desk Technology Corporation 17 ServicePRO OneLogin Integration Verify tab Users can use these options to verify the status of their OneLogin User IDs by entering the requested information.  User Id: Enter the User Id for the account to be used with OneLogin  Password: Enter the Pas sword associated with the User Id account  Login: Test the OneLogin functionality  Status : States the status of the logged in user To log in as a User for the verification process, ensure that the User has accounts set up properly on both ServicePRO and OneLogin. This includes:  Setting up User accounts with Manage Users (if not present) in ServicePRO  E nsuring the User is associated with the ServicePRO appl ication in OneLogin (See Step 6 in the section Return to OneLogin Website – Active Directory Setup ) In the example below, the User “Joe Johnson” has the ServicePRO app added to their list of applications on the User Page in OneLogin. Help Desk Technology Corporation 18 ServicePRO OneLogin Integration Prerequisites and Limitations UserID Single sign - on (SSO) with OneLogin requires an email address ( a primary SMTP ema il address) for User IDs when logging in. UserID or UserName cannot be used to log in, as OneLogin’s free plan does not allow these fields to be mapped. Set Active Directory Authentication Method In order for SSO to begin working , Administrator s will need to ensure all users imported from the Active Directory has the Active Directory authentication method set. Passthrough Authentication Passthrough Authentication is not possible with SSO using OneLogin . User Synchronization (Importing Users from OneLo gin) An alternative method for user provisioning is currently being used ; the current API is not officially supported by OneLogin for User Import from Active Directory via OneLogin. As a result, restrictions on User Synchronization will be present:  Only a pproximately 1000 users may be imported  Field m apping can only be performed on User Name and Email Address fields  Imported users will need to be assigned to a default organizational unit . Administrators will be able to adjust the user properties at a late r point if needed