ServiceNow Actions

Actions for ServiceNow

• Create ServiceNow Assets (IRE API). Creates one or more new configuration items (CIs) in ServiceNow.

• Create/Update ServiceNow Assets (IRE API). Creates one or more new configuration items (CIs) in ServiceNow. If the one or more of the CIs already exist, this action updates the existing CIs.

Use Cases

Below are the possible use cases for the ServiceNow actions:

• Create ServiceNow Assets (IRE API). You could use this action to create a new CI in ServiceNow for previously unknown assets that were discovered by Lucidum.

• Create/Update ServiceNow Assets (IRE API). You could use this action to update asset records when a user is offboarded, to prevent unauthorized access.

Prerequisites

Before you can execute the actions for ServiceNow, you must create a ServiceNow user account with the following roles:

• itil

• rest_api_explorer

• web_service_admin

For details on creating a user in ServiceNow, see https://docs.servicenow.com/bundle/tokyo-platform-administration/page/administer/users-and-groups/task/t_CreateAUser.html

For details on assigning roles to a user, see https://docs.servicenow.com/bundle/tokyo-platform-administration/page/administer/users-and-groups/task/t_AssignARoleToAUser.html

Workflow

To create an action in Lucidum, follow these steps:

1. Choose Action Center from the left pane.

2. In the Action Center, choose from the action types in the Channels pane.

3. To create a configuration for the action, click the Manage Configuration button. A configuration provides the connection and authorization information to communicate with the external solution.

4. Save the configuration.

5. To create an action, click the Create a new action button. An action specifies the task to execute, the data to include in the action, and how frequently to execute the action.

6. Save the action.

7. Lucidum automatically executes the action at the time and recurrence you defined in the action.

You can apply an existing configuration to more than one action. If a configuration already exists, you might be able to re-use the existing configuration and might not need to create a new one.

ServiceNow Configuration

• Configuration Name. Identifier for the Configuration. This name will appear in the Lucidum Action Center.

• Host. The hostname or IP address of the ServiceNow server.

• User name The user name for a user account that has read and write permissions in ServiceNow.

• Password. The password associated with User Name.

• Class Name. Specify the name of the CI class where the new or updated asset resides.

Create a new action/View Action

• Action Type. Select an action from the pulldown options.

• Configuration Name. Select an action configuration from the pulldown options.

• Action Name. Identifier for the action. This name will appear in the Lucidum Action Center.

• Description. Description of the action.

• Filters. For new actions, the Add Filter button leads to the New Query page, where you can query for the assets or users that the action will act upon. For existing actions, this field displays the query for this action. The Edit Filter button leads to the New Query page, with the current query already loaded for editing. For details on creating and editing queries in Lucidum, the section on Building Queries.

• Schedule Settings. Define the schedule for the action. Choices are setting a Recurrence by date and time or After Data Ingestion, which happens at least once every 24 hours and can also be triggered manually.

• Do not trigger the action unless. Specify the number of results from Filters as a prerequisite for executing the action.

• Output Fields. The fields selected for the Filters. When creating or editing the query, you can select these fields in the Query Results page > Edit Column button.

• CMDB CI Table Name. Specify the CMDB CI table name where the new or updated asset resides.

• Field mapping. Map one or more Lucidum asset fields to ServiceNow fields. For each Lucidum field, specify the ServiceNow field to map.

• Use first IP address only. Select whether the first IP address is to be added to the ServiceNow asset. If you don’t specify a value, all the asset's IP addresses will be added to the ServiceNow asset.

• Use first MAC address only. Select whether the first MAC address is to be added to the ServiceNow asset. If you don’t specify a value in this field, all the asset’s MAC addresses will be added to the ServiceNow asset.