RegularExpressionIdentityMapper.java revision ea1068c292e9b341af6d6b563cd8988a96be20a9
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License, Version 1.0 only
* (the "License"). You may not use this file except in compliance
* with the License.
*
* You can obtain a copy of the license at legal-notices/CDDLv1_0.txt
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at legal-notices/CDDLv1_0.txt.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information:
* Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*
*
* Copyright 2008 Sun Microsystems, Inc.
* Portions Copyright 2014-2015 ForgeRock AS
*/
/**
* This class provides an implementation of a Directory Server identity mapper
* that uses a regular expression to process the provided ID string, and then
* looks for that processed value to appear in an attribute of a user's entry.
* This mapper may be configured to look in one or more attributes using zero or
* more search bases. In order for the mapping to be established properly,
* exactly one entry must have an attribute that exactly matches (according to
* the equality matching rule associated with that attribute) the processed ID
* value.
*/
public class RegularExpressionIdentityMapper
implements ConfigurationChangeListener<
{
// The set of attribute types to use when performing lookups.
private AttributeType[] attributeTypes;
// The DN of the configuration entry for this identity mapper.
private DN configEntryDN;
// The set of attributes to return in search result entries.
// The regular expression pattern matcher for the current configuration.
private Pattern matchPattern;
// The current configuration for this identity mapper.
// The replacement string to use for the pattern.
private String replacePattern;
/**
* Creates a new instance of this regular expression identity mapper. All
* initialization should be performed in the {@code initializeIdentityMapper}
* method.
*/
public RegularExpressionIdentityMapper()
{
super();
// Don't do any initialization here.
}
/**
* {@inheritDoc}
*/
public void initializeIdentityMapper(
{
try
{
}
catch (PatternSyntaxException pse) {
pse.getMessage());
}
if (replacePattern == null)
{
replacePattern = "";
}
// Get the attribute types to use for the searches. Ensure that they are
// all indexed for equality.
{
}
for (AttributeType t : attributeTypes)
{
{
{
}
}
}
// Create the attribute list to include in search requests. We want to
// include all user and operational attributes.
}
/**
* {@inheritDoc}
*/
public void finalizeIdentityMapper()
{
}
/**
* {@inheritDoc}
*/
throws DirectoryException
{
// Run the provided identifier string through the regular expression pattern
// matcher and make the appropriate replacement.
// Construct the search filter to use to make the determination.
{
}
else
{
for (AttributeType t : attributeTypes)
{
}
}
// Iterate through the set of search bases and process an internal search
// to find any matching entries. Since we'll only allow a single match,
// then use size and time limits to constrain costly searches resulting from
// non-unique or inefficient criteria.
{
}
{
.setSizeLimit(1)
.setTimeLimit(10)
{
case SUCCESS:
// This is fine. No action needed.
break;
case NO_SUCH_OBJECT:
// The search base doesn't exist. Not an ideal situation, but we'll
// ignore it.
break;
case SIZE_LIMIT_EXCEEDED:
// Multiple entries matched the filter. This is not acceptable.
throw new DirectoryException(
case TIME_LIMIT_EXCEEDED:
case ADMIN_LIMIT_EXCEEDED:
// The search criteria was too inefficient.
default:
// Just pass on the failure that was returned for this search.
}
{
if (matchingEntry == null)
{
{
}
}
else
{
}
}
}
return matchingEntry;
}
/**
* {@inheritDoc}
*/
{
}
/**
* {@inheritDoc}
*/
public boolean isConfigurationChangeAcceptable(
{
boolean configAcceptable = true;
// Make sure that all of the configured attributes are indexed for equality
// in all appropriate backends.
{
}
{
{
{
configAcceptable = false;
}
}
}
// Make sure that we can parse the match pattern.
try
{
}
catch (PatternSyntaxException pse)
{
configAcceptable = false;
}
return configAcceptable;
}
/**
* {@inheritDoc}
*/
{
try
{
}
catch (PatternSyntaxException pse)
{
ccr.addMessage(ERR_REGEXMAP_INVALID_MATCH_PATTERN.get(configuration.getMatchPattern(), pse.getMessage()));
}
if (newReplacePattern == null)
{
newReplacePattern = "";
}
{
}
return ccr;
}
}