Overview

ARC Facilities supports Single Sign-On (SSO), a process that allows users to authenticate themselves against an external Identity Provider (IDP) rather than using the internal ARC Facilities username and password.

 

The benefit of this workflow is that companies only need manage a single user database. Connected applications provide users access based on this single database, which means that when an employee joins or departs the company, their access is automatically enabled/disabled for all connected systems.

 

To accomplish this, ARC Facilities - a Service Provider (SP), communicates using an industry standard protocol, (SAML 2.0 - Secure Assertion Markup Language) with an Identity Provider (IDP) to validate user credentials and provide access to ARC Facilities. 


The basic workflow is as follows:

  • A user opens ARC Facilities application through web browser
  • Upon reaching the login screen user navigates to Login through SSO screen where user enters email ID
  • ARC Facilities detects that the account is setup for SSO and redirects the user to the IDP. 
  • The user enters their credentials with the IDP.
  • The IDP validates the user, then redirects the user back to ARC Facilities, providing the user’s information and groups to ARC Facilities
  • ARC Facilities, using the information provided by the IDP, logs the user into their account and sets permissions as defined for the user’s group

 

Configuration

Both ARC Facilities and the Identity Provider need to be properly configured for Single Sign-On.


Steps to Configure the Identity Provider (IDP)

To configure the Identity Provider for use with ARC Facilities, you will need to enter some information into the IDP and extract some information for ARC Facilities.


  1. Note the Sign-In URL that is provided by the IDP
  2. Note the Sign-Out URL that is provided by the IDP 
  3. Download a copy of the X.509 Certificate from the IDP
  4. Enter the following URL into the IDP field called SAML Post URL
    https://app.arcfacilities.co/Account/LoginViaSSO
  5. Provide the assertion attributes (Case sensitive) in the IDP
    • Firstname: FirstName
    • Lastname: LastName
    • Email : Email
    • Group: group_name
      Note: These mappings are case sensitive and must be entered exactly.
      Please send a SAML response to us so that we can verify the attributes mapping.
      SAML response must be Base64 encoded
  6. Download the IDP Metadata file and send this to us, along with the SAML response above.


Steps to Configure ARC Facilities (By Admin user)

The admin user will first have to create a new normal account in ARC Facilities then sign in to ARC Facilities as a normal user. After signing in the admin user will proceed to create the SSO user group & enable as well as configure the SSO settings.


Enabling SSO in ARC Facilities

  1. Sign in to ARC Facilities using the administrator account
  2. Navigate to Settings > Account Settings 
  3. Click Single Sign On (SSO) tab
  1. Upload the IDP Metadata to ARC Facilities
  2. Verify / select the attribute mappings in ARC Facilities
  3. Enter the Identity Provider sign in URL
  4. Enter the Identity Provider sign out URL
  5. Upload a copy of the X.509 security certificate
  6. Save your settings


Setting up Groups

ARC Facilities access is enabled through Groups creation

Group names are CASE SENSITIVE and must EXACTLY match the groups used in the Identity Provider (IdP).


To setup Groups in ARC Facilities, add them one at a time, using the provided field.


Once created, Groups will display in the Contacts listing for ARC Facilities.


Permissions in ARC Facilities

For ARC Facilities, permissions are assigned based on Account Teams. As with Groups above, an Account Team must exist that exactly matches the Groups provided by the Identity Provider. 


Note: When creating groups using the tool above, an Account Team is automatically created in ARC Facilities.


You can then add Account Teams to campuses during campus creation. 

If campus already exist, you may associate them to the appropriate campuses using the Account Teams settings menu.


Signing in to ARC Facilities through SSO login (by employee user)

An employee user of the client company can access ARC Facilities either through the SSO login screen after the admin user performs all the configurations necessary to implement SSO login through ARC Facilities.

When an employee user accesses ARC Facilities for the first time the following workflow will occur:

  1. Go to ARC Facilities sign in screen

  1. Click on “Sign in with SSO” link
  1. Provide the email ID and click [Next].

        User is redirected to the IDP provider’s login screen (example of 'Okta' is shown in the screenshot below),

            4. Enter username and password and click [Sign in]


After authentication, the IDP returns the SP URL (ARC Facilities URL) which is already configured with the IDP. ARC Facilities validates the response and accordingly creates the user account (if it does not exist) and navigates the user inside the ARC Facilities Home screen as shown below,