Class: Mongo::Auth::User

Inherits:
Object
  • Object
show all
Defined in:
lib/mongo/auth/user.rb,
lib/mongo/auth/user/view.rb

Overview

Represents a user in MongoDB.

Since:

  • 2.0.0

Defined Under Namespace

Classes: View

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options) ⇒ User

Create the new user.

Examples:

Create a new user.

Mongo::Auth::User.new(options)

Parameters:

  • options (Hash) —

    The options to create the user from.

Options Hash (options):

  • :auth_source (String) —

    The authorization database or external source.

  • :database (String) —

    The database the user is authorized for.

  • :user (String) —

    The user name.

  • :password (String) —

    The user’s password.

  • :auth_mech (Symbol) —

    The authorization mechanism.

  • roles (Array<String>, Array<Hash>) —

    The user roles.

  • :client_key (String) —

    The user’s client key cached from a previous authentication on the same connection.

Since:

  • 2.0.0



137
138
139
140
141
142
143
144
145
146
 
# File 'lib/mongo/auth/user.rb', line 137

def initialize(options)
  @database = options[:database] || Database::ADMIN
  @auth_source = options[:auth_source] || @database
  @name = options[:user]
  @password = options[:password] || options[:pwd]
  @mechanism = options[:auth_mech]
  @auth_mech_properties = options[:auth_mech_properties] || {}
  @roles = options[:roles] || []
  @client_key = options[:client_key]
end

Instance Attribute Details

#auth_mech_properties ⇒ Hash (readonly)

Returns The authentication mechanism properties.

Returns:

  • (Hash) —

    The authentication mechanism properties.

Since:

  • 2.0.0



33
34
35
 
# File 'lib/mongo/auth/user.rb', line 33

def auth_mech_properties
  @auth_mech_properties
end

#auth_source ⇒ String (readonly)

Returns The authorization source, either a database or external name.

Returns:

  • (String) —

    The authorization source, either a database or external name.

Since:

  • 2.0.0



27
28
29
 
# File 'lib/mongo/auth/user.rb', line 27

def auth_source
  @auth_source
end

#database ⇒ String (readonly)

Returns The database the user is created in.

Returns:

  • (String) —

    The database the user is created in.

Since:

  • 2.0.0



30
31
32
 
# File 'lib/mongo/auth/user.rb', line 30

def database
  @database
end

#mechanism ⇒ Symbol (readonly)

Returns The authorization mechanism.

Returns:

  • (Symbol) —

    The authorization mechanism.

Since:

  • 2.0.0



36
37
38
 
# File 'lib/mongo/auth/user.rb', line 36

def mechanism
  @mechanism
end

#name ⇒ String (readonly)

Returns The username.

Returns:

  • (String) —

    The username.

Since:

  • 2.0.0



39
40
41
 
# File 'lib/mongo/auth/user.rb', line 39

def name
  @name
end

#password ⇒ String (readonly)

Returns The cleartext password.

Returns:

  • (String) —

    The cleartext password.

Since:

  • 2.0.0



42
43
44
 
# File 'lib/mongo/auth/user.rb', line 42

def password
  @password
end

#roles ⇒ Array<String> (readonly)

Returns roles The user roles.

Returns:

  • (Array<String>) —

    roles The user roles.

Since:

  • 2.0.0



45
46
47
 
# File 'lib/mongo/auth/user.rb', line 45

def roles
  @roles
end

Instance Method Details

#==(other) ⇒ true, false

Determine if this user is equal to another.

Examples:

Check user equality.

user == other

Parameters:

  • other (Object) —

    The object to compare against.

Returns:

  • (true, false) —

    If the objects are equal.

Since:

  • 2.0.0



57
58
59
60
 
# File 'lib/mongo/auth/user.rb', line 57

def ==(other)
  return false unless other.is_a?(User)
  name == other.name && database == other.database && password == other.password
end

#auth_key(nonce) ⇒ String

Get an authentication key for the user based on a nonce from the server.

Examples:

Get the authentication key.

user.auth_key(nonce)

Parameters:

  • nonce (String) —

    The response from the server.

Returns:

  • (String) —

    The authentication key.

Since:

  • 2.0.0



73
74
75
 
# File 'lib/mongo/auth/user.rb', line 73

def auth_key(nonce)
  Digest::MD5.hexdigest("#{nonce}#{name}#{hashed_password}")
end

#encoded_name ⇒ String

Get the UTF-8 encoded name with escaped special characters for use with SCRAM authorization.

Examples:

Get the encoded name.

user.encoded_name

Returns:

  • (String) —

    The encoded user name.

Since:

  • 2.0.0



86
87
88
 
# File 'lib/mongo/auth/user.rb', line 86

def encoded_name
  name.encode(BSON::UTF8).gsub('=','=3D').gsub(',','=2C')
end

#hash ⇒ String

Get the hash key for the user.

Examples:

Get the hash key.

user.hash

Returns:

  • (String) —

    The user hash key.

Since:

  • 2.0.0



98
99
100
 
# File 'lib/mongo/auth/user.rb', line 98

def hash
  [ name, database, password ].hash
end

#hashed_password ⇒ String

Get the user’s hashed password.

Examples:

Get the user’s hashed password.

user.hashed_password

Returns:

  • (String) —

    The hashed password.

Since:

  • 2.0.0



110
111
112
 
# File 'lib/mongo/auth/user.rb', line 110

def hashed_password
  @hashed_password ||= Digest::MD5.hexdigest("#{name}:mongo:#{password}").encode(BSON::UTF8)
end

#sasl_prepped_hashed_password ⇒ Object

Since:

  • 2.0.0



114
115
116
 
# File 'lib/mongo/auth/user.rb', line 114

def sasl_prepped_hashed_password
  @sasl_prepped_hashed_password ||= sasl_prepped_password.encode(BSON::UTF8)
end

#spec ⇒ Hash

Get the specification for the user, used in creation.

Examples:

Get the user’s specification.

user.spec

Returns:

  • (Hash) —

    The user spec.

Since:

  • 2.0.0



156
157
158
 
# File 'lib/mongo/auth/user.rb', line 156

def spec
  { pwd: password, roles: roles }
end