org.apache.jackrabbit.oak.spi.security.authentication.external.impl

Class DefaultSyncHandler

java.lang.Object

org.apache.jackrabbit.oak.spi.security.authentication.external.impl.DefaultSyncHandler

All Implemented Interfaces:

SyncHandler

@Service
public class DefaultSyncHandler
extends Object
implements SyncHandler

DefaultSyncHandler implements an sync handler that synchronizes users and groups from an external identity provider with the repository users.

Please refer to DefaultSyncConfigImpl for configuration options.

Constructor Summary

Constructors

Constructor and Description
DefaultSyncHandler() Default constructor for OSGi
DefaultSyncHandler(DefaultSyncConfig config) Constructor for non-OSGi cases.

Method Summary

Modifier and Type	Method and Description
@NotNull SyncContext	createContext(@NotNull ExternalIdentityProvider idp, @NotNull UserManager userManager, @NotNull ValueFactory valueFactory) Initializes a sync context which is used to start the sync operations.
SyncedIdentity	findIdentity(@NotNull UserManager userManager, @NotNull String id) Tries to find the identity with the given authorizable id or name.
@NotNull String	getName() Returns the name of this sync handler.
@NotNull Iterator<SyncedIdentity>	listIdentities(@NotNull UserManager userManager) Lists all externally synced identities.
boolean	requiresSync(@NotNull SyncedIdentity identity) Checks if the identity requires sync based on the configuration, type and last sync time.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultSyncHandler

public DefaultSyncHandler()

Default constructor for OSGi

DefaultSyncHandler

public DefaultSyncHandler(DefaultSyncConfig config)

Constructor for non-OSGi cases.

Parameters:

config - the configuration

Method Detail

getName

@NotNull
public @NotNull String getName()

Returns the name of this sync handler.

Specified by:

getName in interface SyncHandler

Returns:

sync handler name

createContext

@NotNull
public @NotNull SyncContext createContext(@NotNull
                                                   @NotNull ExternalIdentityProvider idp,
                                                   @NotNull
                                                   @NotNull UserManager userManager,
                                                   @NotNull
                                                   @NotNull ValueFactory valueFactory)
                                            throws SyncException

Initializes a sync context which is used to start the sync operations.

Specified by:

createContext in interface SyncHandler

Parameters:

idp - the external identity provider used for syncing

userManager - user manager for managing authorizables

valueFactory - the value factory to create values

Returns:

the sync context

Throws:

SyncException - if an error occurs

findIdentity

public SyncedIdentity findIdentity(@NotNull
                                   @NotNull UserManager userManager,
                                   @NotNull
                                   @NotNull String id)
                            throws RepositoryException

Tries to find the identity with the given authorizable id or name.

Specified by:

findIdentity in interface SyncHandler

Parameters:

userManager - the user manager

id - the id or name of the authorizable

Returns:

a synced identity object or null

Throws:

RepositoryException - if an error occurs

requiresSync

public boolean requiresSync(@NotNull
                            @NotNull SyncedIdentity identity)

Checks if the identity requires sync based on the configuration, type and last sync time.

Specified by:

requiresSync in interface SyncHandler

Parameters:

identity - the identity to check

Returns:

true if the identity requires synchronization.

listIdentities

@NotNull
public @NotNull Iterator<SyncedIdentity> listIdentities(@NotNull
                                                                 @NotNull UserManager userManager)
                                                          throws RepositoryException

Lists all externally synced identities.

Specified by:

listIdentities in interface SyncHandler

Parameters:

userManager - the user manager

Returns:

an iterator over all authorizable that are externally synced.

Throws:

RepositoryException - if an error occurs