FeatureCompatibilityMBean


Overview  |   Related MBeans  |   Attributes  |   Operations

Overview

Controls feature compatibility behavior for WebLogic Server features.

The compatibility attributes on this MBean preserve legacy behavior when disabled. Enabling them applies the corresponding tightened security behavior. These protections are enabled by default.

       
Since26.1.0.0.0
Fully Qualified Interface NameIf you use the getMBeanInfo operation in MBeanTypeServiceMBean, supply the following value as this MBean's fully qualified interface name:
weblogic.management.configuration.FeatureCompatibilityMBean
Factory Methods No factory methods. Instances of this MBean are created automatically.
Access Points You can access this MBean from the following MBean attributes:


    Attributes

    This section describes the following attributes:


    CachingDisabled

    Private property that disables caching in proxies.

           
    Privileges Read only
    Typeboolean
    Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

    CrossDomainT3SConnectionTrustValidationEnabled

    Returns whether reused cross-domain T3S connections require trust validation. When enabled, a reverse cross-domain lookup cannot reuse an established T3S connection and must pass a fresh SSL trust check. Changes take effect after the server is restarted.

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    DynamicallyCreated

    Return whether the MBean was created dynamically or is persisted to config.xml

           
    Privileges Read only
    Typeboolean
    Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

    Id

    Return the unique id of this MBean instance

           
    Privileges Read only
    Typelong
    Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

    IIOPStrictRemoteBusinessInterfaceValidationEnabled

    Controls strict validation of IIOP business interfaces used during client stub generation.

    When enabled, WebLogic Server rejects a business interface that is not recognized as a remote interface. When disabled, WebLogic Server permits a locally visible plain business interface for a legacy IIOP client only when the IOR has no codebase.

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    IIOPTypedReadResolveProxyValidationEnabled

    Controls strict validation of typed IIOP serialization wrappers. When enabled, incompatible wire classes, including serialization wrappers, are rejected before readResolve(). When disabled, legacy typed IIOP readResolve proxy behavior is preserved.

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    IIOPUnauthenticatedServiceContextValueTypeFilteringEnabled

    Returns whether IIOP request and reply service-context valuetypes are filtered by the unauthenticated deserialization allowlist.

    When enabled, WebLogic Server applies the unauthenticated deserialization filter while reading IIOP request and reply service contexts. The filter does not apply to application values in request or reply bodies. When disabled, WebLogic Server preserves legacy IIOP service-context unmarshalling behavior.

    A value of {@code true} enables the tightened filtering. A value of {@code false} preserves legacy behavior.

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    JAXWSRejectUnknownSEIOperationsEnabled

    Specifies whether JAX-WS SEI endpoints reject requests whose SOAP operation does not resolve to an SEI method before invoking downstream tubes.

    When enabled, an unknown operation receives an Invalid operation SOAP fault before downstream processing, including WorkContext processing. When disabled, the request follows the legacy path, which invokes downstream tubes without method-level authorization for that operation. This protection is enabled by default. A change takes effect for subsequent requests without restarting the server.

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    JNDIAdditionalFactoriesAllowListsEnabled

    Returns whether the JNDI additional factory allowlists are enabled.

    When enabled, WebLogic Server applies the {@code SecurityConfigurationMBean.JNDIAdditionalInitialContextFactoriesAllowed} and {@code SecurityConfigurationMBean.JNDIAdditionalReferenceFactoriesAllowed} allowlists before caller-supplied JNDI factories can be used. When disabled, WebLogic Server preserves legacy initial context factory and reference factory behavior.

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    JNDIBindingAuthorizationPolicyEnabled

    Returns whether policy enforcement is enabled for authorization of JNDI namespace binding changes.

    When enabled, WebLogic Server applies tightened authorization and protocol checks before namespace write operations such as {@code bind}, {@code rebind}, {@code unbind}, {@code rename}, subcontext creation, sharable namespace mutation, or IIOP CosNaming mutation can change server-side JNDI bindings. When disabled, WebLogic Server preserves legacy remote JNDI mutation and protocol-specific mutation behavior.

    A value of {@code true} enables the tightened policy for this category. A value of {@code false} preserves legacy behavior.

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    JNDIOutboundConnectionsAllowListEnabled

    Returns whether the JNDI outbound connection allowlist is enabled.

    When enabled, WebLogic Server applies the {@code SecurityConfigurationMBean.JNDIOutboundConnectionsAllowed} allowlist to JNDI provider URLs and URL-shaped lookup inputs. When disabled, WebLogic Server preserves legacy outbound JNDI connection behavior.

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    MBeanInfo

    Returns the MBean info for this MBean.

    Deprecated.

           
    Privileges Read only
    Typejavax.management.MBeanInfo
    Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

    Name

    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

           
    Privileges Read/Write
    Typejava.lang.String

    Notes

    Optional information that you can include to describe this configuration.

    WebLogic Server saves this note in the domain's configuration file (config.xml) as XML PCDATA. All left angle brackets (<) are converted to the XML entity &lt;. Carriage returns/line feeds are preserved.

    Note: If you create or edit a note from the Administration Console, the Administration Console does not preserve carriage returns/line feeds.

               
    Privileges Read/Write
    Security rolesWrite access is granted only to the following roles:
    • Deployer
    • Operator
    Typejava.lang.String

    ObjectName

    Returns the ObjectName under which this MBean is registered in the MBean server.

    Deprecated.

           
    Privileges Read only
    Typeweblogic.management.WebLogicObjectName
    Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

    Parent

    Return the immediate parent for this MBean

           
    Privileges Read/Write
    Type

    Registered

    Returns false if the MBean represented by this object has been unregistered.

    Deprecated.

           
    Privileges Read only
    Typeboolean
    Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

    SAML2StrictArtifactResolutionEnabled

    Specifies whether SAML 2.0 artifact-resolution requesters must be authenticated before accessing the artifact cache.

    When enabled, WebLogic Server requires an enabled partner matching the request issuer, validates configured authentication and any supplied or required signature, and consumes the artifact only for an authenticated intended recipient. A verified signature or a partner-matched TLS client certificate is required; shared Basic authentication alone does not identify a partner.

    This protection is enabled by default. Configure request signing or partner-matched TLS client authentication at both partners. Set this attribute to false only when legacy interoperability is required; doing so permits artifact retrieval before authentication and disables this protection. Unsetting the attribute restores the enabled default. A change takes effect for subsequent requests without restarting the server.

           
    Available Since Release 26.1.0.0.0
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    SerializedWorkContextMaximumSize

    Specifies the maximum allowed size, in bytes, of a serialized SerializableWorkContext payload read from a WorkArea input stream.

    A value of -1 disables the compatibility limit and preserves legacy behavior. To enable the limit, set this attribute to a positive byte count. A value of zero leaves the byte limit unapplied but keeps the additional unauthenticated deserialization filter enabled. Raise the value only if legitimate WorkContext payloads require more space.

    When this MBean is available, its effective value, including the default, takes precedence over the legacy {@code weblogic.workarea.serializableWorkContext.maxLength} JVM property.

           
    Available Since Release 26.1.0.0.0
    Privileges Read/Write
    Typeint
    Default Value65535
    Minimum value-1

    SpringJtaDeserializationJndiLookupDisabled

    Controls whether Spring JtaTransactionManager skips resolving serialized JNDI names while deserializing.

    When enabled, transient JTA handles are not restored from serialized JNDI names. When disabled, WebLogic Server preserves the legacy Spring behavior of resolving serialized JNDI names during deserialization. WebLogic's configured JTA lookup during normal bean initialization is not affected.

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    T3LegacyCrossDomainCredentialJVMIDReplayProtectionEnabled

    Specifies whether T3 RJVM identify processing should enable replay protection for JVMIDs signed by legacy cross-domain credentials.

    Enabling this attribute prevents a replayable legacy cross-domain credential-signed JVMID from promoting a freshly identified inbound RJVM to trusted-server state. Set this attribute to false to preserve legacy global-domain-trust behavior.

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    T3RouteOnlyToTrustedServersEnabled

    Returns whether T3 server routing is limited to trusted servers.

    When enabled, WebLogic Server requires routed T3 destinations to be known or configured before forwarding traffic. When disabled, WebLogic Server preserves legacy T3 server routing compatibility for trusted server-to-server messages whose destination is supplied on the wire.

    A value of {@code true} enables the tightened routing checks. A value of {@code false} preserves the legacy routing behavior.

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    Tags

    Return all tags on this Configuration MBean

           
    Available Since Release 12.2.1.0.0
    Privileges Read/Write
    Typeclass java.lang.String[]

    Type

    Returns the type of the MBean.

           
    Privileges Read only
    Typejava.lang.String
    Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

    WLDFScriptActionPathRestrictionEnabled

    Controls whether WLDF script actions require the script path to resolve under {@code DOMAIN_HOME/bin/scripts}.

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    WLProxyClientCertificateChainValidationEnabled

    Returns whether WebLogic Server validates certificate chains supplied in the {@code WL-Proxy-Client-Cert} header before using them for X.509 identity assertion.

    When enabled, WebLogic Server validates the proxy-supplied certificate chain against the configured WebLogic Server client certificate trust anchors before setting the {@code jakarta.servlet.request.X509Certificate} request attribute. Invalid, untrusted, expired, malformed, or otherwise unverifiable certificates are rejected. When disabled, WebLogic Server preserves the legacy proxy client certificate behavior.

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    WorkContextClassValidationEnabled

    Returns whether tightened validation is enabled for WorkContext implementation classes read from WorkArea input streams.

    When enabled, WebLogic Server validates WorkContext class names and resolved classes before constructing WorkContext implementations on T3, JMS, IIOP, legacy XML SOAP, and other WorkArea readers that apply this attribute. The tightened policy on those readers limits unauthenticated or untrusted inbound input to WebLogic built-in and product WorkContext implementations. Protocol compatibility paths can preserve SerializableWorkContext behavior, but authentication alone does not permit arbitrary custom WorkContext implementations when this attribute is enabled.

    Legacy XML WorkArea SOAP, when explicitly enabled with {@code weblogic.wsee.workarea.workContext.oldFormat.support}, applies these class checks before class initialization, construction, and readContext. The format opt-in is independent: this attribute does not enable that format. Disabling this attribute preserves legacy XML class admission; existing XML structural checks remain in effect.

    Custom WorkContexts created by server application code can propagate through collocated RMI calls between applications. WorkContexts admitted by the applicable WorkArea input factories, including XML and binary SOAP, retain their received origin. Subsequent collocated copies apply inbound validation under the effective policy, including to contexts received while this attribute was disabled. Deferred received SerializableWorkContext payloads retain their separate payload validation.

    A value of {@code true} enables the tightened WorkContext class checks. A value of {@code false} preserves legacy behavior for patch compatibility.

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    WorkContextInputMaximumASCIIFieldSize

    Specifies the maximum allowed size, in bytes, of an ASCII field read from the WorkArea binary encoding in which the field length is represented by a four-byte signed integer. This limit does not apply to transport-specific WorkContext encodings, including T3 and IIOP, which use separate decoding paths and are not governed by this attribute.

    A value of {@code -1} leaves the cap unapplied and preserves legacy behavior. Every value greater than or equal to {@code 0} is a literal byte cap; {@code 0} has no special meaning and permits only zero-length ASCII fields. Raise the value only if legitimate WorkContext fields require more space.

           
    Available Since Release 26.1.0.0.0
    Privileges Read/Write
    Typeint
    Default Value65535
    Minimum value-1

    WSATIgnoreUnknownReplayCompletionEnabled

    Specifies whether WS-AT replay completion requests with no matching local transaction should be ignored instead of rolling back a recovery resource created from the caller-supplied ReplyTo endpoint.

    Enabling this attribute selects the hardened unknown-transaction replay completion behavior. Set this attribute to {@code false} to preserve legacy behavior.

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    WSATRegistrationSecretEnabled

    Controls whether WS-AT registration requires proof that the caller received the exported coordination context before participant enlistment.

    Enabling this attribute emits a per-transaction registration secret in WLS-generated coordination contexts and requires unauthenticated registration requests to echo the matching secret before enlistment. Set this attribute to {@code false} to preserve legacy WS-AT interoperability.

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue


    Operations

    This section describes the following operations:


    addTag

    Add a tag to this Configuration MBean. Adds a tag to the current set of tags on the Configuration MBean. Tags may contain white spaces.

       
    Operation Name"addTag"
    ParametersObject [] {  tag }

    where:

    • tag is an object of type java.lang.String that specifies:

      tag to be added to the MBean

    SignatureString [] { "java.lang.String" }
    Returns boolean
    Exceptions
    • java.lang.IllegalArgumentException
      IllegalArgumentException if the tag contains illegal punctuation

    freezeCurrentValue

    If the specified attribute has not been set explicitly, and if the attribute has a default value, this operation forces the MBean to persist the default value.

    Unless you use this operation, the default value is not saved and is subject to change if you update to a newer release of WebLogic Server. Invoking this operation isolates this MBean from the effects of such changes.

    Note: To insure that you are freezing the default value, invoke the restoreDefaultValue operation before you invoke this.

    This operation has no effect if you invoke it on an attribute that does not provide a default value or on an attribute for which some other value has been set.

    Deprecated. 9.0.0.0

       
    Operation Name"freezeCurrentValue"
    ParametersObject [] {  attributeName }

    where:

    • attributeName is an object of type java.lang.String that specifies:

    SignatureString [] { "java.lang.String" }
    Returns void
    Exceptions
    • javax.management.AttributeNotFoundException
    • javax.management.MBeanException

    getInheritedProperties

    Return all properties' names whose value is inherited from template mbean. this is a convenient method to get inheritance info on multiple properties in one jmx call.

       
    Operation Name"getInheritedProperties"
    ParametersObject [] {  propertyNames }

    where:

    • propertyNames is an object of type [Ljava.lang.String; that specifies:

      properties to check

    SignatureString [] { "[Ljava.lang.String;" }
    Returns class

    isInherited

    Check if the value of a property is inherited from template mbean or not.

       
    Operation Name"isInherited"
    ParametersObject [] {  propertyName }

    where:

    • propertyName is an object of type java.lang.String that specifies:

      the name of the property

    SignatureString [] { "java.lang.String" }
    Returns boolean

    isSet

    Returns true if the specified attribute has been set explicitly in this MBean instance.

       
    Operation Name"isSet"
    ParametersObject [] {  propertyName }

    where:

    • propertyName is an object of type java.lang.String that specifies:

      property to check

    SignatureString [] { "java.lang.String" }
    Returns boolean

    removeTag

    Remove a tag from this Configuration MBean

       
    Operation Name"removeTag"
    ParametersObject [] {  tag }

    where:

    • tag is an object of type java.lang.String that specifies:

      tag to be removed from the MBean

    SignatureString [] { "java.lang.String" }
    Returns boolean
    Exceptions
    • java.lang.IllegalArgumentException
      IllegalArgumentException if the tag contains illegal punctuation

    restoreDefaultValue

    If the specified attribute has a default value, this operation removes any value that has been set explicitly and causes the attribute to use the default value.

    Default values are subject to change if you update to a newer release of WebLogic Server. To prevent the value from changing if you update to a newer release, invoke the freezeCurrentValue operation.

    This operation has no effect if you invoke it on an attribute that does not provide a default value or on an attribute that is already using the default.

    Deprecated. 9.0.0.0

       
    Operation Name"restoreDefaultValue"
    ParametersObject [] {  attributeName }

    where:

    • attributeName is an object of type java.lang.String that specifies:

    SignatureString [] { "java.lang.String" }
    Returns void
    Exceptions
    • javax.management.AttributeNotFoundException

    unSet

    Restore the given property to its default value.

       
    Operation Name"unSet"
    ParametersObject [] {  propertyName }

    where:

    • propertyName is an object of type java.lang.String that specifies:

      property to restore

    SignatureString [] { "java.lang.String" }
    Returns void