Strobes provides support to onboard multiple assets at once using the 'Import Assets from CSV' connector. There is a format in which Strobes expects your data to be. The following explains the usage of certain essential options that are needed to import an assets CSV file.
Table 1. Asset types and corresponding values
Asset Type | Value |
Web | 1 |
Mobile | 2 |
Network | 3 |
Cloud | 4 |
Table 2. Cloud types and corresponding values
Cloud Type | Value |
Others | 1 |
AWS | 2 |
Azure | 3 |
Table 3. Business Sensitivity and corresponding values
Sensitivity | Value |
None | 0 |
Low | 1 |
Medium | 2 |
High | 3 |
Critical | 4 |
Table 4. Asset Exposure and corresponding values
Asset Exposure | Value |
Public | 1 |
Private | 2 |
The following are the fields that are expected to be filled in the CSV file:
- name: Name of the asset which you want to create.
- type: The type of the asset which you want to create. Refer to table 1 for the values that can be passed in this field.
- exposed: The exposure of the asset, meaning if the asset which you want to create is public or private. Refer to table 4 for the values that can be passed in this field.
- sensitivity: The business sensitivity of the asset, meaning how sensitive is the asset for the business. Refer to table 4 for the values that can be passed in this field.
- url: The URL of the asset which you want to create. This is applicable only for web assets
- package: The package name of the mobile asset which you want to create. This is applicable only for mobile assets
- ipaddress: The IP Address of the asset which you want to create. You can either pass a single ip address, multiple ip addresses seperated by commas, a range of ips or a subnet. For example 192.168.1.55, (192.168.1.55, 192.168.1.56, 192.168.1.57), 192.160.0.91-192.168.0.100 or 192.168.0.1/24. This is applicable only for network assets and you can not provide more than 50k ips at once.
- mac_address: The MAC address of the asset which you want to create. This is applicable only for network assets.
- hostname: The hostname of the asset which you want to create. This is applicable only for network assets.
- os: The Operating system of the asset which you want to create. This is applicable only for network assets.
- cloud_type: The cloud type of the asset which you want to create. This is applicable only for cloud assets.
- exclude_ip: The IP Address of the asset which you do not want to create. You can either pass a single ip address, multiple ip addresses seperated by commas or a range of ips. This will only work if you have already provided IPs in the 'ipaddress' field mentioned above. This is applicable only for network assets.
- tags_list: The tags that you want to add along with the asset which you want to create. This is applicable to all asset types.
- custom fields: Values also need to be passed to whatever custom fields which you have defined. More about custom fields here.
Adding Web Assets
The following are the fields for which data is expected to be provided for Web Assets
Mandatory Fields:
- name: Provide a name for your web asset
- type: Provide the value as 1
- exposed: If your web application is publicly exposed then provide the value as 1 otherwise provide 2
- sensitivity: Depending on the sensitivity the value will range from 0-4. Refer table 3 for this information
- url: Provide the URL of your web asset.
- mandatory custom fields: Provide the value for the mandatory custom fields
Optional Fields:
- tags_list: Provide the list of tags seperated by commas that need to be added for your web asset.
- optional custom fields: If you need to pass any values to the optional custom fields you can pass here.
All the other fields can be left empty for web assets.
Adding Mobile Assets
The following are the fields for which data is expected to be provided for Mobile Assets
Mandatory Fields:
- name: Provide a name for your mobile asset
- type: Provide the value as 2
- exposed: If your mobile application is publicly exposed then provide the value as 1 otherwise provide 2
- sensitivity: Depending on the sensitivity the value will range from 0-4. Refer table 3 for this information
- package: Provide the package name of your mobile asset.
- mandatory custom fields: Provide the value for the mandatory custom fields
Optional Fields:
- tags_list: Provide the list of tags seperated by commas that need to be added for your mobile asset.
- optional custom fields: If you need to pass any values to the optional custom fields you can pass here.
All the other fields can be left empty for mobile assets.
Adding Network Assets
The following are the fields for which data is expected to be provided for Network Assets
Mandatory Fields:
- type: Provide the value as 3
- exposed: If your network asset is publicly exposed then provide the value as 1 otherwise provide 2
- sensitivity: Depending on the sensitivity the value will range from 0-4. Refer table 3 for this information
- ipaddress: Provide the ipaddress or list/range of ip addresses.
- mandatory custom fields: Provide the value for the mandatory custom fields
Optional Fields:
- name: Provide the name for your network asset. This will only work when a single ip is added and when no hostname is provided. If a hostname is provided, then that is picked up over the value passed in this field.
- mac_address: Provide the mac address of your network asset
- hostname: Provide the hostname of your network asset
- os: Provide the operating system of your network asset
- exclude_ip: Provide the ip or the list of ips which you need to exclude
- tags_list: Provide the list of tags seperated by commas that need to be added for your network asset.
- optional custom fields: If you need to pass any values to the optional custom fields you can pass here.
All the other fields can be left empty for network assets.
Adding Cloud Assets
The following are the fields for which data is expected to be provided for Cloud Assets
Mandatory Fields:
- name: Provide a name for your cloud asset
- type: Provide the value as 4
- exposed: If your cloud asset is publicly exposed then provide the value as 1 otherwise provide 2
- sensitivity: Depending on the sensitivity the value will range from 0-4. Refer table 3 for this information
- cloud_type: Depending on the type of cloud for your asset, the value will range from 1-3. Refer table 2 for this information
- mandatory custom fields: Provide the value for the mandatory custom fields
Optional Fields:
- tags_list: Provide the list of tags seperated by commas that need to be added for your cloud asset.
- optional custom fields: If you need to pass any values to the optional custom fields you can pass here.
All the other fields can be left empty for cloud assets.
Instructions to Import Assets:
- Navigate to 'Connectors' and select 'Asset Inventory'.
- Select the 'Import Assets from CSV' connector.
- Click on 'Next'.
- Select the CSV file where you have filled in all the relevant data.
- If you need to merge the assets which you are about to upload with the assets which you have already added before, then Enable merging of asset.
- Click on 'Upload' and your assets will get added onto Strobes.
You can find examples of CSV files for different types of assets here and here.
Comments
Article is closed for comments.