38 Managing Service and Reference Binding Components

This chapter describes how to manage policies for web service and JCA adapter service and reference binding components in SOA composite applications and publish service binding components to the Universal Description, Discovery, and Integration (UDDI) registry from a registered UDDI source.

This chapter includes the following sections:

Notes:

  • Oracle SOA Suite does not support multiple bindings for service or reference binding components (for example, specifying both SOAP 1.1 and SOAP 1.2 in the composite.xml file). Support is only provided for a single web service binding per service or reference. If you specify multiple bindings, remove all but one and redeploy your SOA composite application.

  • The only type of binding component to which you can attach a policy is a web service. If you click the Policies tab for another type of binding component, such as a JCA adapter, ADF-BC service, or EJB service, the following message is displayed:

    Policies can be attached to web service bindings and SOA
    components.
    

For more information, see the following documentation:

38.1 Managing Binding Component Policies

You can attach and detach security policies to and from binding components included in a currently deployed SOA composite application. Policies apply security to the delivery of messages. Oracle Fusion Middleware uses a policy-based model to manage web services.

Note:

Before attaching policies, see Oracle Fusion Middleware Security and Administrator's Guide for Web Services for definitions of available policies and details about which ones to use in your environment.

To manage binding component policies:

  1. Access this page through one of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Select Home.

    2. Select the Deployed Composites tab.

    3. In the Composite section, select a specific SOA composite application.

    1. Under soa-infra, expand the partition.

    2. Select a specific SOA composite application.


    The Dashboard page for the selected SOA composite application appears. The Services and References section of this page displays the binding components being used in the application.

  2. In the Services and References section, select a service or reference.

  3. Click Policies.

    The Policies page enables you to view the globally-attached and directly-attached policies, and to attach or detach security policies to and from a service or reference binding component:

    • The Globally Attached Policies table displays the globally-attached policy name, the policy set, the category (Management, Reliable Messaging, MTOM Attachment, Security, or WS Addressing), the violations since the SOA Infrastructure was last restarted, and the authentication, authorization, confidentiality, and integrity failures since the SOA Infrastructure was last restarted.

      Policy sets provide a means to attach policies globally to a range of endpoints of the same type. Attaching policies globally using policy sets enables an administrator to ensure that all subjects are secured in situations in which the developer, assembler, or deployer did not explicitly specify the policies to attach. Policies that are attached using a policy set are considered externally attached. For information about creating and managing policy sets, see Chapter "Creating and Managing Policy Sets" of Oracle Fusion Middleware Security and Administrator's Guide for Web Services.

    • The Directly Attached Policies table displays the directly-attached policy name, the policy reference status (enabled or disabled), the category, the violations since the SOA Infrastructure was last restarted, and the authentication, authorization, confidentiality, and integrity failures since the SOA Infrastructure was last restarted.

  4. Description of bc_policies.gif follows
    Description of the illustration bc_policies.gif

  5. In the Directly Attached Policies section, click Attach/Detach.

    If multiple components are available, you are prompted to select the service or component for which to perform the attachment or detachment.

    Note:

    If you attach a policy to a service binding component (client) and initiate an instance of the SOA composite application in the Test Web Service page, and the policy attachment fails, an Oracle Web Services Manager (OSWM) policy error is not generated and viewable in Oracle Enterprise Manager Fusion Middleware Control.

    If the same SOA composite application instance is initiated externally, a policy error is generated and viewable in Oracle Enterprise Manager Fusion Middleware Control.

    For service components (such as a BPEL process) or reference binding components, the policy error is always generated and viewable, regardless of whether the application instance was initiated externally or internally through the Test Web Service page.

  6. Select the service or component to which to attach or detach a policy.

    This invokes a dialog for attaching or detaching policies.

    Policies currently attached appear in the Attached Policies section. Additional policies available for attachment appear in the Available Policies section.

  7. Select policies to attach that are appropriate to your environment.

  8. Click Attach.

  9. When you are finished attaching policies, click Validate.

  10. If an error message appears, make the necessary corrections until you no longer have any validation errors.

    The attached policy is displayed in the policies table.

  11. Click OK.

For more information, see the following documentation:

38.1.1 Override Policy Configuration Property Values

Your environment may include multiple servers with the same policies. However, each server may have their own specific policy requirements. To satisfy your runtime requirements, you can override the property values for some management and security policies attached to service and reference binding components.

  1. Follow the instructions in Section 38.1, "Managing Binding Component Policies" to attach a policy to a service or reference binding component.

  2. Select the attached policy in the table.

    The Security Configuration Details table is displayed at the bottom of the page.

    Description of bc_policies2.gif follows
    Description of the illustration bc_policies2.gif

  3. In the Value field, enter a value to override the default value in the Original Value column.

  4. Click Apply.

For more information on overriding policy values, see Oracle Fusion Middleware Security and Administrator's Guide for Web Services.

38.2 Publishing Web Services to the UDDI Registry

You can publish service binding components to the UDDI registry from a registered UDDI source.

Notes:

  • You cannot publish a reference binding component to the UDDI registry.

  • You can only publish web services to the UDDI registry. For example, you cannot publish a JCA adapter.

For information about the Oracle Service Registry:

  1. Visit the following URL:

    http://www.oracle.com/technetwork/middleware/registry/overview/index.html
    
  2. Click the Products tab.

  3. Click Governance.

For information about Oracle Enterprise Repository, see Oracle Fusion Middleware Configuration Guide for Oracle Enterprise Repository and Oracle Fusion Middleware Integration Guide for Oracle Enterprise Repository.

For more information about publishing web services to the UDDI registry, see Oracle Fusion Middleware Security and Administrator's Guide for Web Services.

38.2.1 Configuring the Environment for Publishing Web Services to UDDI

Before you can publish a web service to the UDDI registry, you must configure your environment.

If your SOA Infrastructure installation is behind a firewall, the Oracle Enterprise Manager Fusion Middleware Control managed server must have a proxy server configured for outbound URL connections.

To configure the environment for publishing web services to UDDI:

  1. Configure the proxy server setting in either of the following ways:

    In the following file:

    1. Open the FMW_Home/user_projects/domains/soainfra/bin/setDomainEnv.sh file for Linux (or setDomainEnv.bat for Windows operating systems).

    2. Enter the following syntax and provide host, port, and proxy host details appropriate to your environment:

      EXTRA_JAVA_PROPERTIES="${EXTRA_JAVA_PROPERTIES} -DproxySet=true
      -Dhttp.proxyHost=www-myproxy.us.mycompany.com -Dhttp.proxyPort=80
      -Dhttp.nonProxyHosts=localhost|$HOST_IP_ADDRESS|$HOSTNAME|*.us.mycompany.com"
      export EXTRA_JAVA_PROPERTIES
      
    3. Run setDomainEnv.sh or setDomainEnv.bat.

    With an environment variable:

    1. Set the PROXY_SETTINGS environment variable before starting Oracle WebLogic Server.

      setenv PROXY_SETTINGS "-DproxySet=true
      -Dhttp.proxyHost=www-myproxy.us.mycompany.com -Dhttp.proxyPort=80
       -Dhttp.nonProxyHosts=localhost|*.us.mycompany.com
        |0:0:0:0:0:0:0:1|fe80:0:0:0:250:56ff:fe31"
      

You must set up a UDDI source to use for publication.

  1. In the navigator, expand Weblogic Domain.

  2. Right-click soainfra and select Web Services > Registered Services.

    The Registered Sources and Services page appears.

  3. In the Sources section, click Register Web Services.

    The Register New Source dialog appears.

    Description of bc_pubuddi3.gif follows
    Description of the illustration bc_pubuddi3.gif

  4. Enter the following information:

    Field Description

    Name

    Enter a descriptive name for the service.

    Description

    Enter a descriptive name for the UDDI source to which to publish the WSDL.

    Type

    Select UDDI v3 registry import.

    Source Location

    Enter the source location. For example:

    http://myhost.us.mycompany.com:7001/registry/uddi/inquiry
    

    Publication

    Select the Enable checkbox.

    Publication URL

    Enter the publication URL. For example:

    http://myhost.us.mycompany.com:7001/registry/uddi/publishing
    

    Security URL

    Enter the security URL. For example:

    http://myhost.us.mycompany.com:7001/registry/uddi/security
    

    User ID

    Enter admin.

    Password

    Enter the user ID password.


  5. Click OK.

38.2.2 Publishing a Web Service to the UDDI Registry

Note:

You can publish web services to default Oracle Service Registry businesses from Oracle Enterprise Manager Fusion Middleware Control. To publish to nondefault businesses, use the publish option in Oracle Service Registry.

For more information about Oracle Service Registry, including documentation, visit the following URL:

http://www.oracle.com/technetwork/middleware/registry/overview/index.html

To publish a web service to the UDDI registry:

  1. Access this page through one of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Select Services and References.

    1. Right-click soa-infra.

    2. Select Services and References.


    The Services page displays details about the names and types of the services, the SOA composite applications in which the services are used, the partition in which the composite is deployed, the total number of messages processed, the average processing time, and the number of faults occurring in the services.

  2. In the Service table, select a service to publish to the UDDI registry.

  3. From the Actions list, select Publish To UDDI.

    Description of bc_pubuddi.gif follows
    Description of the illustration bc_pubuddi.gif

    The Publish Service to UDDI dialog appears.

  4. Enter the following information:

    Field Description

    Service Name

    Displays the name of the selected service.

    Service Description

    Enter an optional description of the selected service.

    System Definition Location

    Displays the WSDL URL to publish to the UDDI registry. For example:

    http://myhost.mycompany.com:7001/soa-infra/services/default/HelloWorld/client?WSDL
    

    UDDI Source

    Select the UDDI publishing source from which to register the service.

    Business Name

    Select a business to publish the service. This is the name of the data structure in the UDDI registry. It is assumed that the business has already been registered in the UDDI registry.


    When complete, the Publish Service to UDDI dialog looks similar to the following:

    Description of bc_pubuddi2.gif follows
    Description of the illustration bc_pubuddi2.gif

  5. Click OK.