The information in this guide is correct as of Last Verified : 1st September 2021
| Table of Contents |
|---|
...
Navigate to the SSO Settings tab found on the System Settings page, under the Administration Settings menu header, and download the SPMetadata.xml.
...
...
| Info |
|---|
Keep hold of this file for a later step. |
Configure an Application in PingOne
...
In the desired environment navigate to Connections - Applications and click the
...
icon to add a new Application.
...
PingOne also requires some additional ACS URL’s in order to accept the redirects to features such as Kiosk, Maps, and Mobile App use. The below table lists the required ACS URL’s URL with the expected format.
...
| Note |
|---|
The below URL’s are case sensitive and should be added exactly as formatted replacing only the RX URL and the ID number where applicable |
Feature | ACS URL Required | Examples |
|---|---|---|
Admin Console | https://<RXurl>/SsoConsumer?r=%2f | https://company.rx-cloud.com/SsoConsumer?r=%2f |
Kiosk | https://<RXurl>/SsoConsumer?r=%2fkiosk%2f%3fID%3d1 | For a system with 3x Kiosk profiles with ID numbers 1 to 3, the below additional ACS URL’s would be required
|
Maps | https://<RXurl>/SsoConsumer?r=%2fMaps%2f%3fID%3d1 | For a system with 3x Map profiles with ID numbers 1 to 3, the below additional ACS URL’s would be required
|
Mobile App | https://<RXurl>/SsoConsumer?r=%2f%3fma%3d1 | https://company.rx-cloud.com/SsoConsumer?r=%2f%3fma%3d1 |
The remaining options in the Configure SAML section can be left with the default values.
...
Table 1.1 - Attribute Mappings
PingOne User Attribute | Application Attribute | Required |
|---|
Given Name |
| Required |
Family Name |
| Required |
Email Address |
| Required |
RFID
|
|
| Optional | |
Access Code
|
|
| Optional | |
RX Default Location
|
|
The ID number for the Location that the user will have default access to.
To get the Location ID number, navigate to the location edit screen. Administration Settings → System Settings → Locations Then select the Edit Button ( | Optional | |||
RX Allowed Location
|
|
A comma separated list of Location ID numbers that the user has access to.
To get the location ID number, navigate to the location edit screen. Administration Settings → System Settings → Locations Then select the Edit Button ( | Optional | |||
Date Format
|
|
The date format for the user.
| Optional | |
RX Roles
|
|
A comma separated list of Role ID numbers.
The default role ID values are as below
To get the Role ID number for any custom Roles, navigate to the Role edit screen. |
User Management → Roles Then select the Edit Button ( |
role. |
|
| Optional |
The Ping One application has now been configured.
...
You will see the correct details be auto-populated into the URL and Authenticating Authority fields.
...
When using SSO, by default all users will be granted the role of User.
This will allow them to view the Booking Manager page only, to . To allow users access to more features in ResourceXpress they will need to exist as a user in the ResourceXpress local database.
Ticking the option Auto create user records from SSO will automatically add new users into the ResourceXpress user database when they sign - in for the first time , this This will then allow these users to be granted more access to the system, as well as assigning assign them an RFID and Access code values.
...
Welcome Email
When a user's account is auto-created in ResourceXpress, an email confirming this will a Welcome email can be sent to them to confirm their account. Included in this email will be a randomly generated password that can be used for the upcoming mobile app.
To enable the Welcome Email, tick the Send Welcome Email box.
...
Sync user details
| Info |
|---|
This option was added in v1.5.1 |
...
Disabling this option will allow for Admin users to modify these details manually in ResourceXpress.
...