The best way to develop and verify your SCIM integration is to use an automated test suite that runs on the BlazeMeter Runscope API monitoring tool.
If you do not have a Runscope account, you can sign up with a free trial to Runscope for Okta developers.
If you are developing your SCIM integration in a local environment and need to expose it to Runscope for testing, we suggest using the ngrok tool so you can route external address requests to your local web server.
To get started using Runscope to test your SCIM API:
Download the Okta SCIM Spec Test file that corresponds to the version of SCIM you set up on your server. You will use this file to import the Okta SCIM test suite into Runscope.
If you are new to Runscope, your dashboard displays sample Runscope tutorials. Click Skip Tutorial.
You should now see a screen titled API Tests.
In the lower left of your screen, click Import Test.
A new screen appears, titled Import Tests into …
Select Runscope API Tests as the import format.
Click Choose File and select the JSON file that you saved in Step 1.
Click Import API Test.
After the import is finished, click All Tests on the left hand side of your screen.
Now that you've imported the Okta SCIM test suite into Runscope, your next step is to customize the test suite to target your SCIM implementation.
As you are developing your SCIM implementation, you can share API test results with your teammates or with people outside of your organization:
https://www.runscope.com/radar/abcdefghijkl/m01nopq2-3456-7r8s-9012-t34567uvw890/history/123ef4gh-i567-89j0-1k2l-3m4n5o678901The test results can be viewed in detail, but the test can't be edited or be re-run by people outside of your team.
After importing the Okta SCIM test suite into Runscope, you need to configure the test for your SCIM integration:
You should be looking at the API Tests screen in Runscope, if not, click the Tests tab at the top of the Runscope user interface.
You should see a test named Okta SCIM X.X Spec Test (where X.X corresponds to the SCIM version of the JSON file you uploaded).
Click Edit on the test panel.
The Okta SCIM X.X SPEC Test screen appears. Under the Environment section of your test, there is a collapsed section labelled Test Settings . Click the small arrow to expand this section.
Select the Initial Variables tab.
Click Add Initial Variable and add the following case-sensitive variables:
|Variable Name||Example Values||Notes|
|SCIMBaseURL|| ||For example, if your SCIM integration is hosted on https://example.com and uses a prefix of /scim/v2 then the SCIMBaseURL value for your integration would be: |
|auth||Bearer abcxyz1234567890||Basic or OAuth authorization token|
Select the Initial Script tab. Copy the contents of this Initial Script Spec text file to your clipboard and then paste it into the script console on this tab. A
Script ON label appears on your Test Settings page to indicate that the script is accepted and will be run before the first request in the test.
Now that you have updated your SCIM test in Runscope with the details of your SCIM server, you can run the test: