Modifying an existing inbound service configuration

Modify the configuration details for an existing inbound service. For example: secure the service; apply JAX-RPC handler lists to the ports for the service; publish the service to more than one UDDI registry.

About this task

An inbound service is a web interface to a service that is provided internally (that is, a service provided by your own organization and hosted in a location that is directly available through a service integration bus destination).

When you first create an inbound service, you connect the service to one or more endpoint listeners and (optionally) specify the UDDI publication properties that are used to publish the inbound service to an initial UDDI registry. An inbound port is automatically created for each endpoint listener that you select, but each inbound port is created without a template port, JAX-RPC handler list or security settings. Modify your inbound service configuration if you want to control and monitor access to your inbound services in any of the following ways:
  • Associate JAX-RPC handler lists with ports, so that the handlers can monitor activity at the port, and take appropriate action depending upon the sender and content of each message that passes through the port.
  • Password-protect a web service operation.
  • Set the level of security to be applied to messages (the WS-Security configuration and bindings). The security level can be set independently for request and response messages.
  • Publish the service to more than one UDDI registry.

To list the existing inbound services, and to view and modify their configuration details, complete the following steps:

Procedure

  1. Start the administrative console.
  2. In the navigation pane, click 服務整合 -> 匯流排 -> bus_name -> [服務] 入埠服務. A list of all the inbound services is displayed in an inbound services collection form.
  3. Click the name of an inbound service in the list. The current settings for this inbound service are displayed.
  4. Optional: Click Reload template WSDL to reload the template WSDL file for this inbound service.
    Note:
    • When you create a new inbound service, a copy of the template WSDL file for the service is loaded into a locally-maintained repository. If you change the template WSDL file, you must update the local copy.
    • When you click Reload template WSDL, you run the command that is described in Refreshing the inbound service WSDL file by using the wsadmin tool. For the command to complete successfully, the conditions must be met that are described in that topic.
    • If the bus needs to pass messages through an authenticating proxy server to retrieve WSDL documents, then you cannot use the Reload template WSDL option and you must run the refresh WSDL command by using the wsadmin tool. For more information, see the corresponding troubleshooting tip.
  5. Modify the general properties. For information about each of these properties, see Inbound services settings.
    Note:
    • When you change an inbound service name, the system looks up all objects that refer to it and updates the name.
    • The template WSDL is the service-specific WSDL file that you create to describe this inbound service. For information about how to create a WSDL file, see Developing a WSDL file for JAX-RPC applications.
    • Although logically the template WSDL name and namespace are only required if there is more than one service in the WSDL, the fields that you use to set them are coded within the administrative console as compulsory fields. They are filled in for you by default, so if they are not logically required for your service you should leave the default values. If you remove the value from either field, the administrative console treats the empty field as an error.
    • If you select the option to Enable operation-level security then you must also complete, for this inbound service, the steps described in Password-protecting a web service operation.
  6. Modify the additional properties.
    1. Modify the inbound ports that are associated with this inbound service.

      入埠連接埠會以相關聯的配置來說明在某特定端點接聽器上,某個服務目的地的 Web 服務啟用。 每個入埠連接埠都會關聯於一個端點接聽器,且您可以只利用特定端點接聽器來提供服務,以控制哪些使用者群組可以存取特定入埠服務。 For more information, see Endpoint listeners and inbound ports: Entry points to the service integration bus.

      您可以利用 JAX-RPC 處理程式清單來監視這個埠的活動,並根據傳送端和這個埠所傳遞的每個訊息的內容來採取適當的動作(如記載或重新遞送)。 For more information, see Bus-enabled web services and JAX-RPC handlers.

      您可以利用 WS-Security 來設定訊息所要套用的安全層次。安全層次設定時,可以和要求和回應訊息無關。 For more information, see Service integration technologies and WS-Security.

      另請參閱入埠連接埠設定

    2. Modify the UDDI publication properties that are used to publish this inbound service to one or more UDDI registries. For information about the UDDI publication properties, see UDDI Publication settings and UDDI registries: Web service directories that can be referenced by bus-enabled web services.
    3. Modify the custom properties, if any, that you have set for this inbound service. 這些自訂內容為可用來設定內部系統配置內容的名稱/值配對。在每個配對中,名稱都是一個內容索引鍵,值是字串值。
    4. Use the publish WSDL files property to export the template WSDL for this inbound service to a compressed file.

      As a technology preview, the exported compressed file includes a version of the WSDL file that has no ports (bindings) defined. This non-bound WSDL is intended for use by your colleagues preparing to deploy an inbound service. It gives you a convenient way of sharing information about the planned deployment details for the service among your team. When you finally deploy the inbound service, the associated WSDL must be complete (that is, it must include the binding information).

      The non-bound WSDL file is always published in the exported compressed file for the inbound service, along with the bound WSDL file if the inbound service has any ports defined. The compressed file, named inbound_service_name.zip, therefore always contains the following files:
      • bus_name.inbound_service_nameNonBound.wsdl (this file contains the non-bound service, port and binding for the inbound service).
      • bus_name.inbound_service_namePortTypes.wsdl (this file contains the port type definition for the inbound service).
      If the inbound service has one or more ports, then the compressed file additionally contains the following files:
      • bus_name.inbound_service_nameService.wsdl (this file contains the service and port elements for the inbound service).
      • bus_name.inbound_service_nameBindings.wsdl (this file contains the binding elements that correspond to the ports for the inbound service).

      If there is an error generating the WSDL then an error page is returned.

  7. 儲存對主要配置所做的變更。

Results

If the processing completes successfully, the list of inbound services for this service integration bus is redisplayed. Otherwise, an error message is displayed.

指出主題類型的圖示 作業主題



時間戳記圖示 前次更新: July 9, 2016 11:16
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tjw_in_config
檔名:tjw_in_config.html