module Devise module LDAP class Connection attr_reader :ldap, :login def initialize(params = {}) if ::Devise.ldap_config.is_a?(Proc) ldap_config = ::Devise.ldap_config.call else ldap_config = YAML.load(ERB.new(File.read(::Devise.ldap_config || "#{Rails.root}/config/ldap.yml")).result)[Rails.env] end ldap_options = params # Allow `ssl: true` shorthand in YAML, but enable more control with `encryption` ldap_config["ssl"] = :simple_tls if ldap_config["ssl"] === true ldap_options[:encryption] = ldap_config["ssl"].to_sym if ldap_config["ssl"] ldap_options[:encryption] = ldap_config["encryption"] if ldap_config["encryption"] @ldap = Net::LDAP.new(ldap_options) @ldap.host = ldap_config["host"] @ldap.port = ldap_config["port"] @ldap.base = ldap_config["base"] @attribute = ldap_config["attribute"] @allow_unauthenticated_bind = ldap_config["allow_unauthenticated_bind"] @ldap_auth_username_builder = params[:ldap_auth_username_builder] @group_base = ldap_config["group_base"] @check_group_membership = ldap_config.has_key?("check_group_membership") ? ldap_config["check_group_membership"] : ::Devise.ldap_check_group_membership @check_group_membership_without_admin = ldap_config.has_key?("check_group_membership_without_admin") ? ldap_config["check_group_membership_without_admin"] : ::Devise.ldap_check_group_membership_without_admin @required_groups = ldap_config["required_groups"] @group_membership_attribute = ldap_config.has_key?("group_membership_attribute") ? ldap_config["group_membership_attribute"] : "uniqueMember" @required_attributes = ldap_config["require_attribute"] @required_attributes_presence = ldap_config["require_attribute_presence"] @ldap.auth ldap_config["admin_user"], ldap_config["admin_password"] if params[:admin] @login = params[:login] @password = params[:password] @new_password = params[:new_password] end def delete_param(param) update_ldap [[:delete, param.to_sym, nil]] end def set_param(param, new_value) update_ldap( { param.to_sym => new_value } ) end def dn @dn ||= begin DeviseLdapAuthenticatable::Logger.send("LDAP dn lookup: #{@attribute}=#{@login}") ldap_entry = search_for_login if ldap_entry.nil? @ldap_auth_username_builder.call(@attribute,@login,@ldap) else ldap_entry.dn end end end def ldap_param_value(param) ldap_entry = search_for_login if ldap_entry unless ldap_entry[param].empty? value = ldap_entry.send(param) DeviseLdapAuthenticatable::Logger.send("Requested param #{param} has value #{value}") value else DeviseLdapAuthenticatable::Logger.send("Requested param #{param} does not exist") value = nil end else DeviseLdapAuthenticatable::Logger.send("Requested ldap entry does not exist") value = nil end end def authenticate! return false unless (@password.present? || @allow_unauthenticated_bind) @ldap.auth(dn, @password) @ldap.bind end def authenticated? authenticate! end def last_message_bad_credentials? @ldap.get_operation_result.error_message.to_s.include? 'AcceptSecurityContext error, data 52e' end def last_message_expired_credentials? @ldap.get_operation_result.error_message.to_s.include? 'AcceptSecurityContext error, data 773' end def authorized? DeviseLdapAuthenticatable::Logger.send("Authorizing user #{dn}") if !authenticated? if last_message_bad_credentials? DeviseLdapAuthenticatable::Logger.send("Not authorized because of invalid credentials.") elsif last_message_expired_credentials? DeviseLdapAuthenticatable::Logger.send("Not authorized because of expired credentials.") else DeviseLdapAuthenticatable::Logger.send("Not authorized because not authenticated.") end return false elsif !in_required_groups? DeviseLdapAuthenticatable::Logger.send("Not authorized because not in required groups.") return false elsif !has_required_attribute? DeviseLdapAuthenticatable::Logger.send("Not authorized because does not have required attribute.") return false elsif !has_required_attribute_presence? DeviseLdapAuthenticatable::Logger.send("Not authorized because does not have required attribute present.") return false else return true end end def expired_valid_credentials? DeviseLdapAuthenticatable::Logger.send("Authorizing user #{dn}") !authenticated? && last_message_expired_credentials? end def change_password! update_ldap(:userPassword => ::Devise.ldap_auth_password_builder.call(@new_password)) end def in_required_groups? return true unless @check_group_membership || @check_group_membership_without_admin ## FIXME set errors here, the ldap.yml isn't set properly. return false if @required_groups.nil? for group in @required_groups if group.is_a?(Array) return false unless in_group?(group[1], group[0]) else return false unless in_group?(group) end end return true end def in_group?(group_name, group_attribute = LDAP::DEFAULT_GROUP_UNIQUE_MEMBER_LIST_KEY) in_group = false if @check_group_membership_without_admin group_checking_ldap = @ldap else group_checking_ldap = Connection.admin end unless ::Devise.ldap_ad_group_check group_checking_ldap.search(:base => group_name, :scope => Net::LDAP::SearchScope_BaseObject) do |entry| if entry[group_attribute].include? dn in_group = true DeviseLdapAuthenticatable::Logger.send("User #{dn} IS included in group: #{group_name}") end end else # AD optimization - extension will recursively check sub-groups with one query # "(memberof:1.2.840.113556.1.4.1941:=group_name)" search_result = group_checking_ldap.search(:base => dn, :filter => Net::LDAP::Filter.ex("memberof:1.2.840.113556.1.4.1941", group_name), :scope => Net::LDAP::SearchScope_BaseObject) # Will return the user entry if belongs to group otherwise nothing if search_result.length == 1 && search_result[0].dn.eql?(dn) in_group = true DeviseLdapAuthenticatable::Logger.send("User #{dn} IS included in group: #{group_name}") end end unless in_group DeviseLdapAuthenticatable::Logger.send("User #{dn} is not in group: #{group_name}") end return in_group end def has_required_attribute? return true unless ::Devise.ldap_check_attributes admin_ldap = Connection.admin user = find_ldap_user(admin_ldap) @required_attributes.each do |key,val| matching_attributes = user[key] & Array(val) unless (matching_attributes).any? DeviseLdapAuthenticatable::Logger.send("User #{dn} did not match attribute #{key}:#{val}") return false end end return true end def has_required_attribute_presence? return true unless ::Devise.ldap_check_attributes_presence user = search_for_login @required_attributes_presence.each do |key,val| if val && !user.attribute_names.include?(key.to_sym) DeviseLdapAuthenticatable::Logger.send("User #{dn} doesn't include attribute #{key}") return false elsif !val && user.attribute_names.include?(key.to_sym) DeviseLdapAuthenticatable::Logger.send("User #{dn} includes attribute #{key}") return false end end return true end def user_groups admin_ldap = Connection.admin DeviseLdapAuthenticatable::Logger.send("Getting groups for #{dn}") filter = Net::LDAP::Filter.eq(@group_membership_attribute, dn) admin_ldap.search(:filter => filter, :base => @group_base).collect(&:dn) end def valid_login? !search_for_login.nil? end # Searches the LDAP for the login # # @return [Object] the LDAP entry found; nil if not found def search_for_login @login_ldap_entry ||= begin DeviseLdapAuthenticatable::Logger.send("LDAP search for login: #{@attribute}=#{@login}") filter = Net::LDAP::Filter.eq(@attribute.to_s, @login.to_s) ldap_entry = nil match_count = 0 @ldap.search(:filter => filter) {|entry| ldap_entry = entry; match_count+=1} op_result= @ldap.get_operation_result if op_result.code!=0 then DeviseLdapAuthenticatable::Logger.send("LDAP Error #{op_result.code}: #{op_result.message}") end DeviseLdapAuthenticatable::Logger.send("LDAP search yielded #{match_count} matches") ldap_entry end end private def self.admin ldap = Connection.new(:admin => true).ldap unless ldap.bind DeviseLdapAuthenticatable::Logger.send("Cannot bind to admin LDAP user") raise DeviseLdapAuthenticatable::LdapException, "Cannot connect to admin LDAP user" end return ldap end def find_ldap_user(ldap) DeviseLdapAuthenticatable::Logger.send("Finding user: #{dn}") ldap.search(:base => dn, :scope => Net::LDAP::SearchScope_BaseObject).try(:first) end def update_ldap(ops) operations = [] if ops.is_a? Hash ops.each do |key,value| operations << [:replace,key,value] end elsif ops.is_a? Array operations = ops end if ::Devise.ldap_use_admin_to_bind privileged_ldap = Connection.admin else authenticate! privileged_ldap = self.ldap end DeviseLdapAuthenticatable::Logger.send("Modifying user #{dn}") privileged_ldap.modify(:dn => dn, :operations => operations) end end end end