com.mongodb

Class MongoCredential

java.lang.Object

com.mongodb.MongoCredential

@Immutable
public final class MongoCredential
extends Object

Represents credentials to authenticate to a mongo server, as well as the source of the credentials and the authentication mechanism to use.

Since:

2.11.0

Field Summary

Fields

Modifier and Type	Field and Description
static String	GSSAPI_MECHANISM The GSSAPI mechanism.
static String	MONGODB_CR_MECHANISM The MongoDB Challenge Response mechanism.
static String	MONGODB_X509_MECHANISM The MongoDB X.509
static String	PLAIN_MECHANISM The PLAIN mechanism.

Method Summary

Methods

Modifier and Type	Method and Description
static MongoCredential	createGSSAPICredential(String userName) Creates a MongoCredential instance for the GSSAPI SASL mechanism.
static MongoCredential	createMongoCRCredential(String userName, String database, char[] password) Creates a MongoCredential instance for the MongoDB Challenge Response protocol.
static MongoCredential	createMongoX509Credential(String userName) Creates a MongoCredential instance for the MongoDB X.509 protocol.
static MongoCredential	createPlainCredential(String userName, String source, char[] password) Creates a MongoCredential instance for the PLAIN SASL mechanism.
boolean	equals(Object o)
String	getMechanism() Gets the mechanism
<T> T	getMechanismProperty(String key, T defaultValue) Get the value of the given key to a mechanism property, or defaultValue if there is no mapping.
char[]	getPassword() Gets the password.
String	getSource() Gets the source of the user name, typically the name of the database where the user is defined.
String	getUserName() Gets the user name
int	hashCode()
String	toString()
<T> MongoCredential	withMechanismProperty(String key, T value) Creates a new MongoCredential as a copy of this instance, with the specified mechanism property added.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

MONGODB_CR_MECHANISM

public static final String MONGODB_CR_MECHANISM

The MongoDB Challenge Response mechanism.

See Also:

Constant Field Values

GSSAPI_MECHANISM

public static final String GSSAPI_MECHANISM

The GSSAPI mechanism. See the RFC.

See Also:

Constant Field Values

Since server release

2.4

PLAIN_MECHANISM

public static final String PLAIN_MECHANISM

The PLAIN mechanism. See the RFC.

See Also:

Constant Field Values

Since server release

2.6

MONGODB_X509_MECHANISM

public static final String MONGODB_X509_MECHANISM

The MongoDB X.509

See Also:

Constant Field Values

Since server release

2.6

Method Detail

createMongoCRCredential

public static MongoCredential createMongoCRCredential(String userName,
                                      String database,
                                      char[] password)

Creates a MongoCredential instance for the MongoDB Challenge Response protocol.

Parameters:

userName - the user name

database - the database where the user is defined

password - the user's password

Returns:

the credential

createGSSAPICredential

public static MongoCredential createGSSAPICredential(String userName)

Creates a MongoCredential instance for the GSSAPI SASL mechanism. To override the default service name of "mongodb", add a mechanism property with the name "SERVICE_NAME". To force canonicalization of the host name prior to authentication, add a mechanism property with the name "CANONICALIZE_HOST_NAME" with the valuetrue.

Parameters:

userName - the user name

Returns:

the credential

See Also:

withMechanismProperty(String, Object)

Since server release

2.4

createMongoX509Credential

public static MongoCredential createMongoX509Credential(String userName)

Creates a MongoCredential instance for the MongoDB X.509 protocol.

Parameters:

userName - the user name

Returns:

the credential

Since server release

2.6

createPlainCredential

public static MongoCredential createPlainCredential(String userName,
                                    String source,
                                    char[] password)

Creates a MongoCredential instance for the PLAIN SASL mechanism.

Parameters:

userName - the non-null user name

source - the source where the user is defined. This can be either "$external" or the name of a database.

password - the non-null user password

Returns:

the credential

Since server release

2.6

withMechanismProperty

public <T> MongoCredential withMechanismProperty(String key,
                                        T value)

Creates a new MongoCredential as a copy of this instance, with the specified mechanism property added.

Type Parameters:

T - the property type

Parameters:

key - the key to the property

value - the value of the property

Returns:

the credential

getMechanism

public String getMechanism()

Gets the mechanism

Returns:

the mechanism.

getUserName

public String getUserName()

Gets the user name

Returns:

the user name. Can never be null.

getSource

public String getSource()

Gets the source of the user name, typically the name of the database where the user is defined.

Returns:

the user name. Can never be null.

getPassword

public char[] getPassword()

Gets the password.

Returns:

the password. Can be null for some mechanisms.

getMechanismProperty

public <T> T getMechanismProperty(String key,
                         T defaultValue)

Get the value of the given key to a mechanism property, or defaultValue if there is no mapping.

Type Parameters:

T - the value type

Parameters:

key - the mechanism property key

defaultValue - the default value, if no mapping exists

Returns:

the mechanism property value

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object