# Copyright (C) 2014 MongoDB Inc. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. module Mongo module Auth class CR # Defines behaviour around a single MONGODB-CR conversation between the # client and server. # # @since 2.0.0 class Conversation # The login message base. # # @since 2.0.0 LOGIN = { authenticate: 1 }.freeze # @return [ Protocol::Reply ] reply The current reply in the # conversation. attr_reader :reply # @return [ String ] database The database to authenticate against. attr_reader :database # @return [ String ] nonce The initial auth nonce. attr_reader :nonce # @return [ User ] user The user for the conversation. attr_reader :user # Continue the CR conversation. This sends the client final message # to the server after setting the reply from the previous server # communication. # # @example Continue the conversation. # conversation.continue(reply) # # @param [ Protocol::Reply ] reply The reply of the previous # message. # # @return [ Protocol::Query ] The next message to send. # # @since 2.0.0 def continue(reply) validate!(reply) Protocol::Query.new( user.auth_source, Database::COMMAND, LOGIN.merge(user: user.name, nonce: nonce, key: user.auth_key(nonce)), limit: -1 ) end # Finalize the CR 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 def finalize(reply) validate!(reply) end # Start the CR 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 CR conversation message. # # @since 2.0.0 def start Protocol::Query.new( user.auth_source, Database::COMMAND, Auth::GET_NONCE, limit: -1) end # Create the new conversation. # # @example Create the new coversation. # Conversation.new(user, "admin") # # @param [ Auth::User ] user The user to converse about. # @param [ String ] database The database to authenticate against. # # @since 2.0.0 def initialize(user) @user = user end private def validate!(reply) raise Unauthorized.new(user) if reply.documents[0]['ok'] != 1 @nonce = reply.documents[0][Auth::NONCE] @reply = reply end end end end end