class Mongo::Auth::X509::Conversation
Defines behaviour around a single x.509 conversation between the client and server.
@since 2.0.0
Constants
- LOGIN
The login message.
@since 2.0.0
Attributes
@return [ Protocol::Reply ] reply The current reply in the
conversation.
@return [ User ] user The user for the conversation.
Public Class Methods
Create the new conversation.
@example Create the new conversation.
Conversation.new(user, "admin")
@param [ Auth::User ] user The user to converse about.
@since 2.0.0
# File lib/mongo/auth/x509/conversation.rb, line 81 def initialize(user) @user = user end
Public Instance Methods
Finalize the x.509 conversation. This is meant to be iterated until the provided reply indicates the conversation is finished.
@example Finalize the conversation.
conversation.finalize(reply)
@param [ Protocol::Reply ] reply The reply of the previous
message.
@return [ Protocol::Query ] The next message to send.
@since 2.0.0
# File lib/mongo/auth/x509/conversation.rb, line 49 def finalize(reply) validate!(reply) end
Start the x.509 conversation. This returns the first message that needs to be send to the server.
@example Start the conversation.
conversation.start
@return [ Protocol::Query ] The first x.509 conversation message.
@since 2.0.0
# File lib/mongo/auth/x509/conversation.rb, line 62 def start login = LOGIN.merge(mechanism: X509::MECHANISM) login[:user] = user.name if user.name Protocol::Query.new( Auth::EXTERNAL, Database::COMMAND, login, limit: -1 ) end
Private Instance Methods
# File lib/mongo/auth/x509/conversation.rb, line 87 def validate!(reply) raise Unauthorized.new(user) if reply.documents[0][Operation::Result::OK] != 1 @reply = reply end