How-to guide
Keep SCIM provisioning healthy
Find and retry failed provisioning changes, resume after the application refuses the token, clean up accounts Sovrain does not manage, and pause or remove provisioning.
This guide keeps provisioning to an application working after you have set it up: it finds changes that did not reach the application, gets provisioning going again after the application refuses the token, and deals with accounts in the application that Sovrain does not manage. Setting provisioning up is in Provision accounts with SCIM.
Everything here starts on the application’s Activity tab: on your home page, under Administration, select Open admin, then Applications, and open the application. For a SAML app, select Provisioning in the SSO / Provisioning switch first.
Find failed changes and send them again
- Under Recent activity, select the Failing filter.
- Select Details on a job to see the request Sovrain sent and what the application answered.
- Fix the cause, for example a mapping the application does not accept, then select Retry now on the job, or Retry all failing for every failed job.
Sovrain retries failed jobs on its own, with pauses that grow up to a day. A job the application refused as invalid shows not retrying and waits until you retry it. The pauses are listed in SCIM › Retries.
If the application refuses the token
When the application answers that the token is not valid (HTTP 401 or 403), Sovrain pauses provisioning and the Activity tab shows Provisioning paused. The jobs stay queued.
- Get a new token from the application.
- On the Connection tab, paste it into Bearer token.
- Select Test connection. When it passes, the queued jobs run.
If an account in the application is out of date
Select Reconcile now. Sovrain compares every account in the application with Sovrain and repairs the differences, for example an account someone deactivated by hand in the application. It also does this every 6 hours on its own. Reconciliation never removes anything from the application.
To see what the application knows about one person, go to Tools, pick them under Look up a user and select Check.
If accounts exist in the application that Sovrain does not manage
Sovrain reports them on the Activity tab as Drift: users and groups that exist in the application but are not managed by Sovrain. Select Details to list them.
- To remove one of them, select Remove on its row and confirm.
- Force sync… removes all of them at once.
Warning: Force sync… deactivates or deletes every drifted account in the application, following your Deprovisioning behavior, and deletes every group there that Sovrain does not track. Accounts created by hand in the application are among them. Look through Details before you confirm.
Both wait the same 3 minutes before they are sent, so you can still cancel them on the Activity tab.
If you want to stop provisioning
- To pause it, turn off Enable SCIM provisioning for this application on the Connection tab. Sovrain then sends nothing; accounts in the application stay as they are and sign-in keeps working.
- To remove it from a SAML app, untick SCIM provisioning for this app on the App identity tab and confirm. This deletes the provisioning settings. Accounts already in the application are left as they are.
Disabling the application also stops provisioning, without removing any account.
Related
- Application settings › Activity for every control on the tab.
- SCIM for the schedule, retries and reconciliation.
- About provisioning, for why reconciliation never deletes.