/* * Copyright 2016 IgniteRealtime.org * * 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. */ package org.jivesoftware.openfire.user; import org.jivesoftware.openfire.admin.AdminManager; import org.jivesoftware.util.JiveGlobals; import java.util.SortedSet; import java.util.TreeSet; /** * A {@link UserProviderMapper} that can be used to draw administrative users from another source than the regular, non- * administrative users. * * This implementation uses {@link AdminManager} to determine if a particular user is an administrative user. When a * user is not recognized, it is deemed a regular, non-administrative user. * * To configure this provider, the both system properties from the example below <em>must</em> be defined. Their value * must reference the classname of an {@link UserProvider}. * * <ul> * <li><tt>authorizationBasedUserMapper.adminProvider.className = org.jivesoftware.openfire.auth.DefaultUserProvider</tt></li> * <li><tt>authorizationBasedUserMapper.userProvider.className = org.jivesoftware.openfire.auth.NativeUserProvider</tt></li> * </ul> * * @author Guus der Kinderen, guus@goodbytes.nl */ public class AuthorizationBasedUserProviderMapper implements UserProviderMapper { /** * Name of the property of which the value is expected to be the classname of the UserProvider which will serve the * administrative users. */ public static final String PROPERTY_ADMINPROVIDER_CLASSNAME = "authorizationBasedUserMapper.adminProvider.className"; /** * Name of the property of which the value is expected to be the classname of the UserProvider which will serve the * regular, non-administrative users. */ public static final String PROPERTY_USERPROVIDER_CLASSNAME = "authorizationBasedUserMapper.userProvider.className"; /** * Serves the administrative users. */ protected final UserProvider adminProvider; /** * Serves the regular, non-administrative users. */ protected final UserProvider userProvider; public AuthorizationBasedUserProviderMapper() { // Migrate properties. JiveGlobals.migrateProperty( PROPERTY_ADMINPROVIDER_CLASSNAME ); JiveGlobals.migrateProperty( PROPERTY_USERPROVIDER_CLASSNAME ); // Instantiate providers. adminProvider = UserMultiProvider.instantiate( PROPERTY_ADMINPROVIDER_CLASSNAME ); if ( adminProvider == null ) { throw new IllegalStateException( "A class name for the admin provider must be specified via openfire.xml or the system properties using property: " + PROPERTY_ADMINPROVIDER_CLASSNAME ); } userProvider = UserMultiProvider.instantiate( PROPERTY_USERPROVIDER_CLASSNAME ); if ( userProvider == null ) { throw new IllegalStateException( "A class name for the user provider must be specified via openfire.xml or the system properties using property: " + PROPERTY_USERPROVIDER_CLASSNAME ); } } @Override public UserProvider getUserProvider( String username ) { // TODO add optional caching, to prevent retrieving the administrative users upon every invocation. final boolean isAdmin = AdminManager.getAdminProvider().getAdmins().contains( username ); if ( isAdmin ) { return adminProvider; } else { return userProvider; } } @Override public SortedSet<UserProvider> getUserProviders() { final SortedSet<UserProvider> result = new TreeSet<>(); result.add( adminProvider ); result.add( userProvider ); return result; } }