Cherwell - Update Assets
  • 19 Sep 2024
  • 3 Minutes to read
  • Dark
    Light
  • PDF

Cherwell - Update Assets

  • Dark
    Light
  • PDF

Article summary

Cherwell - Update Assets updates those device details in Cherwell for:

  • Assets that match the results of the selected saved query, and match the Enforcement Action Conditions, if defined, or assets selected on the relevant asset page.

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 Axonius. You can change the name according to your needs.
  • Add description - 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.
  • Action name (required) - The name of the Main action. A default value is added by Axonius. You can change the name according to your needs.
  • Configure Dynamic Values - Toggle on to enter a Dynamic Value statement. See Creating Enforcement Action Dynamic Value Statements to learn more about Dynamic Value statement syntax.

  • Use stored credentials from Cherwell IT Service Management adapter - Select this option to use the first connected Cherwell IT Service Management adapter credentials.
    NOTE
    • To use this option, you must successfully configure a Cherwell IT Service Management adapter connection.
    • The user name and the password used for the adapter connection must be a user with permissions to create new incidents.

Required Fields

These fields must be configured to run the Enforcement Set.

Additional Fields

These fields are optional.

Connection and Credentials

When Use stored credentials from the adapter is toggled off, these fields need to be configured:

  • Cherwell domain - The hostname or IP address of the Cherwell server.
  • User name and Password - The user name and the password of a user account that has permissions to read and to modify devices.
  • Client ID - Enter the client ID created in the CSM Administrator. For details, see Cherwell - Obtaining API Client IDs.
  • Verify SSL (optional) - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.
  • HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.
  • Sleep 1 second every token request - Select this option to wait before sending authentication tokens.
  • Additional fields - Specify additional fields to be added as key/value pairs in a JSON format.
    For example:

    {"field1": "value1", "field2": "value2"}
    

    If one of the specified fields is invalid, the request might fail.

    • Do not map default Axonius fields - When selected, the set of default Axonius fields are mapped to the Cherwell asset. For details, see Default Field Mapping.
  • Do not overwrite existing field data - Select to prevent updating Cherwell fields that have not changed.
  • Map Axonius fields to adapter fields - Use the Field Mapping Wizard to map Axonius fields to fields in external systems. In this way you can transfer data found in Axonius into the external system as part of the configuration of relevant enforcement actions. The wizard shows you which fields exist on the Axonius system, allowing you to map them easily.

    Note:
  • Use first IP address only - When selected, adds the first IP address to the Cherwell asset.
  • IP addresses delimiter (default: /) - Specify the delimiter to separate between multiple IP addresses added to the Cherwell asset.
  • Use first MAC address only - When selected, adds the first MAC address to the Cherwell asset. Otherwise, all the device's MAC addresses will be added to the Cherwell asset.
  • MAC addresses delimiter (default: /) - Specify the delimiter to separate between multiple MAC addresses added to the Cherwell asset.
  • CIDR exclude list - Specify a comma-separated list of CIDRs to be excluded.
  • CIDR include list - Specify a comma-separated list of CIDRs to be included.
  • Number of parallel requests (default 10) - Specify the number of machines that can be created in parallel.
  • Exclude connections - Assets from the selected connections will not be included in the query results. You can select more than one.

Required Permissions

The account used to access Cherwell must have permission to update assets.


For more details about other Enforcement Actions available, see Action Library.


Was this article helpful?