Overview | Package | Class | Use | Tree | Deprecated | Index | Help
|  | BEA Systems, Inc.
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

WebLogic Server 8.1 API Reference

## weblogic.management.configuration
Interface SecurityMBean

public interface SecurityMBean
extends ConfigurationMBean

Specifies the security properties of a WebLogic domain.

Author:
  Copyright © 2004 BEA Systems, Inc. All Rights Reserved.

Field Summary
`static long` | `CACHING_STUB_SVUID`

Fields inherited from class weblogic.management.configuration.ConfigurationMBean
`CACHING_STUB_SVUID, DEFAULT_EMPTY_BYTE_ARRAY`

Method Summary
`java.lang.String` | `getAuditProviderClassName()`
`java.lang.String` | `getConnectionFilter()` The name of the Java class that implements a connection filter.
`java.lang.String[]` | `getConnectionFilterRules()` The list of rules for the system connection filter.
`boolean` | `getConnectionLoggerEnabled()` Enables the logging of accepted connections.
`java.lang.String` | `getName()` Returns the name of the MBean.
`weblogic.management.configuration.PasswordPolicyMBean` | `getPasswordPolicy()` Deprecated.
`weblogic.management.configuration.RealmMBean` | `getRealm()` Sets the realm policies.
`ServerSecurityRuntimeMBean` | `getServerSecurityRuntime()` Returns the state of security on the specified WebLogic Server.
`java.lang.String` | `getSystemUser()` The name of the `system` user.
`boolean` | `isCompatibilityMode()` Specifies whether migration from a WebLogic Server 6.x security configuration is enabled.
`boolean` | `isCustomObjectAuthenticationEnabled()` Deprecated.
`boolean` | `isGuestDisabled()` Deprecated.
`void` | `setAuditProviderClassName(java.lang.String className)`
`void` | `setCompatibilityMode(boolean disable)`
`void` | `setConnectionFilter(java.lang.String filter)`
`void` | `setConnectionFilterRules(java.lang.String[] filterList)`
`void` | `setConnectionLoggerEnabled(boolean logging)`
`void` | `setCustomObjectAuthenticationEnabled(boolean enable)`
`void` | `setGuestDisabled(boolean disable)`
`void` | `setInteropEnabled(boolean disable)`
`void` | `setInteropUsername(java.lang.String username)`
`void` | `setName(java.lang.String name)` Set the name of the MBean.
`void` | `setPasswordPolicy(weblogic.management.configuration.PasswordPolicyMBean realm)`
`void` | `setRealm(weblogic.management.configuration.RealmMBean realm)`
`void` | `setRealmSetup(boolean disable)`
`void` | `setSystemUser(java.lang.String user)`

Methods inherited from interface weblogic.management.configuration.ConfigurationMBean
`freezeCurrentValue, getNotes, restoreDefaultValue, setComments, setDefaultedMBean, setNotes, setPersistenceEnabled`

Methods inherited from interface weblogic.management.WebLogicMBean
`getMBeanInfo, getObjectName, getParent, getType, isCachingDisabled, isRegistered, setParent`

Methods inherited from interface javax.management.DynamicMBean
`getAttribute, getAttributes, invoke, setAttribute, setAttributes`

Methods inherited from interface javax.management.MBeanRegistration
`postDeregister, postRegister, preRegister`

Methods inherited from interface javax.management.NotificationBroadcaster
`addNotificationListener, getNotificationInfo, removeNotificationListener`

Field Detail

### CACHING_STUB_SVUID

    public static final long CACHING_STUB_SVUID

Method Detail

### setName

    public void setName(java.lang.String name)
                 throws javax.management.InvalidAttributeValueException

  Set the name of the MBean.

  Legal Value: LegalHelper.securityMBeanSetNameLegalCheck(self,value);

### getName

    public java.lang.String getName()

  Returns the name of the MBean.

### getRealm

    public weblogic.management.configuration.RealmMBean getRealm()

  Sets the realm policies.

  A dynamic MBean attribute

### setRealm

    public void setRealm(weblogic.management.configuration.RealmMBean realm)
                  throws javax.management.InvalidAttributeValueException

### getAuditProviderClassName

    public java.lang.String getAuditProviderClassName()

### setAuditProviderClassName

    public void setAuditProviderClassName(java.lang.String className)
                                   throws javax.management.InvalidAttributeValueException

### isGuestDisabled

    public boolean isGuestDisabled()

  Deprecated.
  Specifies whether or not guest logins can be used to access WebLogic Server resources. This attribute is used in Compatibility mode.

  Default Value: true

### setGuestDisabled

    public void setGuestDisabled(boolean disable)

### isCustomObjectAuthenticationEnabled

    public boolean isCustomObjectAuthenticationEnabled()

  Deprecated.
  Specifies whether to allow Custom UserInfo Objects for login.

  Default Value: false

### setCustomObjectAuthenticationEnabled

    public void setCustomObjectAuthenticationEnabled(boolean enable)

### getConnectionFilter

    public java.lang.String getConnectionFilter()

  The name of the Java class that implements a connection filter. The connection filter must be an implementation of the `weblogic.security.net.ConnectionFilter` interface. WebLogic Server provides a default implementation.

  Default Value: null

### setConnectionFilter

    public void setConnectionFilter(java.lang.String filter)
                             throws javax.management.InvalidAttributeValueException

### getSystemUser

    public java.lang.String getSystemUser()

  The name of the `system` user. This attribute must be specified.

  Default Value: "system"
  Legal NULL: false

### setSystemUser

    public void setSystemUser(java.lang.String user)
                       throws javax.management.InvalidAttributeValueException

### getPasswordPolicy

    public weblogic.management.configuration.PasswordPolicyMBean getPasswordPolicy()

  Deprecated.
  Sets the password policy. This interface is used in Compatibility mode.

### setPasswordPolicy

    public void setPasswordPolicy(weblogic.management.configuration.PasswordPolicyMBean realm)
                           throws javax.management.InvalidAttributeValueException

### getServerSecurityRuntime

    public ServerSecurityRuntimeMBean getServerSecurityRuntime()

  Returns the state of security on the specified WebLogic Server. Returns null if the specified server is not running.

### setRealmSetup

    public void setRealmSetup(boolean disable)

### isCompatibilityMode

    public boolean isCompatibilityMode()

  Specifies whether migration from a WebLogic Server 6.x security configuration is enabled.

  A dynamic MBean attribute
  Default Value: false

### setCompatibilityMode

    public void setCompatibilityMode(boolean disable)

### setInteropEnabled

    public void setInteropEnabled(boolean disable)

### setInteropUsername

    public void setInteropUsername(java.lang.String username)
                            throws javax.management.InvalidAttributeValueException

### getConnectionFilterRules

    public java.lang.String[] getConnectionFilterRules()

  The list of rules for the system connection filter. If none are specified, all connections are accepted.

  The syntax of the rules is as follows:

  - Each rule must be written on a single line in the source code.
  - Tokens in a rule are separated by white space.
  - A pound sign (`#`) is the comment character. Everything after a pound sign on a line is ignored.
  - Whitespace before or after a rule is ignored.
  - Lines consisting only of whitespace or comments are skipped.

    All rules have the following format:

    `target` `localAddress` `localPort` `action` `protocols`

    where

    `target` specifies one or more servers to filter.

    `localAddress` defines the host address of the server. (If you specify an asterisk (`*`), the match returns all local IP addresses.)

    `localPort` defines the port on which the server is listening. (If you specify an asterisk, the match returna all available ports on the server).

    `action` specifies the action to perform. The value must be `allow` or `deny`).

    `protocols` is the list of protocol names to match. (One of the following protocols must be specified `http`, `https`, `t3`, `t3s`, `giop`, `giops`, `dcom`, or `ftp`.) If no protocol is defined, all protocols will match a rule.

    Two kinds of rules are recognized:

    - A fast rule applies to a hostname or IP address with an optional netmask. If a hostname corresponds to multiple IP addresses, multiple rules are generated (in no particular order). Netmasks can be specified either in numeric or dotted-quad form. For example:

      `dialup-555-1212.pa.example.net 127.0.0.1 7001 deny t3 t3s # http(s) OK 192.168.81.0/255.255.254.0 127.0.0.1 8001 allow # 23-bit netmask 192.168.0.0/16 127.0.0.1 8002 deny # like /255.255.0.0`

      Hostnames for fast rules are looked up once at server startup. While this design greatly reduces overhead at connect time, it can result in the filter obtaining out of date information about what addresses correspond to a host name. BEA Systems recommends using numeric IP addresses instead.

    - A slow rule applies to part of a domain name. Since a rule requires a connect-time DNS lookup on the client-side in order to perform a match, a slow rule may be much slower than the fast rule. Slow rules are also subject to DNS spoofing. Slow rules are specified as follows:

      `*.script-kiddiez.org 127.0.0.1 7001 deny`

      An asterisk only matches at the head of a pattern. If you specify an asterisk anywhere else in a rule, it is treated as part of the pattern. Note that the pattern will never match a domain name since an asterisk is not a legal part of a domain name.

    When a client connects to WebLogic Server, these rules are evaluated in the order in which they were written. The first rule to match determines how the connection is treated. If no rules match, the connection is permitted.

    If you want to further protect your server and only allow connections from certain addresses, you can specify `0.0.0.0/0 * * deny` as your last rule.

  A dynamic MBean attribute
  Default Value: null
  Legal Value: SecurityLegalHelper.isLegalFilterRules(self,value);

### setConnectionFilterRules

    public void setConnectionFilterRules(java.lang.String[] filterList)

### getConnectionLoggerEnabled

    public boolean getConnectionLoggerEnabled()

  Enables the logging of 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.

  A dynamic MBean attribute
  Default Value: false

### setConnectionLoggerEnabled

    public void setConnectionLoggerEnabled(boolean logging)
                                    throws javax.management.InvalidAttributeValueException

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| Documentation is available at http://e-docs.bea.com/wls/docs81
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD