Cluster LDAP requests

LDAP configuration requests

Get LDAP configuration

GET /v1/cluster/ldap

Get the LDAP configuration.

Required permissions

Request

Example HTTP request

GET /v1/cluster/ldap 

Request headers

Response

Returns an LDAP object.

Example JSON body

{
   "bind_dn": "rl_admin",
   "bind_pass": "***",
   "ca_cert": "",
   "control_plane": false,
   "data_plane": false,
   "dn_group_attr": "MemberOf",
   "dn_group_query": {
      "base": "DC=windowsAD,DC=qa,DC=redislabs,DC=com",
      "filter": "member=%D",
      "scope": "subtree"
   },
   "starttls": false,
   "uris": ["ldap://ldap.example.org:636"],
   "user_dn_query": {
      "base": "DC=windowsAD,DC=qa,DC=redislabs,DC=com",
      "filter": "(&(objectClass=Person)(cn=%u))",
      "scope": "subtree"
   },
   "user_dn_template": "cn=%u, ou=users,dc=example,dc=org"
}

Status codes

Update LDAP configuration

PUT /v1/cluster/ldap

Set or update the cluster LDAP configuration.

Required permissions

Request

Example HTTP request

POST /v1/cluster/ldap 

Example JSON body

{
    "uris": [
       "ldap://ldap.redislabs.com:389"
    ],
    "bind_dn": "rl_admin",
    "bind_pass": "secret",
    "user_dn_template": "cn=%u,dc=example,dc=org",
    "dn_group_attr": "MemberOf",
    "directory_timeout_s": 5
}

Request headers

Request body

Include an LDAP object with updated fields in the request body.

Response

Returns a status code. If an error occurs, the response body may include an error code and message with more details.

Error codes

Possible error_code values:

Status codes

Delete LDAP configuration

DELETE /v1/cluster/ldap

Clear the LDAP configuration.

Required permissions

Request

Example HTTP request

DELETE /v1/cluster/ldap 

Request headers

Response

Returns a status code.

Status codes