Skip navigation links

oracle.security.am.plugin
Interface GenericPluginService

All Known Subinterfaces:

AuthnPluginService, PluginExecutionStrategy

All Known Implementing Classes:

AbstractAMPlugin, AbstractAuthenticationPlugIn, AbstractPluginExecutionStrategy, oracle.security.am.plugin.authn.OAMAbstractAuthenticationPlugIn

public interface GenericPluginService

The GenericPluginService class.

Since:

OAM 11.1.1.5.0

Version:

OAM 11.1.2.0.0

Nested Class Summary

static class

GenericPluginService.QueryKey

Method Summary

java.lang.String	getDescription() Deprecated. This method will be removed in future releases. Description of the plug-in. This value will be displayed in the UI when the user selects an plug-in to assign to an plugin point.
java.lang.String	getID() returns the unique ID of the plug-in.
java.util.logging.Logger	getLogger() returns the logger configured for the plug-in.
long	getMaxWaitIntervel() returns the max wait interval in milliseconds.
java.util.Map<java.lang.String,MonitoringData>	getMonitoringData() plug-in can return monitoring data after plug-in execution is complete.
boolean	getMonitoringStatus() set the monitoring status for the plug-in.
PluginConfig	getPluginConfig() Gets the plugin config.
java.lang.String	getPluginName() Deprecated. This method will be removed in future releases. Name will be an identifier for the plug-in. User can use the name and version of the plug-in in plug-in UI to identify the plug-in user want to use.
int	getRevision() Deprecated. This method will be removed in future releases. Returns back the plug-in revision. Items required for plug-in management. Revision should be an integer value. Plugin developers can keep track of multiple revisions of the plugin. The plugin development framework will take care of maintaining version.
ExecutionStatus	initialize(PluginConfig config) The function initializes the Plug-in.
boolean	poweronSelfTest() Plug-ins need to override this method to the self test when the plug-ins are loaded.
void	setMonitoringStatus(boolean status) Deprecated. This method will be removed in future releases. get the monitoring status configured for the plugin.
ExecutionStatus	shutdown(java.util.Map<java.lang.String,java.io.Serializable> AMEnvironmentContext) Shutdown method will be called when the plug-in instance is destroyed or removed from the instance pool.

Method Detail

initialize

ExecutionStatus initialize(PluginConfig config)

The function initializes the Plug-in. This will be called to pass the global plug-in configurations during plug-in instance initialization. Plug-ins that want to do some processing with the plug-in configurations can override this method. Plug-in executor may maintain a pool of plug-in objects and initialize these objects on need basis.

Parameters:

AMEnvironmentContext - the aM environment context

Returns:

the execution status

shutdown

ExecutionStatus shutdown(java.util.Map<java.lang.String,java.io.Serializable> AMEnvironmentContext)

Shutdown method will be called when the plug-in instance is destroyed or removed from the instance pool.

Parameters:

AMEnvironmentContext - the aM environment context

Returns:

the execution status

getRevision

int getRevision()

Deprecated. This method will be removed in future releases.
Returns back the plug-in revision. Items required for plug-in management. Revision should be an integer value. Plugin developers can keep track of multiple revisions of the plugin. The plugin development framework will take care of maintaining version.

Returns:

the revision

getPluginName

java.lang.String getPluginName()

Deprecated. This method will be removed in future releases.
Name will be an identifier for the plug-in. User can use the name and version of the plug-in in plug-in UI to identify the plug-in user want to use.

Returns:

String name of the plug-in.

getID

java.lang.String getID()

returns the unique ID of the plug-in.

Returns:

the iD

getDescription

java.lang.String getDescription()

Deprecated. This method will be removed in future releases.
Description of the plug-in. This value will be displayed in the UI when the user selects an plug-in to assign to an plugin point.

Returns:

the description

getLogger

java.util.logging.Logger getLogger()

returns the logger configured for the plug-in.

Returns:

the logger

getPluginConfig

PluginConfig getPluginConfig()

Gets the plugin config.

Returns:

a PluginConfig object that contains the plug-in configuration data.

getMaxWaitIntervel

long getMaxWaitIntervel()

returns the max wait interval in milliseconds. this the max time the Authentication Engine will wiat for the plugin response.

Returns:

the max wait intervel

setMonitoringStatus

void setMonitoringStatus(boolean status)

Deprecated. This method will be removed in future releases.
get the monitoring status configured for the plugin.

Parameters:

status - the new monitoring status

getMonitoringStatus

boolean getMonitoringStatus()

set the monitoring status for the plug-in.

Returns:

the monitoring status

getMonitoringData

java.util.Map<java.lang.String,MonitoringData> getMonitoringData()

plug-in can return monitoring data after plug-in execution is complete. Server will log this data.

Returns:

the monitoring data

poweronSelfTest

boolean poweronSelfTest()

Plug-ins need to override this method to the self test when the plug-ins are loaded. poweronSelfTest will be called by the framework after the plug-in is loaded to check if the plug-in has all the dependencies satisfied and ready to service.

Returns:

Skip navigation links