Oracle Fusion Middleware
Oracle WebLogic Server MBean Javadoc
12c Release 1 (12.1.1)

Part Number E24395-02

weblogic.management.security.authentication
Interface AuthenticatorMBean

All Superinterfaces:
AuthenticationProviderMBean, ProviderMBean
All Known Subinterfaces:
ActiveDirectoryAuthenticatorMBean, CustomDBMSAuthenticatorMBean, DBMSAuthenticatorMBean, DefaultAuthenticatorMBean, IPlanetAuthenticatorMBean, LDAPAuthenticatorMBean, LoginExceptionPropagatorMBean, NovellAuthenticatorMBean, OpenLDAPAuthenticatorMBean, OracleInternetDirectoryAuthenticatorMBean, OracleVirtualDirectoryAuthenticatorMBean, ReadOnlySQLAuthenticatorMBean, RealmAdapterAuthenticatorMBean, SAMLAuthenticatorMBean, SQLAuthenticatorMBean, WindowsNTAuthenticatorMBean

public interface AuthenticatorMBean
extends AuthenticationProviderMBean

The SSPI MBean that all Authentication providers with login services must extend. This MBean provides a ControlFlag to determine whether the Authentication provider is a REQUIRED, REQUISITE, SUFFICIENT, or OPTIONAL part of the login sequence.

Deprecation of MBeanHome and Type-Safe Interfaces

In addition to being used as a base class that provides functionality to security provider MBeans, JMX applications can use this class directly as a type-safe interface. When used as a type-safe interface, a JMX application imports this class and accesses it through weblogic.management.MBeanHome. As of 9.0, the MBeanHome interface and all type-safe interfaces for WebLogic Server MBeans are deprecated. Instead, JMX applications that interact with WebLogic Server MBeans should use standard JMX design patterns in which clients use the javax.management.MBeanServerConnection interface to discover MBeans, attributes, and attribute types at runtime.


Method Summary
 String getControlFlag()
          Returns how the login sequence uses the Authentication provider.
 void setControlFlag(String flag)
          Sets how the login sequence uses the Authentication provider.
 
Methods inherited from interface weblogic.management.security.ProviderMBean
getDescription, getName, getRealm, getVersion
 

Method Detail

getControlFlag

String getControlFlag()
Returns how the login sequence uses the Authentication provider.

A REQUIRED value specifies this LoginModule must succeed. Even if it fails, authentication proceeds down the list of LoginModules for the configured Authentication providers. This setting is the default.

A REQUISITE value specifies this LoginModule must succeed. If other Authentication providers are configured and this LoginModule succeeds, authentication proceeds down the list of LoginModules. Otherwise, control is return to the application.

A SUFFICIENT value specifies this LoginModule need not succeed. If it does succeed, return control to the application. If it fails and other Authentication providers are configured, authentication proceeds down the LoginModule list.

An OPTIONAL value specifies this LoginModule need not succeed. Whether it succeeds or fails, authentication proceeds down the LoginModule list.

Default Value:
"REQUIRED"
Valid Values:
"REQUIRED", "REQUISITE", "SUFFICIENT", "OPTIONAL"

setControlFlag

void setControlFlag(String flag)
                    throws InvalidAttributeValueException
Sets how the login sequence uses the Authentication provider.

A REQUIRED value specifies this LoginModule must succeed. Even if it fails, authentication proceeds down the list of LoginModules for the configured Authentication providers. This setting is the default.

A REQUISITE value specifies this LoginModule must succeed. If other Authentication providers are configured and this LoginModule succeeds, authentication proceeds down the list of LoginModules. Otherwise, control is return to the application.

A SUFFICIENT value specifies this LoginModule need not succeed. If it does succeed, return control to the application. If it fails and other Authentication providers are configured, authentication proceeds down the LoginModule list.

An OPTIONAL value specifies this LoginModule need not succeed. Whether it succeeds or fails, authentication proceeds down the LoginModule list.

Parameters:
flag - - the new control flag value
Throws:
InvalidAttributeValueException
See Also:
AuthenticatorMBean.getControlFlag()

Copyright 1996, 2011, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Oracle Fusion Middleware
Oracle WebLogic Server MBean Javadoc
12c Release 1 (12.1.1)

Part Number E24395-02