Active Directory activity pack

The Active Directory (AD) activity pack enables an administrator to create, delete, and manage objects in Windows Active Directory, such as users, groups, and computers, using a ServiceNow Orchestration workflow.

Activities in this pack can reset a password automatically from a user request or manage any user account in Active Directory, whether or not it was created by a Orchestration workflow.

Domain controllers are identified by the IP address of the host machine. To use the hostname of the domain controller, add the Resolve DNS Name activity to resolve the hostname into an IP, and then pass the IP into the Active Directory activity.

Your instance must have access to a MID Server configured to use PowerShell to run these activities.

Note: All Active Directory activities pass through error messages returned from Active Directory. To view these error messages, point to the failed activity in the workflow canvas or select the Workflow Log tab in a Workflow Context record.

Custom Active Directory activities

Orchestration provides custom Active Directory activities that were created with the Orchestration Create a PowerShell activity, starting with the Geneva release. These activities perform the same functions as AD activities by the same name from previous releases and replace those activities for all new workflows. Existing workflows from earlier versions that were created with legacy AD activities continue to function normally after an upgrade to Istanbul. However, all new workflows must use these custom AD activities. The Powershell activity template gives workflow administrators the ability to store input and output variables from the Query AD activity in the Databus.

Note: To use the Active Directory custom activities, you must request activation of the Orchestration - Active Directory plugin.

Active Directory credentials with LDAP

If you are using an LDAP Server with MID Servers, note that Orchestration and Active Directory activities do not use the user name and password configured on LDAP Servers. You must create a Windows type orchestration credential record Windows credentials. The username and password in the credentials record is used for LDAP queries that Orchestration and workflow activities perform.

Connection port used by AD Orchestration activities

All Active Directory activities use port 389 for LDAP access. If you are using AD activities with Oracle Virtual Directory (OVD) as a proxy, set up pass-through on port 389 only.

• Add User to Group AD activity
  The Add User to Group activity adds a user to a group in Windows Active Directory.
• Change AD User Password activity
  The Change AD User Password activity changes the password for an Active Directory user account.
• Create AD Object activity
  The Create AD Object activity creates an object in Windows Active Directory.
• Disable AD User Account activity
  The Disable AD User Account activity disables a Windows Active Directory user account, making it inactive.
• Enable AD User Account activity
  The Enable AD User Account activity enables a Windows Active Directory user account, making it active.
• Is AD Account Locked activity
  The Is AD Account Locked activity determines whether an Active Directory user account is locked.
• Query AD activity
  The Query AD activity retrieves entries from the Windows Active Directory based on an LDAP search filter and stores the results as a JSON string that can be used in the data bus.
• Remove AD Object activity
  The Remove AD Object activity deletes an object from Windows Active Directory.
• Remove User from Group AD activity
  The Remove User from Group activity removes a user from a group in Windows Active Directory.
• Reset AD User Password activity
  The Reset AD User Password activity resets the password of a user account in Windows Active Directory.
• Unlock AD Account activity
  The Unlock AD Account activity unlocks a locked Active Directory user account.
• Update AD Object activity
  The Update AD Object activity updates an object in Windows Active Directory.

Parent Topic:Orchestration activity packs