ConfigurationMBean
, DescriptorBean
, javax.management.DynamicMBean
, javax.management.MBeanRegistration
, javax.management.NotificationBroadcaster
, RealmContainer
, SettableBean
, WebLogicMBean
public interface SecurityConfigurationMBean extends ConfigurationMBean, RealmContainer
Provides domain-wide security configuration information.
DEFAULT_EMPTY_BYTE_ARRAY
Modifier and Type | Method | Description |
---|---|---|
RealmMBean |
createRealm() |
Creates a realm.
|
RealmMBean |
createRealm(java.lang.String name) |
Creates a realm.
|
void |
destroyRealm(RealmMBean realm) |
Destroys a realm.
|
RealmMBean |
findDefaultRealm() |
Deprecated.
9.0.0.0 Replaced by
getDefaultRealm() |
RealmMBean |
findRealm(java.lang.String realmDisplayName) |
Deprecated.
9.0.0.0 Replaced by
lookupRealm(java.lang.String) |
RealmMBean[] |
findRealms() |
Deprecated.
9.0.0.0 Replaced by
getRealms() |
byte[] |
generateCredential() |
Generates a new encrypted byte array which can be use when calling #setCredentialEncrypted
|
java.lang.String |
getAdministrativeIdentityDomain() |
Domain's administrative identity domain.
|
long |
getBootAuthenticationMaxRetryDelay() |
The maximum length of time, in milliseconds, the boot process will wait before
retrying the authentication after a login server not available exception.
|
int |
getBootAuthenticationRetryCount() |
The maximum number of times the boot process will try to authenticate the boot user
with the authentication providers.
|
CertRevocMBean |
getCertRevoc() |
Determines the domain's X509 certificate revocation checking
configuration.
|
boolean |
getCompatibilityConnectionFiltersEnabled() |
Specifies whether this WebLogic Server domain
enables compatiblity with previous connection filters.
|
java.lang.String |
getConnectionFilter() |
The name of the Java class that implements a connection filter
(that is, the
weblogic.security.net.ConnectionFilter
interface). |
java.lang.String[] |
getConnectionFilterRules() |
The rules used by any connection filter that implements the
ConnectionFilterRulesListener interface. |
boolean |
getConnectionLoggerEnabled() |
Specifies whether this WebLogic Server domain should log
accepted connections.
|
RealmMBean |
getDefaultRealm() |
Returns the default security realm or null if no realm has
been selected as the default security realm.
|
RealmMBean |
getDefaultRealmInternal() |
|
boolean |
getDowngradeUntrustedPrincipals() |
Whether or not to downgrade to anonymous principals that cannot
be verified.
|
boolean |
getEnforceStrictURLPattern() |
Whether or not the system should enforce strict URL pattern or not.
|
boolean |
getEnforceValidBasicAuthCredentials() |
Whether or not the system should allow requests with invalid Basic
Authentication credentials to access unsecure resources.
|
java.lang.String[] |
getExcludedDomainNames() |
Specifies a list of remote domains for which cross-domain check
should not be applied.
|
JASPICMBean |
getJASPIC() |
Creates a Jaspic MBean from which AuthConfigProviders can
be created and configured.
|
java.lang.String |
getName() |
The user-specified name of this MBean instance.
|
java.lang.String |
getNodeManagerPassword() |
The password that the Administration Server uses to communicate
with Node Manager when starting,
stopping, or restarting Managed Servers.
|
byte[] |
getNodeManagerPasswordEncrypted() |
The password that the Administration Server passes to a
Node Manager when it instructs the Node Manager to start,
stop, or restart Managed Servers.
|
java.lang.String |
getNodeManagerUsername() |
The user name that the Administration Server uses to communicate
with Node Manager when starting,
stopping, or restarting Managed Servers.
|
int |
getNonceTimeoutSeconds() |
Returns the value of the nonce timeout in seconds.
|
RealmMBean[] |
getRealms() |
Returns all the realms in the domain.
|
SecureModeMBean |
getSecureMode() |
Returns the SecureMode MBean that contains attributes that control the behavior
of Secure Mode.
|
java.lang.String |
getWebAppFilesCaseInsensitive() |
This property defines the case sensitive URL-pattern matching
behavior for security constraints, servlets, filters, virtual-hosts,
and so on, in the Web application container and external security policies.
|
boolean |
isAnonymousAdminLookupEnabled() |
Deprecated.
12.2.1.0.0
|
boolean |
isClearTextCredentialAccessEnabled() |
Returns true if allow access to credential in clear text.
|
boolean |
isConsoleFullDelegationEnabled() |
Indicates whether the console is enabled for fully delegate authorization.
|
boolean |
isCrossDomainSecurityEnabled() |
Indicates whether or not cross-domain security is enabled.
|
boolean |
isIdentityDomainAwareProvidersRequired() |
Returns true if all role mapping, authorization, credential mapping, and audit providers configured in the
domain must support the IdentityDomainAwareProviderMBean interface's administrative identity domain.
|
boolean |
isIdentityDomainDefaultEnabled() |
Returns true if identity domain values should be defaulted for the Administrative Identity Domain, Partition
Primary Identity Domain, and Default Authenticator Identity Domain attributes.
|
boolean |
isPrincipalEqualsCaseInsensitive() |
Specifies whether the WebLogic Server principal name is compared using a
case insensitive match when the equals
method for the principal object is performed.
|
boolean |
isPrincipalEqualsCompareDnAndGuid() |
Specifies whether the GUID and DN data in a WebLogic Server principal
object are used when the equals method of that object is invoked.
|
boolean |
isRemoteAnonymousJNDIEnabled() |
Returns true if remote anonymous JNDI access is
permitted for list and modify operations.
|
boolean |
isUseKSSForDemo() |
Determines whether the Demo Identity and Demo Trust key stores should be
obtained from the Oracle Key Store Service (KSS).
|
RealmMBean |
lookupRealm(java.lang.String name) |
Finds a realm given it's name.
|
void |
setAdministrativeIdentityDomain(java.lang.String identityDomain) |
Set this domain's administrative identity domain.
|
void |
setAnonymousAdminLookupEnabled(boolean permit) |
Permits anonymous JNDI access to get the Admin MBean home.
|
void |
setBootAuthenticationMaxRetryDelay(long millis) |
Sets the boot authentication maximum retry delay time.
|
void |
setBootAuthenticationRetryCount(int count) |
|
void |
setClearTextCredentialAccessEnabled(boolean enabled) |
Allow access to clear-text password.
|
void |
setCompatibilityConnectionFiltersEnabled(boolean compatibility) |
|
void |
setConnectionFilter(java.lang.String filter) |
|
void |
setConnectionFilterRules(java.lang.String[] filterList) |
|
void |
setConnectionLoggerEnabled(boolean logging) |
|
void |
setConsoleFullDelegationEnabled(boolean enabled) |
Enables the console to operate with fully delegate authorization.
|
void |
setCredential(java.lang.String credential) |
As of 8.1 sp4, this method does the following:
|
void |
setCredentialEncrypted(byte[] bytes) |
Encrypts and sets the value of the CredentialEncrypted attribute.
|
void |
setCrossDomainSecurityEnabled(boolean enabled) |
Turns on/off the cross-domain security.
|
void |
setDefaultRealm(RealmMBean defaultRealm) |
Sets the default security realm.
|
void |
setDefaultRealmInternal(RealmMBean def) |
|
void |
setDowngradeUntrustedPrincipals(boolean downgrade) |
|
void |
setEnforceStrictURLPattern(boolean enforceStrictURLPattern) |
|
void |
setEnforceValidBasicAuthCredentials(boolean allow) |
|
void |
setExcludedDomainNames(java.lang.String[] remoteDomains) |
Specifies a list of remote domains for which cross-domain check
should not be applied.
|
void |
setIdentityDomainAwareProvidersRequired(boolean requireIdentityDomain) |
Set whether providers must support the IdentityDomainAwareProviderMBean interface.
|
void |
setIdentityDomainDefaultEnabled(boolean enabled) |
Set whether identity domain default values are enabled
|
void |
setNodeManagerPassword(java.lang.String password) |
Sets the value of the NodeManagerPassword attribute.
|
void |
setNodeManagerPasswordEncrypted(byte[] bytes) |
Sets the value of the NodeManagerPassword attribute.
|
void |
setNodeManagerUsername(java.lang.String username) |
Sets the node manager username for the domain.
|
void |
setNonceTimeoutSeconds(int timeout) |
Sets the value of the nonce timeout in seconds.
|
void |
setPrincipalEqualsCaseInsensitive(boolean principalEqualsCaseInsensitive) |
Sets the value of the PrincipalEqualsCaseInsensitive attribute.
|
void |
setPrincipalEqualsCompareDnAndGuid(boolean principalEqualsCompareDnAndGuid) |
Sets the value of the UseGUIDandDNinEqual attribute.
|
void |
setRemoteAnonymousJNDIEnabled(boolean permit) |
Permits remote anonymous JNDI access.
|
void |
setUseKSSForDemo(boolean useKss) |
Specifies that the Demo Identity and Demo Trust key stores should be
obtained from the Oracle Key Store Service (KSS).
|
void |
setWebAppFilesCaseInsensitive(java.lang.String caseInsensitive) |
Sets the value for the WebAppFilesCaseInsensitive.
|
freezeCurrentValue, getId, getInheritedProperties, getNotes, isDynamicallyCreated, isInherited, isSet, restoreDefaultValue, setComments, setDefaultedMBean, setName, setNotes, setPersistenceEnabled, unSet
addPropertyChangeListener, createChildCopyIncludingObsolete, getParentBean, isEditable, removePropertyChangeListener
getAttribute, getAttributes, invoke, setAttribute, setAttributes
postDeregister, postRegister, preDeregister, preRegister
addNotificationListener, getNotificationInfo, removeNotificationListener
getMBeanInfo, getObjectName, getParent, getType, isCachingDisabled, isRegistered, setParent
SecureModeMBean getSecureMode()
JASPICMBean getJASPIC()
RealmMBean createRealm(java.lang.String name) throws javax.management.JMException
name
- - The name of this realm, for example, myrealm
javax.management.JMException
RealmMBean createRealm() throws javax.management.JMException
javax.management.JMException
void destroyRealm(RealmMBean realm)
realm
- RealmMBean[] getRealms()
RealmMBean lookupRealm(java.lang.String name)
realm
- @Deprecated RealmMBean[] findRealms()
getRealms()
@Deprecated RealmMBean findDefaultRealm()
getDefaultRealm()
@Deprecated RealmMBean findRealm(java.lang.String realmDisplayName)
lookupRealm(java.lang.String)
realmDisplayName
- A String containing the realm's display name.RealmMBean getDefaultRealm()
void setDefaultRealm(RealmMBean defaultRealm) throws javax.management.InvalidAttributeValueException
defaultRealm
- The new default realm.
Use null to specify that there is no default realm.javax.management.InvalidAttributeValueException
@Deprecated boolean isAnonymousAdminLookupEnabled()
Returns true if anonymous JNDI access for Admin MBean home is
permitted. This is overridden by the Java property
-Dweblogic.management.anonymousAdminLookupEnabled
.
void setAnonymousAdminLookupEnabled(boolean permit)
Permits anonymous JNDI access to get the Admin MBean home.
permit
- The new value.isAnonymousAdminLookupEnabled()
boolean isClearTextCredentialAccessEnabled()
Returns true if allow access to credential in clear text.
This can be overridden by the system property
-Dweblogic.management.clearTextCredentialAccessEnabled
void setClearTextCredentialAccessEnabled(boolean enabled)
Allow access to clear-text password.
enabled
- The new value.isClearTextCredentialAccessEnabled()
byte[] generateCredential()
Generates a new encrypted byte array which can be use when calling #setCredentialEncrypted
void setCredential(java.lang.String credential) throws javax.management.InvalidAttributeValueException
As of 8.1 sp4, this method does the following:
CredentialEncrypted
attribute to the
encrypted parameter value.credential
- The new credential valuejavax.management.InvalidAttributeValueException
getCredential()
,
setCredentialEncrypted(byte[] bytes)
void setCredentialEncrypted(byte[] bytes) throws javax.management.InvalidAttributeValueException
Encrypts and sets the value of the CredentialEncrypted attribute.
bytes
- The new credential value as a byte array.javax.management.InvalidAttributeValueException
getCredentialEncrypted()
java.lang.String getWebAppFilesCaseInsensitive()
This property defines the case sensitive URL-pattern matching
behavior for security constraints, servlets, filters, virtual-hosts,
and so on, in the Web application container and external security policies.
Note: This is a Windows-only flag that is provided for backward
compatibility when upgrading from pre-9.0 versions of WebLogic Server.
On Unix platforms, setting this value to true
causes
undesired behavior and is not supported.
When the value is set to os
, the pattern matching will be case-
sensitive on all platforms except the Windows file system.
Note that on non-Windows file systems, WebLogic Server does not enforce
case sensitivity and relies on the file system for optimization.
As a result, if you have a Windows Samba mount from Unix or Mac OS
that has been installed in case-insensitive mode, there is a chance
of a security risk. If so, specify case-insensitive lookups by setting
this attribute to true
.
Note also that this property is used to preserve backward compatibility on
Windows file systems only. In prior releases, WebLogic Server was case-
insensitive on Windows. As of WebLogic Server 9.0, URL-pattern
matching is strictly enforced.
During the upgrade of older domains, the value of this parameter
is explicitly set to os
by the upgrade plug-in to
preserve backward compatibility.
void setWebAppFilesCaseInsensitive(java.lang.String caseInsensitive) throws javax.management.InvalidAttributeValueException
Sets the value for the WebAppFilesCaseInsensitive.
caseInsensitive
- The new value caseInsensitive.javax.management.InvalidAttributeValueException
getWebAppFilesCaseInsensitive()
java.lang.String getConnectionFilter()
The name of the Java class that implements a connection filter
(that is, the weblogic.security.net.ConnectionFilter
interface). If no class name is specified, no connection filter
will be used.
This attribute replaces the deprecated ConnectionFilter attribute on the SecurityMBean.
void setConnectionFilter(java.lang.String filter) throws javax.management.InvalidAttributeValueException
javax.management.InvalidAttributeValueException
java.lang.String[] getConnectionFilterRules()
The rules used by any connection filter that implements the
ConnectionFilterRulesListener
interface. When using the
default implementation and when no rules are specified, all
connections are accepted. The default implementation rules are in
the format: target localAddress localPort action
protocols
.
This attribute replaces the deprecated ConnectionFilterRules attribute on the SecurityMBean.
void setConnectionFilterRules(java.lang.String[] filterList)
boolean getConnectionLoggerEnabled()
Specifies whether this WebLogic Server domain should log accepted connections.
This attribute can be used by a system administrator to dynamically check the incoming connections in the log file to determine if filtering needs to be performed.
This attribute replaces the deprecated ConnectionLoggerEnabled attribute on the SecurityMBean.
void setConnectionLoggerEnabled(boolean logging) throws javax.management.InvalidAttributeValueException
javax.management.InvalidAttributeValueException
boolean getCompatibilityConnectionFiltersEnabled()
Specifies whether this WebLogic Server domain enables compatiblity with previous connection filters.
This attribute changes the protocols names used when filtering needs to be performed.
void setCompatibilityConnectionFiltersEnabled(boolean compatibility) throws javax.management.InvalidAttributeValueException
javax.management.InvalidAttributeValueException
java.lang.String getNodeManagerUsername()
The user name that the Administration Server uses to communicate with Node Manager when starting, stopping, or restarting Managed Servers.
void setNodeManagerUsername(java.lang.String username)
username
- the new username valuegetNodeManagerUsername()
java.lang.String getNodeManagerPassword()
The password that the Administration Server uses to communicate with Node Manager when starting, stopping, or restarting Managed Servers.
When you get the value of this attribute, WebLogic Server does the following:
NodeManagerPasswordEncrypted
attribute.When you set the value of this attribute, WebLogic Server does the following:
NodeManagerPasswordEncrypted
attribute to the
encrypted value.Using this attribute (NodeManagerPassword
) is a potential security risk because
the String object (which contains the unencrypted password) remains in
the JVM's memory until garbage collection removes it and the memory is reallocated. Depending on how
memory is allocated in the JVM, a significant amount of time could pass
before this unencrypted data is removed from memory.
Instead of using this attribute, you should use NodeManagerPasswordEncrypted
.
getNodeManagerPasswordEncrypted()
void setNodeManagerPassword(java.lang.String password)
password
- the new password valuegetNodeManagerPassword()
,
setNodeManagerPasswordEncrypted(byte[])
byte[] getNodeManagerPasswordEncrypted()
The password that the Administration Server passes to a Node Manager when it instructs the Node Manager to start, stop, or restart Managed Servers.
To set this attribute, use weblogic.management.EncryptionHelper.encrypt()
to encrypt the value. Then set this attribute to the output of the encrypt() method.
To compare a password that a user enters with the encrypted
value of this attribute, go to the same WebLogic Server instance
that you used to set and encrypt this attribute
and use weblogic.management.EncryptionHelper.encrypt()
to encrypt the user-supplied password. Then compare the encrypted values.
void setNodeManagerPasswordEncrypted(byte[] bytes)
bytes
- the new password valuegetNodeManagerPasswordEncrypted()
boolean isPrincipalEqualsCaseInsensitive()
Specifies whether the WebLogic Server principal name is compared using a case insensitive match when the equals method for the principal object is performed.
If this attribute is enabled, matches are case insensitive.
Note: Note that principal comparison is not used by the WebLogic Security Service to determine access to protected resources. This attribute is intended for use with JAAS authorization, which may require case insensitive principal matching behavior.
void setPrincipalEqualsCaseInsensitive(boolean principalEqualsCaseInsensitive)
principalEqualsCaseInsensitive
- isPrincipalEqualsCaseInsensitive()
boolean isPrincipalEqualsCompareDnAndGuid()
Specifies whether the GUID and DN data in a WebLogic Server principal object are used when the equals method of that object is invoked.
If enabled, the GUID and DN data (if included among the attributes in a WebLogic Server principal object) and the principal name are compared when this method is invoked.
void setPrincipalEqualsCompareDnAndGuid(boolean principalEqualsCompareDnAndGuid)
principalEqualsCompareDnAndGuid
- isPrincipalEqualsCompareDnAndGuid()
boolean getDowngradeUntrustedPrincipals()
void setDowngradeUntrustedPrincipals(boolean downgrade)
downgrade
- the new DowngradeUntrustedPrincipals valuegetDowngradeUntrustedPrincipals()
boolean getEnforceStrictURLPattern()
void setEnforceStrictURLPattern(boolean enforceStrictURLPattern)
enforceStrictURLPattern
- the new EnforceStrictURLPattern valuegetEnforceStrictURLPattern()
boolean getEnforceValidBasicAuthCredentials()
void setEnforceValidBasicAuthCredentials(boolean allow)
allow
- the new EnforceValidBasicAuthCredentials valuegetEnforceValidBasicAuthCredentials()
boolean isConsoleFullDelegationEnabled()
Indicates whether the console is enabled for fully delegate authorization.
void setConsoleFullDelegationEnabled(boolean enabled)
Enables the console to operate with fully delegate authorization.
enabled
- the new console full delegation valueisConsoleFullDelegationEnabled()
RealmMBean getDefaultRealmInternal()
getDefaultRealmInternal
in interface RealmContainer
RealmContainer
void setDefaultRealmInternal(RealmMBean def)
setDefaultRealmInternal
in interface RealmContainer
RealmContainer
java.lang.String[] getExcludedDomainNames()
Specifies a list of remote domains for which cross-domain check should not be applied.
void setExcludedDomainNames(java.lang.String[] remoteDomains)
Specifies a list of remote domains for which cross-domain check should not be applied. Sets the list of remote domain names that are to be excluded from the cross-domain checks.
remoteDomains
- Array of Strings of all the domain names to be excluded.boolean isCrossDomainSecurityEnabled()
Indicates whether or not cross-domain security is enabled.
void setCrossDomainSecurityEnabled(boolean enabled)
Turns on/off the cross-domain security.
enabled
- indicate whether or not cross domain security
is enabled via the use of credential mapper.CertRevocMBean getCertRevoc()
Determines the domain's X509 certificate revocation checking configuration.
A CertRevocMBean is always associated with a domain's security configuration and cannot be changed, although CertRevocMBean attributes may be changed as documented.
boolean isUseKSSForDemo()
Determines whether the Demo Identity and Demo Trust key stores should be obtained from the Oracle Key Store Service (KSS).
If enabled, Weblogic Server will request the Demo Identity and Domain Trust key stores from KSS. Subsequent to installation however, the KSS Demo key stores may have been manipulated such that appropriate Demo certificates or keys are not available.
Please verify the following KSS Demo Identity keystore has an X.509 private key and corresponding public identity certificate signed by the Demo Certificate Authority (CA):
Please verify the following KSS Domain Trust keystore has a trusted Demo Certificate Authority X.509 certificate:
setUseKSSForDemo(boolean)
void setUseKSSForDemo(boolean useKss)
If enabled, Weblogic Server will request the Demo Identity and Domain Trust key stores from KSS. Subsequent to installation however, the KSS Demo key stores may have been manipulated such that appropriate Demo certificates or keys are not available.
Please verify the following KSS Demo Identity keystore has an X.509 private key and corresponding public identity certificate signed by the Demo Certificate Authority (CA):
Please verify the following KSS Domain Trust keystore has a trusted Demo Certificate Authority X.509 certificate:
useKss
- true
to use KSS for Demo key stores,
otherwise false
.isUseKSSForDemo()
java.lang.String getAdministrativeIdentityDomain()
void setAdministrativeIdentityDomain(java.lang.String identityDomain)
identityDomain
- the administrative identity domainboolean isIdentityDomainAwareProvidersRequired()
void setIdentityDomainAwareProvidersRequired(boolean requireIdentityDomain)
requireIdentityDomain
- true if providers must support identity domains, false otherwiseboolean isIdentityDomainDefaultEnabled()
void setIdentityDomainDefaultEnabled(boolean enabled)
enabled
- true if defaulting of identity domain values is enabled, false otherwise.int getNonceTimeoutSeconds()
void setNonceTimeoutSeconds(int timeout)
timeout
- number of seconds that the nonce is valid.java.lang.String getName()
The user-specified name of this MBean instance.
This name is included as one of the key properties in the
MBean's javax.management.ObjectName
:
Name=user-specified-name
getName
in interface ConfigurationMBean
getName
in interface WebLogicMBean
boolean isRemoteAnonymousJNDIEnabled()
Returns true if remote anonymous JNDI access is permitted for list and modify operations.
void setRemoteAnonymousJNDIEnabled(boolean permit)
Permits remote anonymous JNDI access.
permit
- The new value.isRemoteAnonymousJNDIEnabled()
int getBootAuthenticationRetryCount()
void setBootAuthenticationRetryCount(int count)
count
- long getBootAuthenticationMaxRetryDelay()
void setBootAuthenticationMaxRetryDelay(long millis)