- 16 Apr 2023
- 4 Minutes to read
- Print
- DarkLight
- PDF
ManageEngine ServiceDesk Plus - Create Request
- Updated on 16 Apr 2023
- 4 Minutes to read
- Print
- DarkLight
- PDF
ManageEngine ServiceDesk Plus - Create Request creates a ManageEngine ServiceDesk Plus request 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 - Click to 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 and Adapter Fetch History 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 Action Conditions - Toggle on to enter a condition statement. See Configuring Enforcement Action Conditions to learn more about condition statement syntax.
Use stored credentials from ManageEngine ServiceDesk Plus adapter - Select this option to use ManageEngine ServiceDesk Plus (SDP) connected 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.
Note:To use this option, you must successfully configure a ManageEngine ServiceDesk Plus (SDP) adapter connection.
Required Fields
These fields are required to run the Enforcement Action.
- Request Title (default: Axonius-created Request) - Enter a name for the request.
- Instance Name - 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.
- Host Name or IP Address - The hostname or IP address of the Manage Engine ServiceDesk Plus server that Axonius can communicate with.
Authentication Methods
Select Authentication method, either oAuth 2.0 or Basic Authentication
Select Authentication method either oAuth 2.0 or Basic Authentication.
Basic Authentication:- Technician key token (required) - Use for on-prem deployment of ManageEngine ServiceDesk Plus (SDP). An API Key associated with a user account that has the Required Permissions to fetch assets.
To obtain a technician key token, see Generate a Technician Key Token.
- Technician key token (required) - Use for on-prem deployment of ManageEngine ServiceDesk Plus (SDP). An API Key associated with a user account that has the Required Permissions to fetch assets.
oAuth 2.0
Use for cloud deployment of ManageEngine ServiceDesk Plus (SDP).
a. OAuth Client ID, OAuth Client Secret and OAuth Refresh Token - parameters for OAuth authentication, used in the cloud version of ManageEngine ServiceDesk Plus. Refer to Configuring OAuth Authentication for information on how to generate them.
b. OAuth Zoho Accounts URL - Select the account URL, or add your own. Refer to Refresh Access Tokens for information on how to obtain the account URL.
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.
HTTPS proxy User Name - The user name to use when connecting to the server using the HTTPS Proxy.
HTTPS Proxy Password - The password to use when connecting to the server using the HTTPS Proxy.
Description (default: Axonius-created request) - Enter a description of the request.
Requester E-mail - Enter the email address of the requester.
Status - Enter a status.
Priority - Enter a priority.
Category - Enter a category.
Tunnel Name - For Axonius-hosted (SaaS) deployments. Select the tunnel through which to connect to perform the action.
APIs
Axonius uses these APIs:
Permissions
The following permissions are required:
Configuring OAuth Authentication
This adapter supports OAuth Authentication
Generating the OAuth Client ID, OAuth Client Secret and OAuth Refresh Token
To use OAuth Authentication you need to generate the OAuth Client ID, OAuth Client Secret and OAuth Refresh Token. To generate them:
Go to the Zoho API Console: https://api-console.zoho.com/
Click 'Add client', choose 'Self Client' and click 'Create' (if a popup asks you to confirm, click “OK“).
On the API Console main page, click on the 'Self Client' application
In the tab 'Generate Code', enter the following details, and click 'Create':
- Scope:
- "SDPOnDemand.assets.READ,SDPOnDemand.requests.CREATE"
- Time Duration: “10 minutes”
- Scope Description: free text (could be anything)
- Scope:
A popup “Generated Code“ opens, click copy, and paste the code in a temporary file.
In the tab “Client Secret“, copy “Client ID“ and “Client Secret“ to a temporary file
Enter the values you’ve copied to the following command on a linux machine (or Windows with curl):
curl -X POST "https://accounts.zoho.com/oauth/v2/token?grant_type=authorization_code&code=<code>&client_id=<client_id>&client_secret=<client_secret>"
- From the response of the command, copy the value of “refresh_token“, and save it to a temporary file.
- Copy the OAuth Client ID, OAuth Client Secret, OAuth Refresh Token to the appropriate places in the Configuration dialog.
For more details about other Enforcement Actions available, see Action Library.