AuthenticateUser

Metreos.Native.Ldap.AuthenticateUser

Summary

AuthenticateUser will connect and bind to an LDAP server to test the credentials of a user.

Usage

The boolean Authenticated result data parameter should only be used if the action returns Success. Any other case indicates that the operation failed for other reasons, such as connectivity or an unexpected LDAP-protocol error.

The branch condition returned provides useful information in determining the cause of failure:

ConnectionFailure

ConnectionFailure indicates that it was not possible to connect to the LDAP server.

Failure

Failureor that the action failed unexpectedly for a non-LDAP protocol related reason.

Remarks

None.

Action Parameters
Parameter Name.NET TypeDefaultDescription
LdapServerHost *System.StringThe IP address or host name of the LDAP server.
LdapServerPortSystem.UInt320The port of the LDAP server.
UsernameSystem.StringA user to test.
PasswordSystem.StringThe password of the user specified in the Username action parameter.
VersionSystem.Int323The version of the LDAP server being connected to.
Result Data
Parameter Name.NET TypeDescription
AuthenticatedSystem.BooleanIndicates if the credentials were used successfully to bind to the LDAP server. Only valid on Success.
ErrorCodeSystem.Int32An LDAP protocol-specific error code if the action fails due to ConnectionFailure. Note that in the case of ConnectionFailure, it is not guaranteed that the error code will be populated. The error code will be 0 in the case that no LDAP-specific error code could be found.
ErrorMessageSystem.StringAn LDAP protocol-specific error message if the action fails due to ConnectionFailure. Note that in the case of ConnectionFailure, it is not guaranteed that the error message will be populated. The error code will be null in the case that no LDAP-specific error message could be found.

Branch Conditions 

failure

No description.

success

No description.

ConnectionFailure

No description.