- 02 Jun 2024
- 3 Minutes to read
- Print
- DarkLight
- PDF
ServiceNow - Request Catalog Item
- Updated on 02 Jun 2024
- 3 Minutes to read
- Print
- DarkLight
- PDF
The ServiceNow - Request Catalog Item action orders a service cart item from the service catalog.
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.
- 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, Adapters Fetch History, and Asset Investigation modules.
- See Actions supported for Vulnerabilities.
- See Actions supported for Software.
- 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 ServiceNow adapter - Select this option to use the ServiceNow connected adapter credentials.
- When you select this option, the Select Adapter Connection dropdown is available, and you can choose the adapter connection to use for this Enforcement Action.
Required Fields
These fields must be configured to run the Enforcement Set.
- SYS ID - The ID of the requested item.
Compute Node - The Axonius node to use when connecting to the specified host. For more details, see Connecting Additional Axonius Nodes.
Additional Fields
These fields are optional.
Connection Parameters
When Use stored credentials from ServiceNow adapter is toggled Off, these fields are required:
- ServiceNow Domain - The full URL of the ServiceNow server.
- User Name and Password - The credentials for a user account that has the Required Permissions to fetch assets.
- Client ID and Client Secret - The OAuth Client ID and Client Secret for OAuth access to ServiceNow. Refer to OAuth 2.0 with Inbound REST for full details on how to obtain the OAuth Token.
- Refresh Token - When using the OAuth method of authentication, enter the value of the Refresh Token issued by a ServiceNow instance.
Verify SSL - 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 - Connect the adapter to a proxy instead of directly connecting it to the domain.
- Quantity - The number of catalog items to request.
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.
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:For details, see Axonius to External Field Mapping.
APIs
Axonius uses the Product Documentation | ServiceNow API.
Required Permissions
The values supplied in Connection Parameters above must have permissions to create a request.
For more details about other Enforcement Actions available, see Action Library.