Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Administration Guide

Admin Console Tasks for JACC Providers

ProcedureTo create a JACC provider

JACC (Java Authorization Contract for Containers) is part of the J2EE 1.4 specification that defines an interface for pluggable authorization providers. This enables the administrator to set up third-party plug in modules to perform authorization. By default, the Application Server provides a simple, JACC-compliant file-based authorization engine.

  1. In the Admin Console tree component, expand the Configurations node.

  2. Select the instance to configure:

    • To configure a particular instance, expand the instance’s config node. For example, the default instance, server, expand the server-config node.

    • To configure the default settings for all instances, expand the default-config node.

  3. Expand the Security node.

  4. Select the JACC Providers node.

  5. On the JACC Providers page, click New.

  6. On the Create JACC Provider page, enter the following:

    • Name – The name to use to identify this provider.

    • Policy Configuration – The name of the class that implements the policy configuration factory. The default provider uses com.sun.enterprise.security.provider.PolicyConfigurationFactoryImpl.

    • Policy Provider – The name of the class that implements the policy factory. The default provider uses com.sun.enterprise.security.provider.PolicyWrapper.

  7. Add properties to the provider by clicking the Add Property button. Valid properties include:

    • repository – the directory that contains the policy file. For the default provider, this value is ${com.sun.aas.instanceRoot}/generated/policy.

  8. Click OK to save this configuration, or click Cancel to quit without saving.

ProcedureTo edit a JACC provider

  1. In the Admin Console tree component, expand the Configurations node.

  2. Select the instance to configure:

    • To configure a particular instance, expand the instance’s config node. For example, the default instance, server, expand the server-config node.

    • To configure the default settings for all instances, expand the default-config node.

  3. Expand the Security node.

  4. Expand the JACC Providers node.

  5. Select the node of the JACC provider to be edited.

  6. On the Edit JACC Provider page, modify the provider information as desired:

    • Policy Configuration – The name of the class that implements the policy configuration factory.

    • Policy Provider – The name of the class that implements the policy factory.

  7. To add properties, click the Add button. Enter the name and value for the property. Valid entries include:

    • repository – the directory that contains the policy file. For the default provider, this value is ${com.sun.aas.instanceRoot}/generated/policy.

  8. To delete an existing property, click in the checkbox to the left of the property, then click Delete Properties.

  9. Click Save to save or click the browser’s back button to cancel without saving.

ProcedureTo delete a JACC provider

  1. In the Admin Console tree component, expand the Configurations node.

  2. Select the instance to configure:

    • To configure a particular instance, expand the instance’s config node. For example, the default instance, server, expand the server-config node.

    • To configure the default settings for all instances, expand the default-config node.

  3. Expand the Security node.

  4. Select the JACC Providers node.

  5. Click in the checkbox to the left of the JACC provider to be deleted.

  6. Click Delete.

ProcedureTo set the active JACC provider

  1. In the Admin Console tree component, expand the Configurations node.

  2. Select the instance to configure:

    • To configure a particular instance, expand the instance’s config node. For example, the default instance, server, expand the server-config node.

    • To configure the default settings for all instances, expand the default-config node.

  3. Select the Security node.

    The Security page displays.

  4. In the JACC field, enter the name of the JACC provider to be used by the server.

    If you don’t know which JACC providers are available, expand the JACC Provider component in the tree to view all configured JACC providers.

  5. Select Save to save the changes or Load Defaults to return to the default values.

  6. Restart the Application Server if Restart Required displays in the console.