Tutorial: Deactivating Okta users in Oomnitza

In this tutorial, we will create a webhook in Oomnitza to deactivate users in Oomnitza when deactivate events occur in Okta. 

Important
The process for creating event hooks in vendor applications might change. Always consult your vendor application documentation to keep up-to-date with changes.

Creating the webhook in Oomnitza

1.  Click Configuration.
2. From the Integrations menu, click Webhooks.
3. Click Add webhook .
4. Select the Okta User Deactivated Webhook.
5. On the Configuration Details page, complete the following steps:
6. Enter a unique name for the webhook.
7. Enter an authentication secret. You must copy the secret because you will need it when you create the event hook.
8. Select the update user Oomnitza event .
9. In this case, you modify the body to change the status of user records to Inactive.
10. Click NEXT.
11. By default a sync key has already been added. You can add two or more sync keys to ensure that records aren't skipped if a sync key doesn't contain a value. 
12. Click SAVE.

Result

When the webhook is saved, you are provided with the Webhook URL. Don't forget to copy it. You will need it when you create the event hook in the vendor application.

Creating the event hook in Okta

1. Log into Okta.

2. Go to Admin console > Workflow > Event hooks > Create Event hook.

3. Complete the following steps:

   1. Enter the name of the event hook.

   2. Enter the URL of the Oomnitza webhook. 

   3. In the Authentication field, enter Authorization.

   4. In the Authentication secret field, enter the secret that you entered when you created the Oomnitza webhook.

   5. In the Subscribe to events field, enter User deactivated. The event name must correspond to the Oomnitza preset.

4. Save your changes and verify the endpoint.

Result

When a user is deactivated in Okta, the user will be deactivated in Oomnitza and if a workflow has been configured to run for deactivated users, it will be triggered.