| Oracle® Web Services Manager Administrator's Guide 10g (10.1.3.1.0) Part Number B31008-03 |
|
|
View PDF |
| Oracle® Web Services Manager Administrator's Guide 10g (10.1.3.1.0) Part Number B31008-03 |
|
|
View PDF |
This chapter includes the following sections:
For information on backing up and recovering your Oracle Web Services Manager system refer to Oracle Application Server Administrator's Guide.
A password hash is as sensitive as a password. Never send a password or its hash over an unencrypted communication channel. Oracle recommends that you use HTTPS between all communication points in your Oracle Web Services Manager (Oracle WSM) deployment in order to transmit passwords securely.
Oracle WSM does not support secure JDBC connections.
By default, Web Services Manager Control browser session will time out after 60 minutes. You can change the session timeout by editing the following file:
ORACLE_HOME/owsm/config/ccore/ui-config-common.properties
Edit the ui.session.timeout parameter and enter the number of minutes your browser session will remain active before timing out.
After editing this parameter, use the wsmadmin deploy password control command and redeploy the Web Services Manager Control application. For more information on redeploying the application, see Oracle Web Services Manager Deployment Guide.
If you have installed Oracle WSM as part of Oracle Application Server 10g Release 3 (10.1.3.1.0) release, refer to Chapter 14, "OC4J Java Single Sign-On" in Oracle Containers for J2EE Security Guide for information on setting your browser session.
A service may need to be deactivated for any of the following reasons:
The service is no longer needed.
If you change the protocol for a Web service, you must first deactivate the service, then reregister it with the new protocol.
If you change the service definition or service usage, you must deactivate the service, then reregister it with the new definition.
Once a service is deactivated, you must reregister the service to make it active again. See "To add a Web service to a gateway" for the procedure to register a Web service.
From Web Services Manager Control, click Policy Management, then select Register Services.
Click Services for the gateway whose service you want to deactivate.
Click Deactivate service for the service you want to deactivate.
After a service is registered to a gateway, you can return to the service list display and edit service details, for example, adding Oracle WSM administrators and support groups, updating the service description, or making changes to the service protocol detail information or policies enforced for specific services.
To edit the Web service properties
From the navigation pane of Web Services Manager Control, select Policy Management, then select Register Services.
Click Services for the gateway whose services you want to view or edit.
The Web Services Manager Control displays the gateway's current list of services.
Click Edit for the particular service whose information and details you want to view or update.
The Web Services Manager Control displays parameters, groups with access, and other information for the selected service.
From this page, you can update the service description, make changes to the service protocol detail (Modify Protocol Parameters), make changes to the policy enforced for the specific service (Modify Policy), or change the Oracle WSM groups who are given Oracle WSM Modify and View permissions for the service.
Note:
You can also view and edit information for a specific service policy by selecting Policy Management, clicking the Manage Policies menu option, selecting a gateway, and then choosing View Details or Edit for a specific service.When you have finished making changes, click Save.
Oracle WSM saves your changes and displays a confirmation message in Web Services Manager Control.
Note:
After making changes to a service registered to an Oracle WSM gateway, Commit Policy appears in red in the gateway list display, prompting you to update the gateway with new policy information. Click Commit to update the gateway with the service and policy changes you have made.Web services that are registered at a gateway can be made available to others by publishing the following URL:
http://hostname:port/gateway/inquiry?inspection.wsil
The variable hostname is the Application Server host name and port is the port on which the server is listening.
Figure 9-1 shows three services registered at the example gateway.
Figure 9-1 Registered Services at a Gateway
When the URL is entered, the WSIL file is automatically generated, and all Web services registered to the gateway are added to the WSIL file. All information required by WSIL is extracted from the service information.
Once a gateway or agent has been registered, you can use Web Services Manager Control and navigate to the Edit Component Properties page, where you can view and make changes to the component. Registered agents and gateways periodically search for changes in the component properties and these changes are communicated to the policy enforcement point.
To navigate to the Edit Component Properties page
From the navigation pane of Web Services Manager Control, select Policy Management, then select Manage Policies.
Click the Edit icon for the component whose properties you want to edit.
The Edit Component Properties page is displayed (Figure 9-2).
Figure 9-2 Edit Component Properties Page
From the Edit Component Properties page, you can do any of the following:
View and edit the properties of the gateway or agent.
Click add property to add a property for the gateway or agent.
Click Registration Details to get to the Registration Details page for the gateway or agent. On that page you can view and edit the basic parameters for your component.
To edit the component properties
The properties for the component are displayed on the Edit Component Properties page. Click the question mark (?) for help on the properties.
From the Edit Component Properties page, edit the desired properties, and click Save.
A confirmation message is displayed.
Note:
The confirmation message reminds you that this change must be committed.Click Ok.
Commit the changes to have them take effect.
To view and edit the registration details
From the Edit Component Properties page, click Registration Details.
The Registration Details page is displayed.
Make any changes to the properties on the page, and click Save.
A confirmation message is displayed.
Click Ok to return to the Edit Component Properties page.
Click Save.
A confirmation message is displayed.
Note:
The confirmation message reminds you that this change must be committed.Click Ok.
Commit the changes to have them take effect.
To add a new property
From the Edit Component Properties page, click add property at the top of the page.
Scroll to the bottom of the page where there are several text boxes. Enter the name of the property, select the data type from the list, the default value (optional), and a brief description of the property.
Click Save.
A confirmation message is displayed.
Note:
The confirmation message reminds you that this change must be committed.Click Ok.
Commit the changes to have them take effect.
Once a policy enforcement point is registered, you can make changes to the component properties or to its registration details, you can add new properties, and you can edit the policies assigned to the policy enforcement point. In order for any of these changes to take effect, you must commit the changes to the Oracle WSM Database.
To commit your changes
From the navigation pane of Web Services Manager Control, select Policy Management, then select Manage Policies.
In the List of Components, click Policies for the desired gateway or agent.
In the Policies page, if the Commit Policy field appears in red text, click Commit to commit any outstanding changes that have been made to the policy enforcement point.
Figure 9-3 Commit Policy Field in Red Text
The page refreshes and the commit link is replaced with the message Policy is committed.
Figure 9-4 Policies Page Showing the Policy Is Committed
