Guides

This second suite of Runscope tests checks that your SCIM app can handle actual requests to Create, Read, Update and Delete (CRUD) user profile information.

Note: Okta doesn't delete user profiles, but instead marks them as active=false to deactivate them.

If you are not familiar with Runscope, follow the detailed instructions in the test your SCIM API topic to get started.

This suite runs the following tests:

  1. Checks that the app exists in your Okta org.
  2. Adds a new random user in Okta.
  3. Assigns that user to the app in Okta.
  4. Verifies that the user was created on your SCIM server.
  5. Updates the user firstName attribute in Okta.
  6. Verifies that the user attribute was updated on your SCIM server.
  7. Deactivates the user in Okta.
  8. Verifies that the user was deactivated on your SCIM server.
  9. Reactivates the user in Okta.
  10. Reassigns your app to the user in Okta.
  11. Verifies the user was reactivated and assigned on your SCIM server.
  12. Removes your app from the user in Okta.
  13. Verifies that user is deactivated on your SCIM server.

To configure and run the SCIM CRUD tests:

  1. Download the Okta SCIM CRUD test file.

  2. In Runscope, click Import Test.

  3. Select Runscope API Tests as the import format.

  4. Click Choose File and select the Okta SCIM 2.0 CRUD JSON test file.

  5. Click Import API Test.

  6. In this new test bucket, click Editor from the left hand navigation menu.

  7. Click Test Settings and then click Initial Variables.

  8. Add the following variables with values that match your SCIM app:

    • oktaAppId - the unique identifier randomly assigned to your Okta app. You can see this value in the App Embed Link panel under the General tab for your Okta app.
    • oktaOrgUrl - the base URL for your Okta org. Include the https:// prefix. Dev Window
    • oktaToken - the security token used to connect to your Okta app API. You can generate a token for your app inside your Okta org:
      • Click Security > API.
      • Click on Tokens and Create Token.
      • Give the token a name click Create Token.
      • Copy the resulting token value over to this Runscope variable.
    • SCIMUrl - the Base URL of the SCIM implementation on your server. For example: https://example.com/scim/v2
    • SCIMAuth - the Basic or OAuth authorization token used to access your SCIM API.

    The final Runscope values should look similar to the following: Runscope Initial Variables

  9. Click Test Settings and then click Initial Script.

  10. Copy the contents of the Okta CRUD Initial Script text file and paste into this Runscope console.

  11. Click Save & Run.

On the left side of your screen, the test appears in the Recent Test Runs section.

  1. Click View Progress inside the Recent Test Runs section.
  2. As the test suite runs, Runscope displays live updates of the test in progress. After the test is complete, the main panel displays the results of your test.
  3. To see the details of tests, click the name of each particular test case to expand the section. The details show you the Request, Response, and Connection information for each test.

After the tests complete successfully, you can move on to creating the configuration guide for your customers to use your app once it is available on the OIN.

For comparison and reference, here is an example of a successful Runscope test run for the SCIM 2.0 CRUD test suite.

Next:

Featured Guides