com.imperva.ddc.service

Class DirectoryConnectorService

java.lang.Object

com.imperva.ddc.service.DirectoryConnectorService

public class DirectoryConnectorService
extends Object

Created by gabi.beyo on 11/06/2015.

Expose DirectoryConnectorService public API Initialize Spring context - once and in a threadsafe mode

Method Summary

Modifier and Type	Method and Description
static ConnectionResponse	authenticate(Endpoint endpoint) Authenticate a user against an AD endpoint
static ConnectionResponse	authenticate(Endpoint endpointForAuth, boolean allowEnabledOnly, Endpoint endpoint) Authenticate a user against an AD endpoint
static List<EntityResponse>	getEntity(List<String> dns, FieldType fieldType, ObjectType objectType, Endpoint endpoint)
static EntityResponse	getUserByGuid(byte[] guid, Endpoint endpoint) Deprecated. Get user by GUID
static List<EntityResponse>	getUsersInGroup(int maxUsersPerGroup, List<String> groupNames, Endpoint endpoint)
static List<EntityResponse>	getUsersInGroup(int maxUsersPerGroup, List<String> groupNames, List<FieldType> fields, Endpoint endpoint) Finds recursively all groups' members of the given group list
static List<EntityResponse>	getUsersInGroup(int maxUsersPerGroup, String groupName, Endpoint endpoint)
static List<EntityResponse>	getUsersInGroup(List<String> groupNames, Endpoint endpoint)
static List<EntityResponse>	getUsersInGroup(List<String> groupNames, List<FieldType> fields, Endpoint endpoint) Finds recursively all groups' members of the given group list
static List<EntityResponse>	getUsersInGroup(String groupName, Endpoint endpoint) Finds recursively all groups' members of the given group
static boolean	isEnabled(Endpoint endpoint, String username)
static List<EntityResponse>	isMemberOf(List<String> logonName, Endpoint endpoint)
static List<EntityResponse>	isMemberOf(List<String> logonName, Endpoint endpoint, PagingCallback pagingCallback)
static List<String>	isMemberOf(String logonName, List<String> groupsNames, Endpoint endpoint) Finds recursively the groups of the given user based on a pre-defined group list to be checked
static List<String>	resolveDistinguishedName(List<String> names, FieldType fieldType, ObjectType objectType, Endpoint endpoint) Resolves the DN of the given FieldType FieldType od the N given values
static String	resolveDistinguishedName(String name, FieldType fieldType, ObjectType objectType, Endpoint endpoint) Resolves the DN of the given FieldType FieldType
static ConnectionResponse	testConnection(Endpoint endpoint) Deprecated. Test endpoint's connection
static TestQueryType	testQuery(Endpoint endpoint) Performs a small query to test that any user has been found in the given Endpoint Endpoint
static TestQueryType	testQuery(Endpoint endpoint, ObjectType objectType) Performs a small query to test that any given objectType has been found in the given Endpoint Endpoint

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

authenticate

public static ConnectionResponse authenticate(Endpoint endpoint)

Authenticate a user against an AD endpoint

Parameters:

endpoint - A Endpoint Authentication Endpoint

Returns:

ConnectionResponse An Object representing the Connection result

authenticate

public static ConnectionResponse authenticate(Endpoint endpointForAuth,
                                              boolean allowEnabledOnly,
                                              Endpoint endpoint)

Authenticate a user against an AD endpoint

Parameters:

allowEnabledOnly - True false flag indicates whether disabled users should be considered not authenticated

endpoint - A Endpoint Authentication Endpoint

Returns:

ConnectionResponse An Object representing the Connection result

resolveDistinguishedName

public static String resolveDistinguishedName(String name,
                                              FieldType fieldType,
                                              ObjectType objectType,
                                              Endpoint endpoint)

Resolves the DN of the given FieldType FieldType

Parameters:

name - The FieldType FieldType value

fieldType - The Requested FieldType FieldType

objectType - The Requested ObjectType ObjectType

endpoint - The endpoint Endpoint to query

Returns:

The resolved DN if found otherwise null

resolveDistinguishedName

public static List<String> resolveDistinguishedName(List<String> names,
                                                    FieldType fieldType,
                                                    ObjectType objectType,
                                                    Endpoint endpoint)

Resolves the DN of the given FieldType FieldType od the N given values

Parameters:

names - The FieldType FieldType values

fieldType - The Requested FieldType FieldType

objectType - The Requested ObjectType ObjectType

endpoint - The endpoint Endpoint to query

Returns:

The resolved DNs' list if found otherwise null

getEntity

public static List<EntityResponse> getEntity(List<String> dns,
                                             FieldType fieldType,
                                             ObjectType objectType,
                                             Endpoint endpoint)

Parameters:

dns -

fieldType -

objectType -

endpoint -

Returns:

isMemberOf

public static List<String> isMemberOf(String logonName,
                                      List<String> groupsNames,
                                      Endpoint endpoint)

Finds recursively the groups of the given user based on a pre-defined group list to be checked

Parameters:

logonName - The user's logonName

groupsNames - The Common Name of the groups to be checked

endpoint - The endpoint Endpoint to query

Returns:

The Common Name list of the detected groups

isMemberOf

public static List<EntityResponse> isMemberOf(List<String> logonName,
                                              Endpoint endpoint,
                                              PagingCallback pagingCallback)

isMemberOf

public static List<EntityResponse> isMemberOf(List<String> logonName,
                                              Endpoint endpoint)

getUsersInGroup

public static List<EntityResponse> getUsersInGroup(List<String> groupNames,
                                                   List<FieldType> fields,
                                                   Endpoint endpoint)

Finds recursively all groups' members of the given group list

Parameters:

groupNames - The groups to be checked

endpoint - The endpoint Endpoint to query

Returns:

The list of the detected group members

getUsersInGroup

public static List<EntityResponse> getUsersInGroup(List<String> groupNames,
                                                   Endpoint endpoint)

getUsersInGroup

public static List<EntityResponse> getUsersInGroup(int maxUsersPerGroup,
                                                   List<String> groupNames,
                                                   Endpoint endpoint)

getUsersInGroup

public static List<EntityResponse> getUsersInGroup(int maxUsersPerGroup,
                                                   List<String> groupNames,
                                                   List<FieldType> fields,
                                                   Endpoint endpoint)

Finds recursively all groups' members of the given group list

Parameters:

groupNames - The groups to be checked

fields - The requested information to query about each group member

endpoint - The endpoint Endpoint to query

Returns:

The list of the detected group members

getUsersInGroup

public static List<EntityResponse> getUsersInGroup(String groupName,
                                                   Endpoint endpoint)

Finds recursively all groups' members of the given group

Parameters:

groupName - The group to be checked

endpoint - The endpoint Endpoint to query

Returns:

The list of the detected group members

getUsersInGroup

public static List<EntityResponse> getUsersInGroup(int maxUsersPerGroup,
                                                   String groupName,
                                                   Endpoint endpoint)

getUserByGuid

public static EntityResponse getUserByGuid(byte[] guid,
                                           Endpoint endpoint)

Deprecated. Get user by GUID

Parameters:

guid - User's GUID

endpoint - The endpoint Endpoint to query

Returns:

The detected user

testQuery

public static TestQueryType testQuery(Endpoint endpoint)
                               throws Exception

Performs a small query to test that any user has been found in the given Endpoint Endpoint

Parameters:

endpoint - The endpoint Endpoint to query

Returns:

The test result TestQueryType

Throws:

Exception

testQuery

public static TestQueryType testQuery(Endpoint endpoint,
                                      ObjectType objectType)
                               throws Exception

Performs a small query to test that any given objectType has been found in the given Endpoint Endpoint

Parameters:

endpoint - The endpoint Endpoint to query

objectType - The Object type to query for

Returns:

The test result TestQueryType

Throws:

Exception

testConnection

public static ConnectionResponse testConnection(Endpoint endpoint)

Deprecated. Test endpoint's connection

Parameters:

endpoint - The endpoint Endpoint to query

Returns:

The connection result ConnectionResponse

isEnabled

public static boolean isEnabled(Endpoint endpoint,
                                String username)

Parameters:

endpoint - The endpoint Endpoint to query

username - Can be the sAMAccountName or the distinguishedName of the user

Returns:

true is user is enabled, otherwise false