Creating workflows for Shodan users

Let Oomnitza be your single source of truth!

You'll get visibility of your users as data from Shodan is automatically transformed into consumable information and actionable insights.

Connect Oomnitza and Shodan in minutes

You'll get visibility of your Shodan users by creating configurable workflows to automate onboarding and offboarding users.

Contents

1. Before you start
2. Creating workflows
3. Create user workflows

Before you start

Before you can create the integration with Oomnitza, you need to have added your Shodan credentials to Oomnitza.

We recommend that you also create an extended integration for Shodan users. You can use the information retrieved in these integrations to trigger workflows.

Note
These workflows use the Shodan Organization API which requires an Enterprise Data License. See Shodan Enterprise.

Creating workflows

Create user workflows

To create a user workflow, you must complete these steps:  

1. Click Configuration > Workflows 
2. Click Add (+) and select People from the list.
3. Edit the Begin Block and add rules to trigger the workflow. For example, if you set the Actions to Schedule and add a rule so that the Email Equals <EmployeeEmail> you can trigger a workflow to fetch a user matching a certain name on a specific date. Refer to Using the Begin block. 
4. Drag and drop the API block onto the Sandbox.
5. Click Edit on the API block and enter Shodan in the search field. 
6. Select a preset from the list below. To choose a preset, click the forward arrow (>).
   
   • Shodan Add New Member to Organization
   • Shodan Remove Member from Organization
7. Select the credentials that you created in Adding your Shodan credentials to Oomnitza.
8. Enter a Username or Email when prompted. You can refer to existing Oomnitza fields by entering the field name in curly braces. For example: {{username}}. 
9. Select Advanced Mode.
10. Select the Response tab. Map the response by placing {{response}} in the Response field and mapping it to a custom long text Oomnitza field, such as API Response. You should receive a {"success": true} response when running these workflows.
11. Connect the Blocks. 
12. Save, validate, and activate your workflow.

Using the Shodan Add New Member to Organization preset

The Shodan Add New Member to Organization preset adds a new member to the organization.

Select the Send email notification checkbox to send an email notification to the new member.

For further information, see Shodan Docs: PUT /org/member/{user}

Using the Shodan Remove Member from Organization preset

The Shodan Remove Member from Organization preset removes a member from the organization.

For further information, see Shodan Docs: DELETE /org/member/{user}

Reference articles for workflows

• Mapping positive and negative responses
• Troubleshooting workflows 
• Using the API block