.png?sv=2019-07-07&sig=FQvBsKHeMLV6gzGPvCAavBoI3TnXedqarsw6mCG9cR4%3D&spr=https%2Chttp&st=2023-03-25T11%3A19%3A13Z&se=2023-03-25T11%3A29%3A13Z&srt=o&ss=b&sp=r){kind=logo}
Shodan - Enrich Asset Data
- 16 Mar 2023
- 2 Minutes to read
-
Print
-
DarkLight
-
PDF
Shodan - Enrich Asset Data
- Updated on 16 Mar 2023
- 2 Minutes to read
-
Print
-
DarkLight
-
PDF
Shodan - Enrich Asset Data (Enrich Device Data with Shodan) enriches each of the assets that are the results of the query with additional data from Shodan, such as: hostname, ports open to the world, vulnerabilities, address information (country, region, city), ISP and more.
The data enrichment is done per device based on its public IP address (IPv4).
NOTE
You can use the IPv4 Public Subnets devices saved query as the trigger for the enforcement set that executes the Shodan - Enrich Asset Data action.
For more details, see Configuring Triggers.
For more details, see Configuring Triggers.
See Creating Enforcement Sets to learn more about adding Enforcement Actions to Enforcement Sets.
General Settings
- Enforcement Set name (required) - The name of the Enforcement Set. A default value is added by Axonious. You can change the name according to your needs.
- Add description (optional) - Click to add a description of the Enforcement Set. It is recommended to describe what the Enforcement Set does.
- Run action on assets matching following query (required) - Select an asset category and a query. The Enforcement Action will be run on the assets that match the query parameters.
- A query only returns results for the asset type it was created for.
- Not all asset categories are supported for all Enforcement Actions.
- See Actions supported for Activity Logs and Adapter Fetch History Modules
- Action name - The name of the Main action. A default value is added by Axonious. You can change the name according to your needs.
- Configure Action Conditions - Toggle on to enter a condition statement. See Configuring Enforcement Action Conditions to learn more about condition statement syntax.
To configure this action, do as follows:
- Define a unique action name.
- The Shodan default domain is api.shodan.io. You can change it, if required.
- Specify the API key you have defined.
To generate a Shodan API key, do as follows:- Register for an account in shodan.
- Visit your registered email id and activate the account.
- Login to your account and you will find the API keys under profile overview tab.
- Copy the API key and this is the value for shodan_api field in the config.py file.
- You can configure a proxy specifically to the domain instead of direct approaching it.
- If you are using multi-nodes, choose the Axonius node to use to interact with the adapter when executing the enforcement action.
- Save the action.
For more details about other Enforcement Actions available, see Action Library.