ADManager Plus Integration

ADManager Plus is a simple, easy-to-use Windows Active Directory Management and Reporting Solution that helps AD administrators and help desk technicians with their day-to-day activities.

ServiceDesk Plus-ADManager Plus Integration offers ease of use for AD administrators and help desk technicians to do actions quickly in AD via ServiceDesk Plus interface. Administrators can reset password, create, delete, unlock, enable and disable users in AD from ServiceDesk Plus.

 

Create User in AD (new UI) and Modify Account Expires options are available only in ServiceDesk Plus version 14810 or above and ADManager Plus version 7230 or above.

 

Go to Admin > Apps & Add-ons > Integrations > ADManager Plus.

 

 

Role Required: SDAdmin

Quick Links

Domain Configuration in ServiceDesk Plus 

Create domains to ensure users are mapped in the relevant domains via ServiceDesk Plus - ADManager Plus Integration.

The login name and domain name of the help desk technician in ADManager Plus should be same as that in ServiceDesk Plus.

ADManager Plus Server Configuration in ServiceDesk Plus 

  1. Select the Enable ADManager Plus menu if you want to show the ADManager Plus menu in technician login.
  2. Enter the URL where the application is currently hosted.
  3. Click Test Connection and Save to check for an established connection between ServiceDesk Plus and ADManager Plus in their respective ports.

Click Remove to remove the established connection between the two applications.

 

 

ADManager Plus actions section has the list of available ADManager Plus actions and their description. Click to edit an action.

 

 

After enabling ADManager Plus actions for certain templates, the administrator can enable/disable the actions to be displayed for service requests under Template Actions available in the Workflow tab of the service template.

 

 

The enabled options are displayed in Custom Actions menu in request details page. An entry in history will be added when an action is invoked.

 

 

ServiceDesk Plus Server Configuration and Authentication in ADManager Plus:

The following settings have to be entered and configured in ADManager Plus. The settings are available in ADManager Plus under Admin > General Settings > ServiceDesk Plus.

  1. Enter the server name and server port where ServiceDesk Plus is currently running and choose the protocol settings.
  2. Enable Enable tight integration with ServiceDesk Plus to ensure integration between the two applications and exchange related tasks from ServiceDesk Plus.
  3. Click Test connection and Save. This will check for an established connection between ServiceDesk Plus and ADManager Plus in their respective ports and save the settings.

 

 

This integration will be available only for ServiceDesk Plus technicians configured as help desk technicians in ADManager Plus as explained below:

  1. Go to AD Delegation > Help Desk Delegation > Help Desk Technicians > Add New Technician.
  2. Select help desk roles, templates and groups for the technicians.
  3. Click Save.

Help desk technicians can also be added from Active Directory.

  1. Select the domain, AD users, help desk roles, and organizational units.
  2. Enable Impersonate as Admin to provide admin permissions for the technician.
  3. Click Save.

 

 

Sample Scenario: A new employee joins the organization and a new account has to be created in ServiceDesk Plus and in AD. Instead of entering details twice, the administrator can create a user in AD from ServiceDesk Plus and also sync the additional information obtained in additional fields. Note that the resource fields cannot be synced between ServiceDesk Plus and ADManager Plus.

Create User in ADManager Plus from ServiceDesk Plus

The Create User in AD action can be invoked by technicians from the Custom Actions menu in request details page to add users in ADManager Plus.

You can map ADManager Plus fields to be updated while creating AD users via ServiceDesk Plus requests.

  1. While configuring ADManager Plus integration, click to besides Create User in AD action.
  2. Click Map Fields.
  3. Select the ADManager Plus field to map.
  4. Select a corresponding ServiceDesk Plus field.
  5. Click to map multiple fields.
  6. Click Save.

 

Before upgrading to build 14800, users can map fields only via the Admp.xml file. To continue using the file,

The ID of the corresponding additional field in ADManager Plus is required to map the field.

ServiceDesk Plus Field Name       Field ID
Request ID  WORKORDERID
Created By           CREATEDBY
Subject SUBJECT
Template       REQUESTTEMPLATE
Mode MODE
SLA SLA
Asset ASSET
Site SITE
Service Category SERVICE
Category CATEGORY
SubCategory SUBCATEGORY
Item       ITEM
Technician TECHNICIAN
Status STATUS
Priority PRIORITY
Level LEVEL
Impact IMPACT
Impact Details IMPACTDETAILS
Urgency             URGENCY
Request Type REQUESTTYPE      
Group       GROUP
Description DESCRIPTION
Description Short SHORTDESCRIPTION
Requester       REQUESTER
Department DEPARTMENT
Created Date CREATEDDATE
DueBy Date DUEBYDATE
Time Elapsed TIMESPENTONREQ
Resolved Date RESOLVEDTIME
Completed Date COMPLETEDTIME
Response DueBy Time RESPONSEDUEBYTIME
Additional Fields Field Name in SDP

 

create-new-AD-user

 

Syncing ServiceDesk Plus Additional fields with ADManager Plus

Additional fields added in a request template can be synced with AD Manager Plus:

  1. Create the required additional fields: 'Seating Location' and the 'Extension Number' from Admin > Customizer > Additional Fields > Incident.
  2. After creating the additional fields, open the Admp.xml file available under [SDP_Home] > integration > resources > admp >> conf

In the HTML fields, enter the name, type and value of the additional field added. The value of the field can be obtained from the Active Directory attributes file.

Eg: Seating Location:

<field>

<name>Seating Location</name>

<type>input</type>

<value>info</value>

</field>

Extension Number:

<field>

<name>Extension Number</name>

<type>input</type>

<value>otherTelephone</value>

</field>
 

html-fields

 

3. After entering the HTML fields, enter the mapping fields with the exact name and value.

For eg: 

Seating Location:

<field>

<name>info</name>

<value>Seating Location>

</field>

Extension Number:

<field>

<name>otherTelephone</name>

<value>Extension Number</value>

</field>

 

mapping-fields

 

4. Create a new AD user account from Custom Actions menu in request details page. A pop-up containing the created additional fields will be displayed as follows. Enter the necessary details and click Create AD User.

 

craete-new-ad-user

 

5. The user will be successfully created in AD. You can check the added AD user in ADMP under AD Management > Modify Single User by filtering the domain of the user created.

 

6. Click Modify User drop-down button > Modify User Properties to view the details of the added user (also includes details of the additional fields added). Make sure that additional fields added in SDP are available as default attribute fields in ADMP. You can check the default attributes avaialble in ADMP in this file. If the created additional field and its details are not supported by default in ADMP, then create a new custom attribute under Custom Attributes > Adding new field


  
Troubleshooting

Error: You don't have permission to perform this action.

Solution:

 

Error: Authentication failed. Tight integration not enabled.

Solution: Select the Enable tight integration with ServiceDesk Plus checkbox at ADManager Plus > Admin > Integrations > ServiceDesk Plus.

 

Error: Your domain is not configured

Solution: Domain Name value of the ServiceDesk Plus technician must be same in both ADManager Plus and ServiceDesk Plus.

 

Error: Unable to connect with AD Server

Solution: If ADManager Plus is running in HTTPS mode, the SSL certificate of ADManager Plus must be imported in ServiceDesk Plus.

Follow the steps to directly add the certificate in ServiceDesk Plus.
Check if any of the proxy settings in ServiceDesk Plus is leading to an error in establishing a connection with ADManager Plus.