Doc: How to search for users in multiple LDAP groups

[jifox]

Extend https://nautobot.readthedocs.io/en/latest/configuration/authentication/ldap/#user-authentication documentation to show how to search multiple LDAP Groups for users.

Added text:

The following snippet shows how to search for users in multiple LDAP groups:

• Define the user-groups in *.env file (delimiter ';')

  # Groups to search for user objects. "(sAMAccountName=%(user)s),..."
  NAUTOBOT_AUTH_LDAP_USER_SEARCH_DN=OU=IT-Admins,OU=special-users,OU=Acme-User,DC=Acme,DC=local;OU=Infrastruktur,OU=IT,OU=my-location,OU=User,OU=Acme-User,DC=Acme,DC=local

• Import LDAPSearchUnion in nautobot_config.py

  from django_auth_ldap.config import ..., LDAPSearchUnion

• In nautobot_config.py replace the AUTH_LDAP_USER_SEARCH command from above with:

  user_search_dn_list = str(AUTH_LDAP_USER_SEARCH_DN).split(";")
  ldapsearch_objects = []
  for sdn in user_search_dn_list:
      ldapsearch_objects.append(LDAPSearch(sdn.strip(), ldap.SCOPE_SUBTREE, "(sAMAccountName=%(user)s)"))
  AUTH_LDAP_USER_SEARCH = LDAPSearchUnion(*ldapsearch_objects)

[glennmatthews]

Thanks for the PR!

[jifox]

I've fixed the render problem and added os.getenv(... to example code.

[glennmatthews]

Thank you!