- 03 Jul 2024
- 4 Minutes to read
- Print
- DarkLight
- PDF
ServiceNow - Suspend User
- Updated on 03 Jul 2024
- 4 Minutes to read
- Print
- DarkLight
- PDF
ServiceNow - Suspend User deactivates a ServiceNow user account for:
- User assets that match the results of the selected saved query, and match the Enforcement Action Dynamic Value statement, 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.
- 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 Workspace adapter credentials.
- When you select this option, the Select Adapter Connection drop-down is available, and you can choose which adapter connection to use for this Enforcement Action.
To use this option, you must successfully configure a ServiceNow adapter connection.
Required Fields
These fields must be configured to run the Enforcement Set.
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.
- First Name - The user's first name.
- Last Name - The user's last name.
- Email - The users email address.
- Username - The username by which the user will be known in ServiceNow.
- First-login password generation method - The method used to generate the first login password for the user to gain access. When Manual password is selected, enter a password in the Password field. This password will be used by all new users created by this Enforcement Action until they change it.
Connection Parameters
When Use stored credentials from ServiceNow adapter is toggled Off, these fields are required:
ServiceNow Domain - The hostname or IP address of the ServiceNow server. This field format is 'https://[instance].service-now.com'.
User Name and Password - The credentials for a user account that has the Required Permissions to add users.
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.
Fetch devices updated in ServiceNow in the last X hours (0: All) (default: 0) - Enter an amount of hours to fetch only devices that have been updated in ServiceNow in the last specified number of hours.
Fetch users updated in ServiceNow in the last X hours (0: All) (default: 0) - Enter an amount of hours to fetch only users that have been updated in ServiceNow in the last specified number of hours.
Fetch users created in ServiceNow in the last X hours (0: All) (default: 0) - Enter an amount of hours to fetch only users that have been created in ServiceNow in the last specified number of hours.
Advanced configuration file - Upload an advanced configuration JSON file.
Enable Client Side Certificate - Select to enable Axonius to send requests using the certificates uploaded to allow Mutual TLS configuration for this adapter. When you select this option, 2 more fields are displayed:
Client Certificate File (.pem) - Adds a client side certificate to the connection.
- Click Choose file next to Client Certificate File to upload a public key file in PEM format
Client Private Key File (.pem) - Adds a private key to the connection (if the API/proxy requires identification).
- Click Choose file next to Client Private Key File to upload a client private key file in PEM format
Gateway Name - Select the gateway through which to connect to perform the action.
Required Permissions
The credentials used to connect to ServiceNow must have permission to create new users.
For more details about other Enforcement Actions available, see Action Library.