Versions Compared

Key

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

REST API Credentials configuration guidelines can be found here.

LDAP Identity Connector's Credentials type must always be specified as "ldap-identity".

Properties specific to the LDAP Identity Connector's Credentials are described below.

Easy Heading Free
navigationTitleOn this Page
wrapNavigationTexttrue
navigationExpandOptionexpand-all-by-default

LDAP Identity Connection Properties


Field

Required

Default

Multiple

NotesExample
typeYes-No

The value must be "".

"ldap-identity"

descriptionYes-NoName of the connection object.

"MyLdap ServerConnection"

credentialYes-NoID of the credential."f5587cee-9116-4011-b3a9-6b235b333a1b"
propertiesYes-NoConfiguration object
useScriptNofalseNoSelect to either connect to an LDAP or Active Directory (AD) server to download user and group information, or to run a script to fetch the information that should be cached.false
serverYes-NoThe URL of the LDAP server in the form ldap:server:port. For Active Directory (AD) servers, the LDAP protocol should be in upper case LDAP:server:port

"ldap://server:port"

searchBaseYes

"GlobalCatalog"

NoThe node in the directory from which to begin searches.
"dc=com,dc=accenture"

scope

No

SUBTREE

Yes

The scope of the LDAP search.

OBJECT, ONE_LEVEL, SUBTREE

userQuery

Yes

(&(objectClass=User)(objectCategory=Person))

No

The LDAP query to return all users.

"(&(objectClass=User)(objectCategory=Person))"

groupQuery

Yes"(objectCategory=Group)"No

The LDAP query to return all groups.

"(objectCategory=Group)"

connectTimeout

Yes"15s"NoThe maximum time to wait for a connection to the LDAP server."15s"

readTimeout

Yes"15s"No

The maximum time to wait for data from the LDAP server.

"15s"

useTLS

NofalseNo

If checked, the Start TLS extension will be used to connect to the LDAP server.

false

outputFormat

NoJSONYes

Format of the output of the script.

XML, JSON

Example

Code Block
themeRDark
titlePOST /aspire/_api/connections
{
	"credential": "f5587cee-9116-4011-b3a9-6b235b333a1b",
	"type": "ldap-identity",
	"description": "Ldap Identity Connection Test",
	"properties": {
		"useScript": "false",
		"server": "ldap://server:port",
		"searchBase": "dc=com,dc=accenture",
		"scope": "SUBTREE",
		"userQuery": "(&(objectClass=User)(objectCategory=Person))",
		"groupQuery": "(objectCategory=Group)",
		"connectTimeout": "15s",
		"readTimeout": "15s",
		"useTLS": "false"
	}
}