Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Added version and permission


/rest/systemsettings/ldap

 

Descriptor

Value

HTTP Method

PUT

Description

Sets the values for the LDAP configuration fields.

Restricted

trueRequired Permission

Manage System Settings

Version Introduced2.5.0.7

 

Request Header Parameters

Parameter

Value

Required

Description

Accept

String

Yes

A value of ‘application/json’ must be provided.

 

Request POST Data Parameters

Must be passed in as a JSON Object

Parameter

Value

Required

Description

url

URL

Yes

URL for LDAP server.

searchBase

String

Yes

The point from which ThreadFix will search for LDAP users from.

userDn

String

Yes

User domain name to use for LDAP queries.


passwordStringYesPassword for user domain name.
loginFilterStringNoOverride filter to get the account of the person logging in.
usersFilterStringNoOverride filter to get the list of users in the directory.
groupsFilterStringNoOverride filter to get the list of groups in the directory.
usersGroupsFilterStringNoOverride filter to get the list of groups for a user.


Sample Call:

Code Block
themeEclipse
curl --insecure -X PUT -H "Content-Type: application/json" -H "Authorization: APIKEY {apiKey}" 
-d '{"url": "ldap://your.url.here", "searchBase": "DC=yourBaseHere,DC=org", "userDn": "CN=user,DC=yourBaseHere,DC=org", "password": "userPassword", "loginFilter": "uid={0}", "usersFilter": "objectClass=User", "groupsFilter": "(&(objectClass=group)(cn={0}))", "usersGroupsFilter": "(&(memberUid={0})(objectClass=posixGroup))"}'
http://localhost:8080/threadfix/rest/systemsettings/ldap

 

Sample Output:


Code Block
themeEclipse
{
  "message": "",
  "success": true,
  "responseCode": -1,
  "object": {
    "groupsFilter": "(&(objectClass=group)(cn={0}))",
    "password": null,
    "loginFilter": "uid={0}",
    "usersFilter": "objectClass=User",
    "usersGroupsFilter": "(&(memberUid={0})(objectClass=posixGroup))",
    "searchBase": "DC=yourBaseHere,DC=org",
    "url": "ldap://your.url.here",
    "userDn": "CN=user,DC=yourBaseHere,DC=org"
  }
}


Page Tree
rootMiscellaneous API