public interface SimpleBindRequest extends BindRequest
Requests
has methods to create a SimpleBindRequest
.
String bindDN = ...; char[] bindPassword = ...; SimpleBindRequest sbr = Requests.newSimpleBindRequest(bindDN, bindPassword);Alternatively, use
Connection.bind
.
Connection connection; String bindDN = ...; char[] bindPassword = ...; connection.bind(bindDN, bindPassword);
AUTHENTICATION_TYPE_SASL, AUTHENTICATION_TYPE_SIMPLE, OBFUSCATED_PASSWORD
Modifier and Type | Method and Description |
---|---|
SimpleBindRequest |
addControl(Control control)
Adds the provided control to this request.
|
BindClient |
createBindClient(String serverName)
Creates a new bind client which can be used to perform the authentication
process.
|
byte |
getAuthenticationType()
Returns the authentication mechanism identifier for this simple bind
request as defined by the LDAP protocol, which is always
0x80 . |
<C extends Control> |
getControl(ControlDecoder<C> decoder,
DecodeOptions options)
Decodes and returns the first control in this request having an OID
corresponding to the provided control decoder.
|
List<Control> |
getControls()
Returns a
List containing the controls included with this
request. |
String |
getName()
Returns the name of the Directory object that the client wishes to bind
as.
|
byte[] |
getPassword()
Returns the password of the Directory object that the client wishes to
bind as.
|
SimpleBindRequest |
setName(String name)
Sets the name of the Directory object that the client wishes to bind as.
|
SimpleBindRequest |
setPassword(byte[] password)
Sets the password of the Directory object that the client wishes to bind
as.
|
SimpleBindRequest |
setPassword(char[] password)
Sets the password of the Directory object that the client wishes to bind
as.
|
containsControl
SimpleBindRequest addControl(Control control)
Request
addControl
in interface BindRequest
addControl
in interface Request
control
- The control to be added to this request.BindClient createBindClient(String serverName) throws LdapException
BindRequest
createBindClient
in interface BindRequest
serverName
- The non-null fully-qualified host name of the server to
authenticate to.LdapException
- If an error occurred while creating the bind client context.byte getAuthenticationType()
0x80
.getAuthenticationType
in interface BindRequest
<C extends Control> C getControl(ControlDecoder<C> decoder, DecodeOptions options) throws DecodeException
Request
getControl
in interface BindRequest
getControl
in interface Request
C
- The type of control to be decoded and returned.decoder
- The control decoder.options
- The set of decode options which should be used when decoding
the control.null
if the control is not
included with this request.DecodeException
- If the control could not be decoded because it was malformed
in some way (e.g. the control value was missing, or its
content could not be decoded).List<Control> getControls()
Request
List
containing the controls included with this
request. The returned List
may be modified if permitted by this
request.getControls
in interface BindRequest
getControls
in interface Request
List
containing the controls.String getName()
BindRequest
null
) when used for
anonymous binds, or when using SASL authentication. The server shall not
dereference any aliases in locating the named object.
The LDAP protocol defines the Bind name to be a distinguished name, however some LDAP implementations have relaxed this constraint and allow other identities to be used, such as the user's email address.
getName
in interface BindRequest
byte[] getPassword()
null
) when used for
of anonymous or unauthenticated binds.
Unless otherwise indicated, implementations will store a reference to the returned password byte array, allowing applications to overwrite the password after it has been used.
SimpleBindRequest setName(String name)
null
when used for of anonymous
binds, or when using SASL authentication. The server shall not
dereference any aliases in locating the named object.
The LDAP protocol defines the Bind name to be a distinguished name, however some LDAP implementations have relaxed this constraint and allow other identities to be used, such as the user's email address.
name
- The name of the Directory object that the client wishes to
bind as.UnsupportedOperationException
- If this bind request does not permit the distinguished name
to be set.NullPointerException
- If name
was null
.SimpleBindRequest setPassword(byte[] password)
null
) when used for of
anonymous or unauthenticated binds.
Unless otherwise indicated, implementations will store a reference to the provided password byte array, allowing applications to overwrite the password after it has been used.
password
- The password of the Directory object that the client wishes to
bind as, which may be empty.UnsupportedOperationException
- If this simple bind request does not permit the password to
be set.NullPointerException
- If password
was null
.SimpleBindRequest setPassword(char[] password)
null
) when used for of anonymous or
unauthenticated binds. Subsequent modifications to the password
array will not alter this bind request.password
- The password of the Directory object that the client wishes to
bind as, which may be empty.UnsupportedOperationException
- If this simple bind request does not permit the password to
be set.NullPointerException
- If password
was null
.Copyright 2010-2017 ForgeRock AS.