Totara Learn Open Discussions

SCIM support

 
Lloyd Wilson
SCIM support
by Lloyd Wilson - Wednesday, 1 December 2021, 7:38 PM
 

Are there any plans in Totara's roadmap to build a SCIM integration for the provisioning of user information from Okta?

https://developer.okta.com/docs/concepts/scim/

Craig Eves
Re: SCIM support
by Craig Eves (Totara Support) - Monday, 6 December 2021, 6:44 PM
Group Totara

Hi Lloyd

Not sure how SCIM fits into the picture but you can use the existing OAuth2 authentication plugin for Okta accounts

In the [Okta documentation|https://developer.okta.com/docs/reference/api/oidc/], the authorisation endpoint is listed as being 'https://${yourOktaDomain}/oauth2'. All you should need to do is correct the endpoints to point to the Otka domain.

We are in the process of writing some more documentation to help with this and I have shared our unpublished documentation below.

After a service has been set up you can edit it via the 'Edit' column from 'Server > OAuth 2 services' via the Administration menu. 

  • Edit allows you to adjust the settings
  • Configure endpoints allows you to edit, delete, or add endpoint URLs.

The issuer's endpoints are the URLs which Totara connects to. There are three endpoints required for user authentication: authorization_endpoint, token_endpoint and userinfo_endpoint.

For Google, Microsoft, Facebook, Nextcloud services you will not need to configure these endpoints, as these will be URLs for the OAuth provider. For example, an endpoint for Google would be https://accounts.google.com/o/oauth2/v2/auth. For custom services, you will need to add the endpoints.

When configuring the endpoints for a service you can add more endpoints by clicking 'Create new endpoint' for issuer "IssuerName", then add the endpoint name and URL.

  • Configure user field mappings allows you to edit, delete, or create mappings between user data fields on the issue site and your Totara site to ensure the correct information is brought across
  • Delete allows you to remove that service
  • Disable or Enable - disabling a service means that it can no longer be used but all of the configuration information is kept in the system for future use.

I hope that helps and do let us know how you get on. :)


Lloyd Wilson
Re: SCIM support
by Lloyd Wilson - Monday, 6 December 2021, 8:39 PM
 

Thanks for that, Craig.

Authentication is all fine, the issue has been that for provisioning, Totara does not seem to support the SCIM standard and SOAP or REST must be used. For us, that means using an intermediary service like Snaplogic to present the data as something acceptable to Totara. While this works for the most part, there is a lot that can go wrong with such a complicated workflow.

I will pass on your comments to our developers to see if it sheds any light on improvements that could be made.