Package org.apache.jackrabbit.oak.spi.security.user

Interface UserConfiguration

All Superinterfaces:

SecurityConfiguration

All Known Implementing Classes:

UserConfigurationImpl

public interface UserConfiguration
extends SecurityConfiguration

Configuration interface for user management.

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.jackrabbit.oak.spi.security.SecurityConfiguration

SecurityConfiguration.Default

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	NAME

Method Summary

Modifier and Type	Method	Description
@NotNull UserManager	getUserManager(Root root, NamePathMapper namePathMapper)	Create a new UserManager instance
@Nullable PrincipalProvider	getUserPrincipalProvider(@NotNull Root root, @NotNull NamePathMapper namePathMapper)	Optional method that allows a given user management implementation to provide a specific and optimized implementation of the PrincipalProvider interface for the principals represented by the user/groups known to this implementation.

Methods inherited from interface org.apache.jackrabbit.oak.spi.security.SecurityConfiguration

getCommitHooks, getConflictHandlers, getContext, getMonitors, getName, getParameters, getProtectedItemImporters, getRepositoryInitializer, getValidators, getWorkspaceInitializer

Field Detail

NAME

static final java.lang.String NAME

See Also:

Constant Field Values

Method Detail

getUserManager

@NotNull
@NotNull UserManager getUserManager(Root root,
                                    NamePathMapper namePathMapper)

Create a new UserManager instance

Parameters:

root - The root associated with the user manager.

namePathMapper - A name path mapper used for conversion of jcr/oak names/paths.

Returns:

a new instance of UserManager

getUserPrincipalProvider

@Nullable
@Nullable PrincipalProvider getUserPrincipalProvider(@NotNull
                                                     @NotNull Root root,
                                                     @NotNull
                                                     @NotNull NamePathMapper namePathMapper)

Optional method that allows a given user management implementation to provide a specific and optimized implementation of the PrincipalProvider interface for the principals represented by the user/groups known to this implementation. If this method returns null the security setup will by default use a basic PrincipalProvider implementation based on public user management API or a combination of other PrincipalProviders as configured with the repository setup.

Parameters:

root - The root used to read the principal information from.

namePathMapper - The NamePathMapper to convert oak paths to JCR paths.

Returns:

An implementation of PrincipalProvider or null if principal discovery is provided by other means of if the default principal provider implementation should be used that acts on public user management API.

See Also:

PrincipalConfiguration