Overview
This article will walk you through how to set up Okta with Limble, which will allow your team to use Okta to create SSO for your users.
Table of Contents
Requirements
An Enterprise account with Limble CMMS
An Okta account set up with provisioning.
Okta groups configured with users for Limble CMMS
Completed the Okta OIDC Setup Guide
Supported Features
Save time and automate error-prone tasks by setting up provisioning in Okta and Limble. Once completed, you can:
Create users
Create groups
Update user attributes
Update group attributes
Update group members
Deactivate users
Import users
Import groups
Procedure
Go to Settings > Manage SSO.
Select your SSO Provider. In this case, we'll select "Okta."
Click “Generate SCIM Token,” and copy the token that appears into your clipboard. This is the Okta API Token.
Set Up the Okta Application to Send User Data to Limble
Here, you are defining Okta’s ability to add, edit, and remove users from Limble.
Log into your Okta account. Within "LimbleCMMS," select “Provisioning.”
Select "Integration."
Press the “Edit” button
Enable API Integration
Add the Base URL:
a) 21 CFR customers: https://21cfr-scim.limblecmms.com/scim/v2
b) Canada servers: https://ca-scim.limblecmms.com/scim/v2
c) All other customers: https://us-scim.limblecmms.com/scim/v2Paste in the API Token you copied from Limble.
Click on “Test API Credentials”
a) If it doesn’t work, double-check your URL and Token.
b) If that doesn’t work please contact Limble Support.Press “Save.”
Enable Permissions in Okta to Manage Limble Users
Here you are defining Okta’s ability to add, edit, and remove users from Limble.
Select “To App”
Click “Edit”
Enable “Create Users,” “Update User Attributes,” and “Deactivate Users.”
Click “Save.”
Push Okta Groups to Limble
Find your Okta groups - by name, for example - save them, and then push them to Limble. To do this, select "Push Groups," select your group, and then click "Save."
Edit your users and groups as desired.
Assign Groups to Limble
In the Assignments tab, click “Assign" and select "Groups" from the dropdown.
Then, click “Assign” next to LimbleCMMS.
Configure Okta Groups in Limble
After the groups have been assigned and pushed, when you refresh your Limble web app, the groups and users attached to them should appear.
You can then click the “+” button and add roles and associated locations to each of the Okta groups.
These roles will then be applied to each of the group’s users.
(Note: the roles will only be editable from the Manage SSO page.)
Known Issues / Troubleshooting
Provisioned users need to be attached to at least one Okta group that is pushed to Limble. This is how initial SSO user permissions are assigned in Limble.
If you don’t see users on the Manage Users page, verify SSO users are members of an Okta-provisioned group assigned to Limble.
We suggest naming Okta groups according to their roles and locations.
Related Articles
Still don’t see what you’re looking for? Check out our YouTube channel for more tips and tricks! You can also reach out to us anytime at support@limblecmms.com.