XACMLRoleMapperMBean


Overview  |   Related MBeans  |   Attributes  |   Operations

Overview

The MBean that represents configuration information for the WebLogic Role Mapper Provider.

   
Fully Qualified Interface NameIf you use the getMBeanInfo operation in MBeanTypeServiceMBean, supply the following value as this MBean's fully qualified interface name:
weblogic.security.providers.xacml.authorization.XACMLRoleMapperMBean
Factory Methods No factory methods. Instances of this MBean are created automatically.
Access Points Inherited from RoleMapperMBean Because this MBean extends or implements RoleMapperMBean, you can also access this MBean by retrieving RoleMapperMBeans. The following attributes contain RoleMapperMBeans and its subtypes:


    Related MBeans

    This section describes attributes that provide access to other MBeans.


      Realm

      Returns the realm that contains this security provider. Returns null if this security provider is not contained by a realm.

             
      Privileges Read only
      TypeRealmMBean
      Relationship type: Reference.


      Attributes

      This section describes the following attributes:


      Description

      The description of your Weblogic XACML Role Mapping Provider.

             
      Privileges Read only
      Typejava.lang.String
      Default ValueWebLogic XACML Role Mapping Provider
      Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

      Name

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

      ProviderClassName

      The name of the Java class used to load the WebLogic XACML Role Mapper Provider.

             
      Privileges Read only
      Typejava.lang.String
      Default Valueweblogic.security.providers.xacml.authorization.XACMLRoleMapperProviderImpl
      Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

      RoleDeploymentEnabled

      Returns whether this Role Mapping provider stores roles that are created while deploying a Web application or EJB.

             
      Privileges Read/Write
      Typeboolean
      Default Valuetrue

      SupportedExportConstraints

      The security roles you want to be exported from this Role Mapping provider's database. If none are specified, all are exported.

             
      Privileges Read only
      Typeclass java.lang.String[]
      Default Value
      Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

      SupportedExportFormats

      The format of the file to export. The list of supported export formats is determined by this Role Mapping provider.

             
      Privileges Read only
      Typeclass java.lang.String[]
      Default Value XACML DefaultRoles
      Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

      SupportedImportConstraints

      The security roles that you want to be imported into this Role Mapping provider's database. If none are specified, all are imported.

             
      Privileges Read only
      Typeclass java.lang.String[]
      Default Value
      Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

      SupportedImportFormats

      The format of the file to import. The list of supported import formats is determined by the Role Mapping provider from which the security roles were originally exported.

             
      Privileges Read only
      Typeclass java.lang.String[]
      Default Value XACML DefaultRoles
      Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

      Version

      The version of your Weblogic XACML Role Mapping Provider.

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


      Operations

      This section describes the following operations:


      addPolicy

      Adds policy

         
      Operation Name"addPolicy"
      ParametersObject [] {  policystatus }

      where:

      • policy is an object of type com.bea.common.security.xacml.policy.Policy that specifies:

        Policy document

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

        Policy status

      SignatureString [] { "com.bea.common.security.xacml.policy.Policy", "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.CreateException
        CreateException Thrown if policy is invalid or store cannot be updated
      • weblogic.management.utils.AlreadyExistsException
        AlreadyExistsException Thrown if matching policy id and version already present in store

      addPolicy

      Adds policy

         
      Operation Name"addPolicy"
      ParametersObject [] {  policystatus }

      where:

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

        Policy document

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

        Policy status

      SignatureString [] { "java.lang.String", "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.CreateException
        CreateException Thrown if policy is invalid or store cannot be updated
      • weblogic.management.utils.AlreadyExistsException
        AlreadyExistsException Thrown if matching policy id and version already present in store

      addPolicy

      Adds policy. Policy is set to ACTIVE status.

         
      Operation Name"addPolicy"
      ParametersObject [] {  policy }

      where:

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

        Policy document

      SignatureString [] { "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.CreateException
        CreateException Thrown if policy is invalid or store cannot be updated
      • weblogic.management.utils.AlreadyExistsException
        AlreadyExistsException Thrown if matching policy id and version already present in store

      addPolicy

      Adds policy. Policy is set to ACTIVE status.

         
      Operation Name"addPolicy"
      ParametersObject [] {  policy }

      where:

      • policy is an object of type com.bea.common.security.xacml.policy.Policy that specifies:

        Policy document

      SignatureString [] { "com.bea.common.security.xacml.policy.Policy" }
      Returns void
      Exceptions
      • weblogic.management.utils.CreateException
        CreateException Thrown if policy is invalid or store cannot be updated
      • weblogic.management.utils.AlreadyExistsException
        AlreadyExistsException Thrown if matching policy id and version already present in store

      addPolicySet

      Adds policy set. Policy set is set to ACTIVE status.

         
      Operation Name"addPolicySet"
      ParametersObject [] {  set }

      where:

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

        Policy set document

      SignatureString [] { "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.CreateException
        CreateException Thrown if policy set is invalid or store cannot be updated
      • weblogic.management.utils.AlreadyExistsException
        AlreadyExistsException Thrown if matching policy set id and version already present in store

      addPolicySet

      Adds policy set. Policy set is set to ACTIVE status.

         
      Operation Name"addPolicySet"
      ParametersObject [] {  set }

      where:

      • set is an object of type com.bea.common.security.xacml.policy.PolicySet that specifies:

        Policy set document

      SignatureString [] { "com.bea.common.security.xacml.policy.PolicySet" }
      Returns void
      Exceptions
      • weblogic.management.utils.CreateException
        CreateException Thrown if policy set is invalid or store cannot be updated
      • weblogic.management.utils.AlreadyExistsException
        AlreadyExistsException Thrown if matching policy set id and version already present in store

      addPolicySet

      Adds policy set.

         
      Operation Name"addPolicySet"
      ParametersObject [] {  setstatus }

      where:

      • set is an object of type com.bea.common.security.xacml.policy.PolicySet that specifies:

        Policy set document

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

        Policy status enumeration

      SignatureString [] { "com.bea.common.security.xacml.policy.PolicySet", "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.CreateException
        CreateException Thrown if policy set is invalid or store cannot be updated
      • weblogic.management.utils.AlreadyExistsException
        AlreadyExistsException Thrown if matching policy set id and version already present in store

      addPolicySet

      Adds policy set.

         
      Operation Name"addPolicySet"
      ParametersObject [] {  setstatus }

      where:

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

        Policy set document

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

        Policy status enumeration

      SignatureString [] { "java.lang.String", "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.CreateException
        CreateException Thrown if policy set is invalid or store cannot be updated
      • weblogic.management.utils.AlreadyExistsException
        AlreadyExistsException Thrown if matching policy set id and version already present in store

      advance

      Advances the list to the next element in the list.

         
      Operation Name"advance"
      ParametersObject [] {  cursor }

      where:

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

        - The cursor returned from a previous list method.

      SignatureString [] { "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.InvalidCursorException

      close

      Indicates that the caller is finished using the list, and that the resources held on behalf of the list may be released. If the caller traverses through all the elements in the list, the caller need not call this method. In other words, it is used to let the caller close the list without reading each element that is returned.

         
      Operation Name"close"
      ParametersObject [] {  cursor }

      where:

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

        - The cursor returned from a previous list method.

      SignatureString [] { "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.InvalidCursorException

      createRole

      Creates role for a resource.

         
      Operation Name"createRole"
      ParametersObject [] {  resourceIdroleNameexpressionauxiliary }

      where:

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

        - The resource that scopes the new role. Each resource has its predefined 'hierachy'. This new role is applicable to all of the given resouce's descendants if any. A null indicates a global role, no scoping resource, which applies to all resources within the container.

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

        - The name of the role that this method creates. A null value will trigger NullPointerException.

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

        - The expression policy designates which user or group having this named 'role'. A null value indicates this role is not granted to anyone.

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

        - Auxiliary data to support WLP.

      SignatureString [] { "java.lang.String", "java.lang.String", "java.lang.String", "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.AlreadyExistsException
      • weblogic.management.utils.CreateException

      createRole

      Creates role for a resource.

         
      Operation Name"createRole"
      ParametersObject [] {  resourceIdroleNameexpression }

      where:

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

        - The resource that scopes the new role. Each resource has its predefined 'hierachy'. This new role is applicable to all of the given resource's descendants if any. A null indicates a global role, no scoping resource, which applies to all resources within the container.

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

        - The name of the role that this method creates. A null value will trigger NullPointerException.

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

        - The expression policy designates which user or group having this named 'role'. A null value indicates this role is not granted to anyone.

      SignatureString [] { "java.lang.String", "java.lang.String", "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.AlreadyExistsException
      • weblogic.management.utils.CreateException

      deletePolicy

      Deletes policy with given identifier and version.

         
      Operation Name"deletePolicy"
      ParametersObject [] {  identifierversion }

      where:

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

        Policy identifier

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

        Policy version

      SignatureString [] { "java.lang.String", "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.NotFoundException
        NotFoundException Thrown if matching policy id and version not present in store
      • weblogic.management.utils.RemoveException
        RemoveException Thrown if store cannot be updated

      deletePolicySet

      Deletes policy set with given identifier and version.

         
      Operation Name"deletePolicySet"
      ParametersObject [] {  identifierversion }

      where:

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

        Policy set identifier

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

        Policy set version

      SignatureString [] { "java.lang.String", "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.NotFoundException
        NotFoundException Thrown if matching policy set id and version not present in store
      • weblogic.management.utils.RemoveException
        RemoveException Thrown if store cannot be updated

      evaluate

      No description provided.

         
      Operation Name"evaluate"
      ParametersObject [] {  requeststore }

      where:

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

        - the XACML Request document

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

        - Policy or PolicySet file-system directory name containing XACML policies and policy sets relevant to decision

      SignatureString [] { "java.lang.String", "java.lang.String" }
      ReturnsString
      Exceptions
      • weblogic.management.utils.InvalidParameterException

      evaluate

      No description provided.

         
      Operation Name"evaluate"
      ParametersObject [] {  requestFileresponseFilestore }

      where:

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

        - the file name containing the XACML Request document

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

        - the file name where the XACML Response document will be written

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

        - Policy or PolicySet file-system directory name containing XACML policies and policy sets relevant to decision

      SignatureString [] { "java.lang.String", "java.lang.String", "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.InvalidParameterException

      evaluate

      No description provided.

         
      Operation Name"evaluate"
      ParametersObject [] {  request }

      where:

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

        - the XACML Request document

      SignatureString [] { "java.lang.String" }
      ReturnsString
      Exceptions
      • weblogic.management.utils.InvalidParameterException

      exportData

      Exports provider specific data in a specified format. When errors occur, the MBean throws an ErrorCollectionException containing a list of java.lang.Exceptions, where the text of each exception describes the error.

         
      Operation Name"exportData"
      ParametersObject [] {  formatfilenameconstraints }

      where:

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

        - The format for exporting provider specific data.

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

        - The full path to the filename used to write data.

      • constraints is an object of type java.util.Properties that specifies:

        - The constraints to be used when exporting data. A null value indicates that all data will be exported.

      SignatureString [] { "java.lang.String", "java.lang.String", "java.util.Properties" }
      Returns void
      Exceptions
      • weblogic.management.utils.InvalidParameterException
      • weblogic.management.utils.ErrorCollectionException

      exportResource

      Exports provider specific role data using an LDAP CN search filter to specify the resources for export. When errors occur, the MBean throws an ErrorCollectionException containing a list of <code>java.lang.Exceptions</code;>.

         
      Operation Name"exportResource"
      ParametersObject [] {  filenamecn }

      where:

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

        - The full path to the filename used to write data.

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

        - The LDAP CN to be used when exporting data.

      SignatureString [] { "java.lang.String", "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.InvalidParameterException
      • weblogic.management.utils.ErrorCollectionException

      getCurrentProperties

      The properties of the current item in the list. Returns null if there is no current item.

         
      Operation Name"getCurrentProperties"
      ParametersObject [] {  cursor }

      where:

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

        - The cursor returned from a previous list method.

      SignatureString [] { "java.lang.String" }
      ReturnsProperties
      Exceptions
      • weblogic.management.utils.InvalidCursorException

      getPolicySetStatus

      Returns status for policy set identified by identifier and version

         
      Operation Name"getPolicySetStatus"
      ParametersObject [] {  identifierversion }

      where:

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

        Policy set identifier

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

        Policy set version

      SignatureString [] { "java.lang.String", "java.lang.String" }
      ReturnsString
      Exceptions
      • weblogic.management.utils.NotFoundException
        NotFoundExeption Thrown if matching policy set id and version not present in store

      getPolicyStatus

      Returns status for policy identified by identifier and version

         
      Operation Name"getPolicyStatus"
      ParametersObject [] {  identifierversion }

      where:

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

        Policy identifier

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

        Policy version

      SignatureString [] { "java.lang.String", "java.lang.String" }
      ReturnsString
      Exceptions
      • weblogic.management.utils.NotFoundException
        NotFoundExeption Thrown if matching policy id and version not present in store

      getRegisteredPredicates

      Returns an array of class names of the registered predicates.

         
      Operation Name"getRegisteredPredicates"
      ParametersObject [] {  nameFilter }

      where:

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

        A string filter which can contain the wildcard (*) character and the backslash (/) escape character.

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

      getRole

      Obtain a role definition.

      A null is returned when no role is found.

      The Properties is the same as those returned from the PropertiesListerMBean.

         
      Operation Name"getRole"
      ParametersObject [] {  resourceIdroleName }

      where:

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

        - a security resource identifier.

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

        - a role name.

      SignatureString [] { "java.lang.String", "java.lang.String" }
      ReturnsProperties
      Exceptions
      • weblogic.management.utils.InvalidParameterException

      getRoleAuxiliary

      Get auxiliary role for a resource.

         
      Operation Name"getRoleAuxiliary"
      ParametersObject [] {  resourceIdroleName }

      where:

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

        - The resource that scopes the role.

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

        - The name of the role that this method sets the auxiliary on. A null value will trigger NullPointerException.

      SignatureString [] { "java.lang.String", "java.lang.String" }
      ReturnsString
      Exceptions
      • weblogic.management.utils.NotFoundException
      • javax.management.MBeanException

      getRoleExpression

      Returns the expression that defines the role granting policy.

         
      Operation Name"getRoleExpression"
      ParametersObject [] {  resourceIdroleName }

      where:

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

        - The resource that scopes the new role. Each resource has its predefined 'hierachy'. This new role is applicable to all of the given resource's descendants if any. A null indicates a global role, no scoping resource, which applies to all resources within the container.

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

        - The role for which this method returns the role granding expression. A null value will trigger NullPointerException.

      SignatureString [] { "java.lang.String", "java.lang.String" }
      ReturnsString
      Exceptions
      • weblogic.management.utils.NotFoundException

      getRoleNames

      Returns array of resource/role name tuples of roles defined in the scope of resources of the given type or global roles, when the type is null.

         
      Operation Name"getRoleNames"
      ParametersObject [] {  resourceType }

      where:

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

        - The resource type, or null to get global roles

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

      getRoleScopedByResource

      Obtain a role definition for a role scoped by a specified resource. This may result in a global role definition.

      If the role is defined at the specified resource then a call to getRole would return the same result.

      A null is returned when no role is found.

      The Properties object is the same as those returned from the PropertiesListerMBean.

         
      Operation Name"getRoleScopedByResource"
      ParametersObject [] {  resourceIdroleName }

      where:

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

        - a security resource identifier.

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

        - a role name.

      SignatureString [] { "java.lang.String", "java.lang.String" }
      ReturnsProperties
      Exceptions
      • weblogic.management.utils.InvalidParameterException

      haveCurrent

      Returns true if there are more objects in the list, and false otherwise.

         
      Operation Name"haveCurrent"
      ParametersObject [] {  cursor }

      where:

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

        - The cursor returned from a previous list method.

      SignatureString [] { "java.lang.String" }
      Returns boolean
      Exceptions
      • weblogic.management.utils.InvalidCursorException

      importData

      Imports provider specific data from a specified format. When errors occur, the MBean throws an ErrorCollectionException containing a list of java.lang.Exceptions, where the text of each exception describes the error.

         
      Operation Name"importData"
      ParametersObject [] {  formatfilenameconstraints }

      where:

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

        - The format for importing provider specific data.

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

        - The full path to the filename used to read data.

      • constraints is an object of type java.util.Properties that specifies:

        - The constraints to be used when importing data. A null value indicates that all data will be imported.

      SignatureString [] { "java.lang.String", "java.lang.String", "java.util.Properties" }
      Returns void
      Exceptions
      • weblogic.management.utils.InvalidParameterException
      • weblogic.management.utils.ErrorCollectionException

      isRegisteredPredicate

      Specifies whether or not the predicate with specified class name is registered.

         
      Operation Name"isRegisteredPredicate"
      ParametersObject [] {  predicateClassName }

      where:

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

        The name of the Java class that implements the predicate.

      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
      Exceptions
      • java.lang.IllegalArgumentException

      listAllPolicies

      Returns cursor listing all policies

         
      Operation Name"listAllPolicies"
      Parametersnull
      Signaturenull
      ReturnsString
      Exceptions
      • weblogic.management.utils.NotFoundException
        NotFoundException Thrown if no policies are found

      listAllPoliciesAsString

      Returns cursor listing all policies. Policies are returned as java.lang.String.

         
      Operation Name"listAllPoliciesAsString"
      Parametersnull
      Signaturenull
      ReturnsString
      Exceptions
      • weblogic.management.utils.NotFoundException
        NotFoundException Thrown if no policies are found

      listAllPolicySets

      Returns cursor listing all policy sets

         
      Operation Name"listAllPolicySets"
      Parametersnull
      Signaturenull
      ReturnsString
      Exceptions
      • weblogic.management.utils.NotFoundException
        NotFoundException Thrown if no policy sets are found

      listAllPolicySetsAsString

      Returns cursor listing all policy sets. Policy sets are returned as java.lang.String.

         
      Operation Name"listAllPolicySetsAsString"
      Parametersnull
      Signaturenull
      ReturnsString
      Exceptions
      • weblogic.management.utils.NotFoundException
        NotFoundException Thrown if no policy sets are found

      listAllRoles

      Obtain an unsorted list of role definitions.

      This method returns a cursor that you can pass to the methods from weblogic.management.utils.PropertiesListerMBean (which this MBean extends) to iterate through the returned list.

         
      Operation Name"listAllRoles"
      ParametersObject [] {  maximumToReturn }

      where:

      • maximumToReturn is an object of type java.lang.Integer that specifies:

        - The maximum number of entires to return. Use 0 to return all role definitions.

      SignatureString [] { "java.lang.Integer" }
      ReturnsString
      Exceptions
      • weblogic.management.utils.NotFoundException

      listAllRolesAndURIs

      List all Role and URI pairings that have policy defined for the specified application and context path.

         
      Operation Name"listAllRolesAndURIs"
      ParametersObject [] {  applicationcontextPath }

      where:

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

        - The name of the deployed application.

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

        - The context path for the application.

      SignatureString [] { "java.lang.String", "java.lang.String" }
      Returns class

      listChildRoles

      Obtain a list of role definitions for the children of a resource.

      This method returns a cursor that you can pass to the methods from weblogic.management.utils.PropertiesListerMBean (which this MBean extends) to iterate through the returned list.

         
      Operation Name"listChildRoles"
      ParametersObject [] {  resourceIdmaximumToReturn }

      where:

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

        - a security resource identifier.

      • maximumToReturn is an object of type java.lang.Integer that specifies:

        - The maximum number of entires to return. Use 0 to return all role definitions.

      SignatureString [] { "java.lang.String", "java.lang.Integer" }
      ReturnsString
      Exceptions
      • weblogic.management.utils.NotFoundException
      • weblogic.management.utils.InvalidParameterException

      listRepeatingActionsRoles

      Obtain a list of role definitions for the actions that are repeating on a resource.

      This method returns a cursor that you can pass to the methods from weblogic.management.utils.PropertiesListerMBean (which this MBean extends) to iterate through the returned list.

         
      Operation Name"listRepeatingActionsRoles"
      ParametersObject [] {  resourceIdmaximumToReturn }

      where:

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

        - a security resource identifier.

      • maximumToReturn is an object of type java.lang.Integer that specifies:

        - The maximum number of entires to return. Use 0 to return all role definitions.

      SignatureString [] { "java.lang.String", "java.lang.Integer" }
      ReturnsString
      Exceptions
      • weblogic.management.utils.NotFoundException
      • weblogic.management.utils.InvalidParameterException

      listRoles

      Obtain a list of role definitions for a specific resource.

      This method returns a cursor that you can pass to the methods from weblogic.management.utils.PropertiesListerMBean (which this MBean extends) to iterate through the returned list.

         
      Operation Name"listRoles"
      ParametersObject [] {  resourceIdmaximumToReturn }

      where:

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

        - a security resource identifier.

      • maximumToReturn is an object of type java.lang.Integer that specifies:

        - The maximum number of entires to return. Use 0 to return all role definitions.

      SignatureString [] { "java.lang.String", "java.lang.Integer" }
      ReturnsString
      Exceptions
      • weblogic.management.utils.NotFoundException
      • weblogic.management.utils.InvalidParameterException

      listRolesByApplication

      Obtain an list of role definitions by application name.

      This method returns a cursor that you can pass to the methods from weblogic.management.utils.PropertiesListerMBean (which this MBean extends) to iterate through the returned list.

         
      Operation Name"listRolesByApplication"
      ParametersObject [] {  applicationNamemaximumToReturn }

      where:

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

        - The name of the application.

      • maximumToReturn is an object of type java.lang.Integer that specifies:

        - The maximum number of entires to return. Use 0 to return all role definitions.

      SignatureString [] { "java.lang.String", "java.lang.Integer" }
      ReturnsString
      Exceptions
      • weblogic.management.utils.NotFoundException
      • weblogic.management.utils.InvalidParameterException

      listRolesByComponent

      Obtain an list of role definitions for a specific J2EE component.

      This method returns a cursor that you can pass to the methods from weblogic.management.utils.PropertiesListerMBean (which this MBean extends) to iterate through the returned list.

         
      Operation Name"listRolesByComponent"
      ParametersObject [] {  componentNamecomponentTypeapplicationNamemaximumToReturn }

      where:

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

        - The name of the component.

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

        - The component type.

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

        - The name of the application.

      • maximumToReturn is an object of type java.lang.Integer that specifies:

        - The maximum number of entires to return. Use 0 to return all role definitions.

      SignatureString [] { "java.lang.String", "java.lang.String", "java.lang.String", "java.lang.Integer" }
      ReturnsString
      Exceptions
      • weblogic.management.utils.NotFoundException
      • weblogic.management.utils.InvalidParameterException

      listRolesByResourceType

      Obtain an list of role definitions by resource type.

      This method returns a cursor that you can pass to the methods from weblogic.management.utils.PropertiesListerMBean (which this MBean extends) to iterate through the returned list.

         
      Operation Name"listRolesByResourceType"
      ParametersObject [] {  resourceTypemaximumToReturn }

      where:

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

        - The name of the resource type specified by a weblogic.security.spi.Resource object.

      • maximumToReturn is an object of type java.lang.Integer that specifies:

        - The maximum number of entires to return. Use 0 to return all role definitions.

      SignatureString [] { "java.lang.String", "java.lang.Integer" }
      ReturnsString
      Exceptions
      • weblogic.management.utils.NotFoundException
      • weblogic.management.utils.InvalidParameterException

      listRolesForResource

      Lists the role names that are scoped by a resource. Returns a null list if there are no roles under this resource scoping.

         
      Operation Name"listRolesForResource"
      ParametersObject [] {  resourceId }

      where:

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

        - A resource identifier. A null value specifies a global role.

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

      modifyPolicy

      Updates policy. This operation does not change the status of policy. already present in the store.

         
      Operation Name"modifyPolicy"
      ParametersObject [] {  policy }

      where:

      • policy is an object of type com.bea.common.security.xacml.policy.Policy that specifies:

        Policy document

      SignatureString [] { "com.bea.common.security.xacml.policy.Policy" }
      Returns void
      Exceptions
      • weblogic.management.utils.CreateException
        CreateException Thrown if policy is invalid or store cannot be updated
      • weblogic.management.utils.NotFoundException
        NotFoundException Thrown if matching policy id and version not present in store

      modifyPolicy

      Updates policy and status.

         
      Operation Name"modifyPolicy"
      ParametersObject [] {  policystatus }

      where:

      • policy is an object of type com.bea.common.security.xacml.policy.Policy that specifies:

        Policy document

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

        Policy status enumeration

      SignatureString [] { "com.bea.common.security.xacml.policy.Policy", "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.CreateException
        CreateException Thrown if policy is invalid or store cannot be updated
      • weblogic.management.utils.NotFoundException
        NotFoundException Thrown if matching policy id and version not present in store

      modifyPolicy

      Updates policy and status.

         
      Operation Name"modifyPolicy"
      ParametersObject [] {  policystatus }

      where:

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

        Policy document

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

        Policy status enumeration

      SignatureString [] { "java.lang.String", "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.CreateException
        CreateException Thrown if policy is invalid or store cannot be updated
      • weblogic.management.utils.NotFoundException
        NotFoundException Thrown if matching policy id and version not present in store

      modifyPolicy

      Updates policy. This operation does not change the status of policy. already present in the store.

         
      Operation Name"modifyPolicy"
      ParametersObject [] {  policy }

      where:

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

        Policy document

      SignatureString [] { "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.CreateException
        CreateException Thrown if policy is invalid or store cannot be updated
      • weblogic.management.utils.NotFoundException
        NotFoundException Thrown if matching policy id and version not present in store

      modifyPolicySet

      Updates policy set. This operation does not change the status of policy set. already present in the store.

         
      Operation Name"modifyPolicySet"
      ParametersObject [] {  set }

      where:

      • set is an object of type com.bea.common.security.xacml.policy.PolicySet that specifies:

        Policy set document

      SignatureString [] { "com.bea.common.security.xacml.policy.PolicySet" }
      Returns void
      Exceptions
      • weblogic.management.utils.CreateException
        CreateException Thrown if policy set is invalid or store cannot be updated
      • weblogic.management.utils.NotFoundException
        NotFoundException Thrown if matching policy set id and version not present in store

      modifyPolicySet

      Updates policy set and status.

         
      Operation Name"modifyPolicySet"
      ParametersObject [] {  setstatus }

      where:

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

        Policy set document

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

        Policy status enumeration

      SignatureString [] { "java.lang.String", "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.CreateException
        CreateException Thrown if policy set is invalid or store cannot be updated
      • weblogic.management.utils.NotFoundException
        NotFoundException Thrown if matching policy set id and version not present in store

      modifyPolicySet

      Updates policy set and status.

         
      Operation Name"modifyPolicySet"
      ParametersObject [] {  setstatus }

      where:

      • set is an object of type com.bea.common.security.xacml.policy.PolicySet that specifies:

        Policy set document

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

        Policy status enumeration

      SignatureString [] { "com.bea.common.security.xacml.policy.PolicySet", "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.CreateException
        CreateException Thrown if policy set is invalid or store cannot be updated
      • weblogic.management.utils.NotFoundException
        NotFoundException Thrown if matching policy set id and version not present in store

      modifyPolicySet

      Updates policy set. This operation does not change the status of policy set. already present in the store.

         
      Operation Name"modifyPolicySet"
      ParametersObject [] {  set }

      where:

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

        Policy set document

      SignatureString [] { "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.CreateException
        CreateException Thrown if policy set is invalid or store cannot be updated
      • weblogic.management.utils.NotFoundException
        NotFoundException Thrown if matching policy set id and version not present in store

      modifyPolicySetStatus

      Sets status for policy set identified by identifier and version

         
      Operation Name"modifyPolicySetStatus"
      ParametersObject [] {  identifierversionstatus }

      where:

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

        Policy set identifier

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

        Policy set version

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

        Policy status enumeration

      SignatureString [] { "java.lang.String", "java.lang.String", "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.CreateException
        CreateException Thrown if store cannot be updated
      • weblogic.management.utils.NotFoundException
        NotFoundException Thrown if matching policy set id and version not present in store

      modifyPolicyStatus

      Sets status for policy identified by identifier and version

         
      Operation Name"modifyPolicyStatus"
      ParametersObject [] {  identifierversionstatus }

      where:

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

        Policy identifier

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

        Policy version

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

        Policy status enumeration

      SignatureString [] { "java.lang.String", "java.lang.String", "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.CreateException
        CreateException Thrown if store cannot be updated
      • weblogic.management.utils.NotFoundException
        NotFoundException Thrown if matching policy id and version not present in store

      readPolicy

      Reads policy with specified identifier and version

         
      Operation Name"readPolicy"
      ParametersObject [] {  identifierversion }

      where:

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

        Policy identifier

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

        Policy version

      SignatureString [] { "java.lang.String", "java.lang.String" }
      ReturnsPolicy
      Exceptions
      • weblogic.management.utils.NotFoundException
        NotFoundException Thrown if matching policy is not found

      readPolicyAsString

      Reads policy with specified identifier and version

         
      Operation Name"readPolicyAsString"
      ParametersObject [] {  identifierversion }

      where:

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

        Policy identifier

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

        Policy version

      SignatureString [] { "java.lang.String", "java.lang.String" }
      ReturnsString
      Exceptions
      • weblogic.management.utils.NotFoundException
        NotFoundException Thrown if matching policy is not found

      readPolicySet

      Reads policy set with specified identifier and version

         
      Operation Name"readPolicySet"
      ParametersObject [] {  identifierversion }

      where:

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

        Policy set identifier

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

        Policy set version

      SignatureString [] { "java.lang.String", "java.lang.String" }
      ReturnsPolicySet
      Exceptions
      • weblogic.management.utils.NotFoundException
        NotFoundException Thrown if matching policy set is not found

      readPolicySetAsString

      Reads policy set with specified identifier and version

         
      Operation Name"readPolicySetAsString"
      ParametersObject [] {  identifierversion }

      where:

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

        Policy set identifier

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

        Policy set version

      SignatureString [] { "java.lang.String", "java.lang.String" }
      ReturnsString
      Exceptions
      • weblogic.management.utils.NotFoundException
        NotFoundException Thrown if matching policy set is not found

      registerPredicate

      Registers a new predicate with the specified class name.

         
      Operation Name"registerPredicate"
      ParametersObject [] {  predicateClassName }

      where:

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

        The name of the Java class that implements the predicate.

      SignatureString [] { "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.InvalidPredicateException
      • weblogic.management.utils.AlreadyExistsException

      removeRole

      Removes a role from a resource.

         
      Operation Name"removeRole"
      ParametersObject [] {  resourceIdroleName }

      where:

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

        - The resource that scopes the role. Each role has a scoping resource. A null indicates a global role.

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

        - The role that this method removes. A null value will trigger NullPointerException.

      SignatureString [] { "java.lang.String", "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.NotFoundException
      • weblogic.management.utils.RemoveException

      roleExists

      Indicates whether a role exists.

         
      Operation Name"roleExists"
      ParametersObject [] {  resourceIdroleName }

      where:

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

        - The resource that scopes the role. Each role has a scoping resource. A null indicates a global role.

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

        - The role for which this method searches.

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

      setRoleAuxiliary

      Set auxiliary role for a resource.

         
      Operation Name"setRoleAuxiliary"
      ParametersObject [] {  resourceIdroleNameauxiliary }

      where:

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

        - The resource that scopes the role.

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

        - The name of the role that this method sets the auxiliary on. A null value will trigger NullPointerException.

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

        - Auxiliary data to support WLP.

      SignatureString [] { "java.lang.String", "java.lang.String", "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.AlreadyExistsException
      • weblogic.management.utils.CreateException
      • javax.management.MBeanException

      setRoleExpression

      Sets the policy expression for a role.

         
      Operation Name"setRoleExpression"
      ParametersObject [] {  resourceIdroleNameexpression }

      where:

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

        - The resource that scopes the new role. Each resource has its predefined 'hierachy'. This role is applicable to all of the given resource's descendants if any. A null indicates a global role, no scoping resource, which applies to all resources within the container.

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

        - The name of the role for which this method replaces a policy. A null value will trigger NullPointerException.

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

        - The expression policy designates which user or group having this named 'role'. A null value indicates this role is not granted to anyone.

      SignatureString [] { "java.lang.String", "java.lang.String", "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.NotFoundException
      • weblogic.management.utils.CreateException

      unregisterPredicate

      Unregisters the currently registered predicate.

         
      Operation Name"unregisterPredicate"
      ParametersObject [] {  predicateClassName }

      where:

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

        The name of the Java class that implements predicate to be unregistered.

      SignatureString [] { "java.lang.String" }
      Returns void
      Exceptions
      • weblogic.management.utils.NotFoundException

      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
      Exceptions
      • java.lang.IllegalArgumentException
        UnsupportedOperationException if called on a runtime implementation.

      wls_getDisplayName

      Returns the display name of an MBean.

      Deprecated 9.0.0.0

         
      Operation Name"wls_getDisplayName"
      Parametersnull
      Signaturenull
      ReturnsString