Articles in this section

Configuring SCIM with Okta

Avatar
Courtney J
  • Updated
Follow

This guide provides the steps required to configure provisioning for 15Five, and includes the following sections:

  • Features
  • Prerequisites
  • Configuration Steps
  • Troubleshooting Tips

Features

Automatic User Provisioning is supported for the 15Five application.

This enables Okta to:

  • Add new users to 15Five
  • Update select fields in users’ profile information in 15Five
  • Deactivate users in 15Five
  • Push groups and membership to 15Five

The following provisioning features are supported:

  • Push New Users - Creating a new user in Okta and assigning them to the 15Five application will create a new user in 15Five.
  • Push Profile Updates - Updates to a user in Okta will be pushed to 15Five.
  • Push User Deactivation - Deactivating the user or disabling the user's access to 15Five within OKTA will deactivate the user in 15Five.
  • Import New Users - Users created in 15Five can be pulled into Okta and turned into new AppUser objects for matching against existing Okta users.
  • Push Groups - Groups created in Okta can be pushed to 15Five. Attributes pushed include name and group members.
  • Pull Groups - Groups created in 15Five can be pulled into Okta for reference within Okta.
  • Delete Groups - Groups deleted or removed from the 15Five application within Okta will be deleted within 15Five.

Prerequisites

Before you configure provisioning for 15Five: 

  1. Make sure you have configured the General Settings and any Sign-On Options for the 15Five app.
  2. Enable SCIM in your 15Five account and generate an Access Token.

Configuration Steps

Configure your App Settings:

  • Enter an Application label (15Five or 15Five SCIM is encouraged).
  • Enter your subdomain. For example, if you log into 15Five via https://acme.15five.com, enter “acme” for the subdomain.

Configure your Sign On methods settings:

For SAML 2.0 enabled 15Five customers, simply select the SAML 2.0 radio button option under Sign On Methods. No relay state is required.

For all other 15Five customers, select Secure Web Authentication and then Administrator sets username, the user sets the password. 

Configure your Provisioning settings for 15Five as follows:

  • Check the Enable provisioning features box.
  • API Credentials:
  • OAuth Bearer Token: Place the Access Token from 15Five here. 
  • Click the Test API Credentials button and check that your credentials were verified successfully.
  • NOTE: The *Public API* key is 32 characters long. The *SCIM* key is 30 characters long.

Scroll down and select the Provisioning Features you want to enable.

  • Under User Import, ensure that the following are set:
  • Schedule Import: never
  • Okta username format: Email Address

  • Ensure that Profile Master is NOT enabled.
  • Ensure Create Users is enabled. 
  • Ensure Update User Attributes is enabled. 
  • Ensure Deactivate Users is enabled. 
  • Read through the section entitled Syncing Passwords in this guide to decide if you would like to have Okta sync passwords with 15Five.

You can now assign people to the app (if needed) and finish the application setup.

 

Syncing Passwords

Okta can be configured to sync passwords with 15Five. This sync direction is from Okta to 15Five. That is, passwords are only ever sent from Okta to 15Five for a user; never from 15Five to Okta.

If Sync Password is enabled, the password sent from Okta to 15Five must be randomly generated. For added security, check the Generate a new random password whenever the user's Okta password changes checkbox next to Password Cycle.

If your company uses SSO with 15Five, do not enable Sync Password. User authentication will be determined from the SAML setup associated with 15Five.

Emails

When giving 15Five access to an Okta user for the first time, a new user in 15Five will be created. If SSO is enabled for that user’s company in 15Five, that user will be sent a welcome email with a link to the SSO page at 15Five. If SSO is not enabled, that user will be sent a link to sign in and set their password.

When updating an Okta user’s password, that user’s 15Five password may be updated (depending on whether “Generate a new random password whenever the user’s Okta password changes” was checked or not). If SSO is enabled for the user’s company in 15Five, no password changes will occur for the user within 15Five. If SSO is not enabled in 15Five and Sync Password is enabled in Okta, then a user will receive an email with a link to reset their password in 15Five.

 

Troubleshooting + Support


Manager/Reviewer not syncing? 

Make sure that the manager exists within 15Five prior to provisioning. 15Five will ignore any manager assignments that include managers not present in 15Five. 

Okta sends the manager information present in the managerId field for a given user. The information in the field can be an email address for the manager or a 15Five ID for the user. Make sure this field is populated.

Finally, ensure that Sync Managers is enabled within 15Five's SCIM settings:
https://my.15five.com/scim/settings/


Changing a username?

15Five depends on the uniqueness of a user’s email address. Therefore, provisioning will fail if a user’s userName is updated but their email address is not. Ensure these two values (userName and email) are the same and retry the provision if has failed. 

Updates or de-provisioning not working for some users? 

This issue often occurs when a user was added to 15Five manually or prior to SCIM being enabled. Please see the "Users added to 15Five manually?" below.

Getting an "Email address already in use?" error when creating a user?

This error often occurs when a user was added to 15Five manually or prior to SCIM being enabled. Please see the "Users added to 15Five manually?" below.

Users added to 15Five manually? 

Users added to 15Five manually or before SCIM was enabled for the 15Five account may not be tracked by Okta. To make Okta aware of these users' membership in 15Five, perform an "Import" within Okta. Under the 15Five app in Okta, find the "Import" tab, and click "Import Now".

A list of 15Five users and possible associations with Okta users will be populated below. Click "Confirm Assignments" and these users will now be tracked, updated, and de-provisioned by Okta. Please make sure all of the users you would like to import from 15Five are active as inactive users will not be imported by Okta. 

Still seeing this error?

"Automatic provisioning of user to app failed: Error while reactivating user: Not Found. Errors reported by remote server: Resource None not found"

If a user has not been synced with Okta prior to their deactivation within 15Five, Okta will not know about them and will not be able to take action on them. 

Please re-activate (within 15Five) the user you would like to sync with Okta, and then perform an import within Okta as described in the "Users added to 15Five manually? " section above. 

Groups

Please note that these are the only Group attributes that are updatable via the Okta integration:

  • Group Name
  • Group Members

Groups created in 15Five and imported into Okta cannot be deleted or changed in Okta. They must be managed in 15Five. Since groups imported from 15Five into Okta are not editable within Okta, it is suggested to create groups in Okta first and then push those groups to 15Five via the "Push Groups" button in Okta.

If you have groups already in 15Five and want to associate those groups with groups in Okta, take the following steps:

  1. Create a group with the same name in Okta. For example, if a "Leadership" group exists in 15Five, create a "Leadership" group in Okta.
  2. Add members to the group in Okta.
  3. Push the group to 15Five.

If a group in Okta has the same name as an existing group in 15Five, pushing the group from Okta to 15Five will not create a new group. Instead, the group from Okta will overwrite the membership of the group in 15Five.

Older Groups

If you added an instance of 15Five before August 27, 2018, you must re-authenticate with 15Five to take advantage of this update. Please follow the steps below to re-authenticate:

  1. Go to the Provisioning tab of your 15Five application within Okta.
  2. Go to the API Integration menu.
  3. Click Edit and then click the Test API Credentials button. Check that your credentials were verified successfully.
  4. Done! You can now use the Group Push functionality of 15Five.

Have questions that need a human touch? 

This integration is built and supported by 15Five and our Support Team. Contact the 15Five Support Team at support@15five.com if any issues arise. Thanks!

Related articles

Comments

0 comments

Please sign in to leave a comment.