Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

About this Resource

Excerpt

The Acive Directory Domain Controller resource contains settings for the domain controllers used by the Active Directory Configuration.

REST API Methods for this Resource

Resource Schema

Configuration

Parameter Name Required Service Affecting Data Type Default Value Possible Values Description
DescriptionYesNostringnone64 - Max LengthThe description of the Domain Controller that will be referenced by the Active Directory Configuration resource.
LDAPQueryYesNostringnone256 - Max LengthApplies a filter to the Search Scope (defined in the Active Directory Configuration resource) to limit the number of active directory users included in the cache.
SearchScopeYesNostringnone256 - Max LengthSpecifies the tree location in Active Directory to use at the starting point for search queries or authentication requests.
DomainControllerYesNostringnone256 - Max LengthSpecifies an IP address or Fully Qualified Domain Name (FQDN) of the Domain Controller.
UserNameYesNostringnone256 - Max LengthSpecifies username (BindDN) to use for querying the Active Directory.
EncryptedPasswordYesNostringnone256 - Max LengthSpecifies password (BindPW) to use for querying the Active Directory.
DCPriorityYesYesint0Possible values:
  • 0 - Minimum
  • 5 - Maximum
Sets the priority of the DC which determines in what order AD will be queried.
Note

This has no affect when using the AD cache.

Note

Each DC type (Auth and call routing) have their own set of priorities.

Note

Priority of 0 indicates not configured. Set a valid priority.

DCTypeYesNoint0Possible values:
  • 0 - Minimum
  • 1 - Maximum
Determines whether this DC will be used for user authentication or call routing.

Runtime

Parameter Name Description Data Type Possible Values
rt_ADStatusReports the up/down state of the Domain Controller.EnumPossible values:
  • 0 - eADUp
  • 1 - eADDown
rt_CacheStatusReports the current cache status of the Domain ControllerEnumPossible values:
  • 0 - eCacheDisabled
  • 1 - eCacheBuilding
  • 2 - eCacheUpdating
  • 3 - eCacheActive
  • 4 - eCacheFailed
  • 5 - eCacheBackup
  • 6 - eCacheTruncated
  • 7 - eCacheNotApplicable
rt_BackupStatusReports the current backup status of the Domain Controller.EnumPossible values:
  • 0 - eBackupSuccessful
  • 1 - eBackupFailed
  • 2 - eBackupDisabled
  • 3 - eBackupNotApplicable
  • 4 - eBackupTruncated
  • 5 - eBackupUpdating