Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

...

(blue star) 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.

...

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

  1. https://company.rx-cloud.com/SsoConsumer?r=%2fkiosk%2f%3fID%3d1

  2. https://company.rx-cloud.com/SsoConsumer?r=%2fkiosk%2f%3fID%3d2

  3. https://company.rx-cloud.com/SsoConsumer?r=%2fkiosk%2f%3fID%3d3

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

  1. https://company.rx-cloud.com/SsoConsumer?r=%2fMaps%2f%3fID%3d1

  2. https://company.rx-cloud.com/SsoConsumer?r=%2fMaps%2f%3fID%3d2

  3. https://company.rx-cloud.com/SsoConsumer?r=%2fMaps%2f%3fID%3d3

Mobile App

https://<RXurl>/SsoConsumer?r=%2f%3fma%3d1

https://company.rx-cloud.com/SsoConsumer?r=%2f%3fma%3d1

...

Table 1.1 - Attribute Mappings

PingOne User Attribute

Application Attribute

Required

or Optional

Given Name

firstname

Required

Family Name

lastname

Required

Email Address

email

Required

RFID

Info
this attribute must

Must be created and populated in PingOne

rfid

Optional

Access Code

Info
this attribute must

Must be created and populated in PingOne

accesscode

Optional

RX Default Location

Info
this attribute must

Must be created and populated in PingOne

defaultlocation

The ID number for the Location that the user will have default access to.

Info

This requires a single Location ID value.

To get the Location ID number, navigate to the location edit screen.

Administration Settings → System Settings → Locations

Then select the Edit Button ( (blue star) ) for the correct location.
You will find the ID number at the end of the page URL.
https://app.rx-cloud.com/Setting/Location?Id=1

Optional

RX Allowed Location

Info
this attribute must

Must be created and populated in PingOne

allowedlocation

A comma separated list of Location ID numbers that the user has access to.

Info

If more than 1 location is required, separate the ID values with a comma ( , ).

To get the location ID number, navigate to the location edit screen.

Administration Settings → System Settings → Locations

Then select the Edit Button ( (blue star) ) for the correct location.
You will find the ID number at the end of the page URL.
https://app.rx-cloud.com/Setting/Location?Id=1

Optional

Date Format

Info
this attribute must

Must be created and populated in PingOne

dateformat

The date format for the user.

dd,MM,yyyy → (25, 01, 2021)
MM / dd / yyyy → (01 / 25 / 2021)

Optional

RX Roles

Info
this attribute must

Must be created and populated in PingOne

roles

role

A comma separated list of Role ID numbers.

Info

If more than 1 role is required, separate the ID values with a comma ( , ).

The default role ID values are as below

Super Admin → 1
Server Admin → 2
User Admin → 3
User → 4
Messaging → 5
Reporting → 6
Location Admin → 7

To get the Role ID number for any custom Roles, navigate to the Role edit screen.

Administration Settings → System Settings → Locations

User Management → Roles

Then select the Edit Button ( (blue star) ) for the correct

location

role.
You will find the ID number at the end of the page URL.
https://app.rx-cloud.com/

Setting

Role/

Location

Create?Id=1

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.

...