On this Page

Snap type:

Write

Description:

This Snap lists the user with the specified Distinguished Name in Active Directory.

Expected upstream Snaps: File Reader followed by any file Parser followed by Structure.
Expected downstream Snaps: Any file Formatter followed by File Writer.
Expected input: Distinguished name
Expected output: Lists the users in Active Directory based on the provided distinguished name.

Prerequisites:

[None]

Support and limitations:

- Ultra pipelines: Works in Ultra Pipelines.
- Spark mode: Not supported in Spark mode.

Account:

This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. See Active Directory Basic Auth Account for information on setting up this type of account.

Views:

Input	This Snap has exactly one document input view.
Output	This Snap has exactly one document output view.
Error	This Snap has at most one document error view and produces zero or more documents in the view.

Settings

Label

Required. The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline.

Distinguished name

Required. The LDAP API references an LDAP object by its distinguished name (DN). A DN is a sequence of relative distinguished names (RDN) connected by commas. An RDN is an attribute with an associated value in the form attribute=value, normally expressed in a UTF-8 string format. The following lists typical RDN attribute types as: DC = domainComponent, CN = commonName, OU = organizationalUnitName,O = organizationName, STREET = streetAddress, L = localityName,ST = stateOrProvinceName, C = countryName, UID = userid.
Example: CN=AbcUser,CN=Users,DC=server,DC=company,DC=com

Default value: [None]

Snap execution

Select one of the three modes in which the Snap executes. Available options are:

Validate & Execute: Performs limited execution of the Snap, and generates a data preview during Pipeline validation. Subsequently, performs full execution of the Snap (unlimited records) during Pipeline runtime.
Execute only: Performs full execution of the Snap during Pipeline execution without generating preview data.
Disabled: Disables the Snap and all Snaps that are downstream from it.

Examples

The following table provides some examples of the data returned for varying Distinguished name values.

Distinguished name value	Returns
CN=user,CN=Users,DC=server,DC=company,DC=com	Details about that user.
CN=Users,DC=server,DC=company,DC=com	Details about all items in "Users" under that domain.
DC=server,DC=company,DC=com	Details about all objects on that server domain.

Snap Pack History

Click to view/expand

Release	Snap Pack Version	Date	Type	Updates
November 2024	main29029	13 Nov 2024	Stable	Updated and certified against the current SnapLogic Platform release.
August 2024	main27765	21 Aug 2024	Stable	Updated and certified against the current SnapLogic Platform release.
May 2024	main26341	08 May 2024	Stable	Updated and certified against the current SnapLogic Platform release.
February 2024	main25112	14 Feb 2024	Stable	Updated and certified against the current SnapLogic Platform release.
November 2023	main23721	08 Nov 2023	Stable	Updated and certified against the current SnapLogic Platform release.
August 2023	434patches23465	27 Oct 2023	Latest	Fixed an issue with the Update Entry Snap that caused a null pointer exception when both a delimiter was provided and the attribute value was set to null.
August 2023	main22460	16 Aug 2023	Stable	Updated and certified against the current SnapLogic Platform release.
May 2023	433patches21612	20 Jun 2023	Latest	Fixed the following issues with the Active Directory Update Entry Snap where the Snap produced incorrect results with the version main21015: When set to `null`, all the string attributes were updated with the literal "null" string instead of an empty string. The Snap failed with `javax.naming.directory.InvalidAttributeValueException` error when all the number-type attributes were set to `null`.
May 2023	main21015	10 May 2023	Stable	Upgraded with the latest SnapLogic Platform release.
February 2023	main19844	09 Feb 2023	Stable	Upgraded with the latest SnapLogic Platform release.
November 2022	main18944	10 Nov 2022	Stable	Upgraded with the latest SnapLogic Platform release.
September 2022	430patches17872	19 Sep 2022	Latest	The Azure Directory Search Snap doesn't fetch duplicate records when the Group result checkbox is not enabled.
August 2022	main17386	11 Aug 2022	Stable	Upgraded with the latest SnapLogic Platform release.
4.29	main15993	14 May 2022	Stable	Upgraded with the latest SnapLogic Platform release.
4.28	main14627	12 Feb 2022	Stable	Added the Active Directory Remove Member Snap that enables you to remove an existing member from a specified group in Active Directory.
4.27	main12833	13 Nov 2021	Stable	Enhanced the Active Directory Search Snap with a new fieldset, Returning Attributes, to define attributes that you want the Snap to return in the search results.
4.26 Patch	426patches11280	03 Sep 2021	Latest	Fixed an issue with the Active Directory Add Member Snap that failed when using forward slash "/" in the Distinguished name field.
4.26	main11181	14 Aug 2021	Stable	Upgraded with the latest SnapLogic Platform release.
4.25	main9554	09 May 2021	Stable	Upgraded with the latest SnapLogic Platform release.
4.24	main8556	13 Feb 2021	Stable	Upgraded with the latest SnapLogic Platform release.
4.23 Patch	423patches8210	20 Jan 2021	Latest	Fixes an issue of fetching search records in the Active Directory Search Snap by adding a new field, Limit, to specify the number of search records to be fetched from the Active Directory. Previously the Page Size field worked similar to the Limit field, that is, it sets the limit on fetching records instead of fetching all the records. The Active Directory Search Snap output now displays the number of records that you specify in the Limit field under Settings. If your Pipelines use the Snap with the Page Size field, they may fail to execute if the downstream Snap expects the same count. To retrieve all the records, configure the Snap with default settings, that is, Limit: 0 and Page Size: 1000.
4.23 Patch	423patches7454	20 Jan 2021	Latest	Adds the Pass through check box in all the Snaps to include pass-through functionality. Select this check box to embed the upstream input documents under the `original` field of the output document along with other records.
4.23	main7430	14 Nov 2020	Stable	Enhances the Active Directory Search Snap by adding a new field, Group results, to group the output result in a single array. Active Directory Authenticate Users Snap: A new Snap in the Active Directory Snap Pack that enables you to use SnapLogic Platform to authenticate Active Directory (AD) users against the configured AD server.
4.22	422patches6531	20 Sep 2020	Latest	Enhances the Active Directory Create Entry and Active Directory Update Entry Snaps by adding Attribute Value Delimiter field to separate multiple values entered in the Attribute value field.
4.22	main6403	12 Oct 2020	Stable	Upgraded with the latest SnapLogic Platform release.
4.21	snapsmrc542	09 May 2020	Stable	Upgraded with the latest SnapLogic Platform release.
4.20 Patch	activedirectory8789	02 Apr 2020	Latest	Fixes the Active Directory Snaps to successfully read special characters in the Existing distinguished name and Distinguished name Snap settings without requiring escape characters.
4.20	snapsmrc535	08 Feb 2020	Stable	Fixes the Search Snap and the List Users Snap wherein the Snaps displayed only the first element of an array field. Now, the Snaps display all the elements of an array field.
4.19 Patch	activedirectory8506	16 Jan 2020	Latest	Fixes the Search Snap and the List Users Snap wherein the Snaps displayed only the first element of an array field. Now, the Snaps display all the elements of an array field.
4.19	snapsmrc528	14 Nov 2019	Stable	Upgraded with the latest SnapLogic Platform release.
4.18	snapsmrc523	10 Aug 2019	Stable	Upgraded with the latest SnapLogic Platform release.
4.17 Patch	ALL7402		Latest	Pushed automatic rebuild of the latest version of each Snap Pack to SnapLogic UAT and Elastic servers.
4.17	snapsmrc515	11 Jun 2019	Stable	Added the Snap Execution field to all Standard-mode Snaps. In some Snaps, this field replaces the existing Execute during preview check box.
4.16	snapsmrc508	16 Feb 2019	Stable	Upgraded with the latest SnapLogic Platform release.
4.15	snapsmrc500	15 Dec 2018	Stable	Upgraded with the latest SnapLogic Platform release.
4.14	snapsmrc490	11 Aug 2018	Stable	Upgraded with the latest SnapLogic Platform release.
4.13	snapsmrc486	12 May 2018	Stable	Upgraded with the latest SnapLogic Platform release.
4.12	snapsmrc480	17 Feb 2018	Stable	Upgraded with the latest SnapLogic Platform release.
4.11 Patch	activedirectory4630	07 Feb 2018	Latest	Resolved an issue with the Active Directory Search Snap that Ignored PartialResultException and did not handle the slashes and backslashes in the search function: Added the original exception to SnapdataException for the Active Directory Snaps. Improved the error message.
4.11	snapsmrc465	11 Nov 2017	Stable	Upgraded with the latest SnapLogic Platform release.
4.10	snapsmrc414	12 Aug 2017	Stable	Upgraded with the latest SnapLogic Platform release.
4.9	snapsmrc405	13 May 2017	Stable	Upgraded with the latest SnapLogic Platform release.
4.8	snapsmrc398	11 Feb 2017	Stable	Upgraded with the latest SnapLogic Platform release.
4.7	snapsmrc382	23 Nov 2016	Stable	Upgraded with the latest SnapLogic Platform release.
4.6 Patch	activedirectory2056	10 Nov 2016	Latest	Resolved an issue with modifying the "unicodePwd" attribute using the Active Directory - Update Entry Snap.
4.6	rcmsf233	13 Aug 2016	Stable	Extended support for a der encoded representation of Anaplan Certificate for Anaplan account validation. Resolved an issue in Create Entry, Search, and Update Entry Snaps that caused certain attributes to not appear in suggestions.
4.5.1	rcmsf231	18 May 2016	Stable	Upgraded with the latest SnapLogic Platform release.
4.5	rcmsf231	14 May 2016	Stable	Upgraded with the latest SnapLogic Platform release.
4.3.2			Stable	Resolved an issue in Active Directory Search resulting in an error using a port value in the server URI.
4.3.0			Stable	The Update Snap now populates all attributes during Suggest. The Search Snap now shows those attributes that have values.
4.2.2			Stable	Resolved an issue with the account failing to validate after the last Snap release. Resolved an issue with the Active Directory Search Snap failing to throw an exception for an invalid search. Resolved an issue with the Active Directory Search Snap not routing an error to the error view for a null search. Resolved an issue with the Active Directory Search Snap adding a blank space on all strings. Updated the tooltips within the Active Directory Snap Pack.
4.2.1			Stable	Resolved "Pass through only supported for Map data." message showing in Active Directory Rename Snap.

Active Directory List Users

Settings

Examples