- 11 Nov 2024
- 7 Minutes to read
- Print
- DarkLight
- PDF
ManageEngine Endpoint (Desktop) Central and Patch Manager Plus
- Updated on 11 Nov 2024
- 7 Minutes to read
- Print
- DarkLight
- PDF
ManageEngine Endpoint (Desktop) Central and Patch Manager Plus is a desktop management and mobile device management software for managing desktops in LAN and across WAN and mobile devices from a central location, including automated patch deployment for Windows, macOS and Linux endpoints.
Types of Assets Fetched
This adapter fetches the following types of assets:
- Devices
- Vulnerabilities
- Software
- SaaS Applications
Parameters
- Domain (required) - The hostname or IP address of the ManageEngine Endpoint Central or Patch Manager server.
For cloud Endpoint/Desktop Central use:desktopcentral.manageengine.com
For cloud Patch Manager Plus use:patch.manageengine.com
- Port (required, default: 8020) - The port Axonius will use to communicate with the server (for cloud use 443).
- User Name and Password - The credentials for a user account that has permissions to fetch assets. For details, see Authentication and Authorization for On-Prem Instances.
When OAuth Client ID, OAuth Client Secret and OAuth Refresh Token are not supplied, User Name and Password are required.
- User Name Domain (optional, default: empty) - The AD domain. Use this option if you are using the AD authentication method.
- Domain Authorization Token (optional, default: empty) - Token to access the AD domain.
- Fetch Desktop Central Data - Select this parameter to fetch desktop central data. If you do not select this option, only patch data is fetched (patch data is available from both products).
- MFA QR Code (optional, default: empty) - If MFA is enabled using Google Authenticator, save the QR code received as a PNG file and upload it.
- If supplied, the connection for this adapter will use the uploaded file to authenticate the specified User Name and Password.
- If not supplied, the connection for this adapter will not add any additional authentication to the specified User Name and Password.
- OAuth Client ID, OAuth Client Secret and OAuth Refresh Token - The parameters for OAuth authentication, used in the cloud version of ManageEngine Endpoint Central and Patch Manager Plus. Refer to APIs for information on how to generate them.
- OAuth Zoho Accounts URL (default: https://accounts.zoho.com) - The account URL for your Zoho account. Refer to Refresh Access Tokens for information on how to obtain the account URL.
When User Name and Password are not supplied, OAuth Client ID, OAuth Client Secret and OAuth Refresh Token are required.
- MSP Customer ID - Customer ID to fetch information for, when connecting to Endpoint Central MSP. Only use this when connecting to Endpoint Central MSP, otherwise leave empty.
- API Version (optional) - Select the API version, either 1.3 or 1.4 (Beta).
- DC Instance (optional) - The ID used to add to the headers for the API calls, if specified.
- 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.
- HTTP Proxy and HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.
To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.
Advanced Settings
Advanced settings can either apply for all connections for this adapter, or you can set different advanced settings and/or different scheduling for a specific connection, refer to Advanced Configuration for Adapters.
- Calculate with binary (ie. 1024 vs 1000) - Select this option to obtain the total physical memory by dividing the computer hardware memory by 1024 instead of dividing by 1000.
- Fetch custom fields (only for on-prem) - Select this option to fetch all Desktop Central fields that are considered custom fields. Relevant to on-prem customer only.
- Enrich device with vulnerability data - Select this option to enrich the device with vulnerability data. The DesktopCentralCloud.VulnerabilityMgmt.READ scope is required for this.
- Seconds to sleep between requests - Set the number of seconds to sleep between system reports and software requests. This is useful in cases where the server is not sending 429 responses, but is still rate-limiting the client.
- Select endpoints to apply sleep between requests (default: System Report, Installed Software, Vulnerabilities) - From the dropdown, select one or more endpoints to apply the sleep seconds configuration.
- Assets per page - Set the number of assets to manage per page. The default amount is 200.
- Fetch installed software - By default, Axonius fetches device software from
inventory/installedsoftware
. Clear this option to not fetch device software. - Fetch system reports - Select this option to fetch device patch data from
patch/systemreport
. - Fetch inventory computer scan details - Select this option to fetch data from
/inventory/scancomputers
endpoint. - Include Only Devices with Last Seen value - Select whether to only fetch devices which have a last seen value. Devices which do not have a value for last seen are not fetched.
- Only fetch devices from the following types - Enter a comma separated list of configured device_type values. Devices will only be fetched if they have the device_type values listed.
To learn more about Adapter Configuration tab advanced settings, see Adapter Advanced Settings.
Connecting the Adapter
When your license is for Patch Manager plus
- Set the domain to https://patch.manageengine.com
- Set the port to 443
Note that the inventory is not fetched in this case.
APIs
Axonius uses the ManageEngine Desktop Central REST API.
Configuring OAuth Authentication and Authorization
This adapter supports OAuth Authentication to connect to the Cloud Instance
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:
- Desktop/Endpoint Central Scopes "DesktopCentralCloud.Common.READ,DesktopCentralCloud.SOM.READ,DesktopCentralCloud.Inventory.READ,DesktopCentralCloud.PatchMgmt.READ,DesktopCentralCloud.restapi.READ,DesktopCentralCloud.SOM.UPDATE,DesktopCentralCloud.Inventory.UPDATE,DesktopCentralCloud.PatchMgmt.UPDATE"
- Patch Manager Plus Scopes
- "PatchManagerPlusCloud.Common.READ,PatchManagerPlusCloud.PatchMgmt.READ,PatchManagerPlusCloud.SOM.READ,PatchManagerPlusCloud.restapi.READ,PatchManagerPlusCloud.PatchMgmt.UPDATE,PatchManagerPlusCloud.SOM.UPDATE"
- Time Duration: “10 minutes”
- Scope Description: free text (could be anything)
- 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:
curl -X POST "https://accounts.zoho.com/oauth/v2/token?grant_type=authorization_code&redirect_uri=http://localhost/callback&code=<code>&client_id=<client_id>&client_secret=<client_secret>"
- Execute the command on a linux machine (or windows with curl)
- From the response of the command, copy the value of “refresh_token“ (might start with “1000.“), and save it to a temporary file.
Using OAuth Authentication
- In Axonius, add a new connection in the ManageEngine Desktop Central/Patch Manager adapter, and fill the following details:
- Domain - the domain of Desktop Central/Patch Manager (for cloud - use desktopcentral.manageengine.com).
- Port - the port of the domain (for cloud - 443)
- OAuth Client ID, OAuth Client Secret, OAuth Refresh Token - the values you copied to a temporary file
- OAuth Zoho Accounts URL - The relevant url for your Zoho account, from Refresh Access Tokens - APIs
Axonius will now fetch devices from Desktop Central/Patch Manager using OAuth.
Authentication and Authorization for On-Prem Instances
You need to generate a password and then add permissions:
To generate a password:
- From Desktop Central's web console, navigate to Admin -> API Explorer.
- On the left pane, click Authentication -> Login.
- Choose the authentication type as either Local authentication or AD authentication and furnish the user name and password.
- Upon execution, you will obtain a password along with the auth token.
Use that password in the Password field.
If you have selected the AD authentication, specify the domain in the User Name Domain field.
Editing Permissions
To edit permissions for an existing role in ManageEngine Endpoint Central On-prem, follow the steps given below:
- Log in to the ManageEngine Endpoint Central On-prem console using your admin credentials.
- Click on the “Admin” tab and select “Roles” from the left-hand side menu.
- Locate the role you want to edit from the list of roles, and click on the role name to open the role details page.
- On the role details page, you will see a list of permissions assigned to that role. To edit the permissions, click on the “Edit” button located at the top right corner of the page.
- In the “Edit Role” page, you can add or remove permissions by selecting or deselecting the checkboxes for each permission.
- To grant permissions for REST API, click on the “API Access” tab and select the appropriate REST API methods you want to allow for this role.
- Grant the following permissions: SOM, Report, Inventory, Software Deployment, Patch Management.
- Once you have made the necessary changes, click Update to save the updated role.
Version Matrix
This adapter was only tested with the versions marked as supported, but may work with other versions. Contact Axonius Support if you have a version that is not listed, which is not functioning as expected.
Version | Supported | Notes |
---|---|---|
ManageEngine Desktop Central 10.1.2121.1 | Yes |
Supported From Version
Supported from Axonius version 4.4