org.efaps.jaas.ImportHandler Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of efaps-kernel Show documentation
Show all versions of efaps-kernel Show documentation
eFaps is a framework used to map objects with or without attached files to
a relational database and optional file systems (only for attaches files). Configurable access control can be provided down to object and attribute level depending on implementation and use case. Depending on requirements, events (like triggers) allow to implement business logic and to separate business logic from user interface.
The framework includes integrations (e.g. webdav, full text search) and a web application as 'simple' configurable user interface. Some best practises, example web application modules (e.g. team work module) support administrators and implementers using this framework.
/*
* Copyright 2003 - 2011 The eFaps Team
*
* 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.
*
* Revision: $Rev: 6210 $
* Last Changed: $Date: 2011-02-18 16:02:56 -0500 (Fri, 18 Feb 2011) $
* Last Changed By: $Author: [email protected] $
*/
package org.efaps.jaas;
import java.lang.reflect.InvocationTargetException;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Map;
import java.util.Set;
import javax.security.auth.login.LoginContext;
import javax.security.auth.login.LoginException;
import org.efaps.admin.user.JAASSystem;
import org.efaps.admin.user.Person;
import org.efaps.util.EFapsException;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
* The class is used to import from all JAAS system the user into eFaps so that
* all users which could authentificate them self outside eFaps are known inside
* eFaps (e.g. to assign them for access or to send then an email).
To
* start an import, the class must be instantiated and method
* {@link #importPersons} must be called.
*
* @author The eFaps Team
* @version $Id: ImportHandler.java 6210 2011-02-18 21:02:56Z [email protected] $
*/
public class ImportHandler
extends LoginHandler
{
/**
* Logging instance used to give logging information of this class.
*/
private static final Logger LOG = LoggerFactory.getLogger(ImportHandler.class);
/**
* All person mapper instances are stored in this instance variable.
*/
private final Set persMappers = new HashSet();
/**
* Map the person mapper instances to the user name of the persons.
*/
private final Map name2persMapper = new HashMap();
/**
* Map the person mapper instances to the eFaps person instances.
*/
private final Map pers2persMapper = new HashMap();
/**
* Constructor to initialize the login handler. If null is given to
* the application name, the default value defined in {@link #application}
* is used.
*
* @param _application application name of the JAAS configuration
*/
public ImportHandler(final String _application)
{
super(_application);
}
/**
* The method calls first method {@link #readPersons} to read all persons
* in the cache. Then all found persons are updated with the information
* from.
*
* @see #readPersons()
* @see #updatePersons()
*/
public void importPersons()
{
readPersons();
updatePersons();
}
/**
* The algorithm for identification of persons with specified key and name in
* a JAAS system is:
*
* - search person by key in eFaps
* - if not found search person by name in eFaps
*
* If no person inside eFaps is found, search if another JAAS system
* identifies a person with the same name!
If an exception is thrown
* inside called methods, the exceptions are only written to the log as
* errors.
*/
protected void readPersons()
{
try {
final LoginContext login = new LoginContext(
getApplicationName(),
new LoginCallbackHandler(ActionCallback.Mode.ALL_PERSONS, null, null));
login.login();
for (final JAASSystem system : JAASSystem.getAllJAASSystems()) {
if (ImportHandler.LOG.isDebugEnabled()) {
ImportHandler.LOG.debug("check JAAS system '" + system + "'");
}
final Set users = login.getSubject().getPrincipals(system.getPersonJAASPrincipleClass());
for (final Object persObj : users) {
if (ImportHandler.LOG.isDebugEnabled()) {
ImportHandler.LOG.debug("- check person '" + persObj + "'");
}
try {
final String persKey = (String) system.getPersonMethodKey().invoke(persObj, (Object) null);
final String persName = (String) system.getPersonMethodName().invoke(persObj, (Object) null);
PersonMapper persMapper = null;
Person foundPerson = Person.getWithJAASKey(system, persKey);
if (foundPerson == null) {
foundPerson = Person.get(persName);
}
if (foundPerson == null) {
persMapper = this.name2persMapper.get(persName);
} else {
persMapper = this.pers2persMapper.get(foundPerson);
if (persMapper == null) {
persMapper = this.name2persMapper.get(persName);
}
}
if (persMapper == null) {
persMapper = new PersonMapper(foundPerson, persName);
}
persMapper.addJAASSystem(system, persKey);
} catch (final EFapsException e) {
ImportHandler.LOG.error("could not search for person with JAAS key " + system.getName(), e);
} catch (final IllegalAccessException e) {
ImportHandler.LOG.error("could not execute person key method for system "
+ system.getName(), e);
} catch (final IllegalArgumentException e) {
ImportHandler.LOG.error("could not execute person key method for system "
+ system.getName(), e);
} catch (final InvocationTargetException e) {
ImportHandler.LOG.error("could not execute person key method for system "
+ system.getName(), e);
}
}
}
} catch (final LoginException e) {
ImportHandler.LOG.error("could not create login context", e);
}
}
/**
* Each found person is updated in eFaps (or created if not already
* existing). The methods from the login handler {@link LoginHandler} are
* used for the update.
* Each user name is written as debug information to the log file.
* If an exception is thrown inside called methods, the exceptions
* are only written to the log as errors.
*
* @see LoginHandler#getPerson(LoginContext)
* @see LoginHandler#createPerson(LoginContext)
* @see LoginHandler#updatePerson(LoginContext, Person)
* @see LoginHandler#updateRoles(LoginContext, Person)
* @see LoginHandler#updateGroups(LoginContext, Person)
*/
protected void updatePersons()
{
for (final PersonMapper persMapper : this.persMappers) {
if (ImportHandler.LOG.isDebugEnabled()) {
ImportHandler.LOG.debug("update person '" + persMapper.name + "'");
}
try {
final LoginContext login =
new LoginContext(getApplicationName(), new LoginCallbackHandler(
ActionCallback.Mode.PERSON_INFORMATION, persMapper.name, null));
login.login();
Person person = getPerson(login);
if (person == null) {
person = createPerson(login);
}
if (person != null) {
updatePerson(login, person);
person.cleanUp();
updateRoles(login, person);
updateGroups(login, person);
}
} catch (final EFapsException e) {
ImportHandler.LOG.error("update failed for '" + persMapper.name + "'", e);
} catch (final LoginException e) {
ImportHandler.LOG.error("update failed for '" + persMapper.name + "'", e);
}
}
}
/**
* Person mapper class.
*/
private final class PersonMapper
{
/**
* eFaps Person instance.
*/
private final Person person;
/**
* User Name of the person.
*/
private final String name;
/**
* Mapping of the key for the keys.
*/
private final Map keys = new HashMap();
/**
* If a new person mapper object is instantiated, the mapping for names
* to person mapper in {@link #name2persMapper} and the mapping for
* persons to person mapper in {@link #pers2persMapper} are updated.
* The new instance is added to the list of all person mappers in
* {@link #persMappers}.
*
* @param _person JAVA person instance (if already existing in eFaps)
* @param _name name of the person
*/
private PersonMapper(final Person _person,
final String _name)
{
this.person = _person;
this.name = _name;
ImportHandler.this.name2persMapper.put(this.name, this);
if (this.person != null) {
ImportHandler.this.pers2persMapper.put(this.person, this);
}
ImportHandler.this.persMappers.add(this);
}
/**
* A new key of the person for the JAAS system is defined for the
* person.
*
* @param _jaasSystem JAAS system in which the person is defined
* @param _key key of the person in the given JAAS system
*/
private void addJAASSystem(final JAASSystem _jaasSystem,
final String _key)
{
this.keys.put(_jaasSystem, _key);
}
}
}