From cc9bcd4d854649b61168dfdbc8eab2e748ba317a Mon Sep 17 00:00:00 2001
From: lbonanomi <5369016+lbonanomi@users.noreply.github.com>
Date: Fri, 19 Apr 2019 16:03:28 -0400
Subject: [PATCH] ldapsearch: add page (#2915)

---
 pages/common/ldapsearch.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 pages/common/ldapsearch.md

diff --git a/pages/common/ldapsearch.md b/pages/common/ldapsearch.md
new file mode 100644
index 0000000000..28b88a8a32
--- /dev/null
+++ b/pages/common/ldapsearch.md
@@ -0,0 +1,35 @@
+# ldapsearch
+
+> CLI utility for querying an LDAP directory.
+
+- Query an LDAP server for all items that are a member of the given group and return the object's displayName value:
+
+`ldapsearch -D '{{admin_DN}}' -w '{{password}}' -h {{ldap_host}} -b {{base_ou}} '{{memberOf=group1}}' displayName`
+
+- Query an LDAP server with a no-newline password file for all items that are a member of the given group and return the object's displayName value:
+
+`ldapsearch -D '{{admin_DN}}' -y '{{password_file}}' -h {{ldap_host}} -b {{base_ou}} '{{memberOf=group1}}' displayName`
+
+- Return 5 items that match the given filter:
+
+`ldapsearch -D '{{admin_DN}}' -w '{{password}}' -h {{ldap_host}} -b {{base_ou}} '{{memberOf=group1}}' -z 5 displayName`
+
+- Wait up to 7 seconds for a response:
+
+`ldapsearch -D '{{admin_DN}}' -w '{{password}}' -h {{ldap_host}} -b {{base_ou}} '{{memberOf=group1}}' -l 7 displayName`
+
+- Invert the filter:
+
+`ldapsearch -D '{{admin_DN}}' -w '{{password}}' -h {{ldap_host}} -b {{base_ou}} '(!(memberOf={{group1}}))' displayName`
+
+- Return all items that are part of multiple groups, returning the display name for each item:
+
+`ldapsearch -D '{{admin_DN}}' -w '{{password}}' -h {{ldap_host}} '(&({{memberOf=group1}})({{memberOf=group2}})({{memberOf=group3}}))' "displayName"`
+
+- Return all items that are members of at least 1 of the specified groups:
+
+`ldapsearch -D '{{admin_DN}}' -w '{{password}}' -h {{ldap_host}} '(|({{memberOf=group1}})({{memberOf=group1}})({{memberOf=group3}}))' displayName`
+
+- Combine multiple boolean logic filters:
+
+`ldapsearch -D '{{admin_DN}}' -w '{{password}}' -h {{ldap_host}} '(&({{memberOf=group1}})({{memberOf=group2}})(!({{memberOf=group3}})))' displayName`