Show TOC

Procedure documentationConfiguring Host Mapping, Path Prefix, and Path Mapping Locate this document in the navigation structure

 

You can specify the following URL mappings:

  • Virtual host, HTTP port, and HTTPS port mapping for a specific host. This HTTP mapping (WS HTTP Mapping) applies only to Web services and overrides the global HTTP mappings.

    You can configure a WS HTTP Mapping as relevant for Services Registry publication.

  • A path prefix that should be inserted in the URI after the virtual host name and port.

    You can specify a WSDL prefix and an endpoint prefix.

  • A path mapping for a specific service, used for modifying the part of the URI that is after the virtual host name and port.

    The path mapping overrides the path prefix setting.

Note Note

The path prefixes and path mappings apply only to hosts for which you have set WS HTTP Mapping.

End of the note.

Procedure

1. Access the Reverse Proxy Settings

  1. To start SAP NetWeaver Administrator, open a Web browser and enter the following address:

    http://[host]:[port]/nwa

    Then enter your user name and password if required.

  2. Choose   SOA Management   Technical Configuration   SOA Middleware Global Settings  .

  3. Choose Reverse Proxy.

2. Configure WS HTTP Mapping for a Host

  1. In the HTTP Mappings screen area, choose Add.

  2. In the Host field in the first column, enter the IP address or the name of the host for which you want to create a mapping.

  3. In the Host field in the second column, enter the virtual host name or IP address you want to assign for this host.

  4. Enter the virtual HTTP and HTTPS ports.

    Example Example

    You want to create the following mapping:

    • Internal URL: http://10.1.1.2:50000/ExampleService/Example?wsdl

    • External URL: http://example.com:80/ExampleService/Example?wsdl

    To do this, you should create a WS HTTP Mapping for 10.1.1.2 to the example.com virtual host on virtual port 80.

    End of the example.

  5. To mark a particular WS HTTP Mapping as relevant for Services Registry publication, select it and choose Set as Default.

    For WS HTTP Mapping marked as Services Registry relevant, the system uses the HTTP transport protocol by default

    Note Note

    If there are no such WS HTTP Mappings, then the system chooses the first global HTTP mapping it finds as the default Services Registry publication relevant HTTP mapping. The system uses this default value for the generation of the first part for external endpoint/WSDL URLs published in Services Registry.

    End of the note.

  6. Save your entries.

3. Configure Path Prefixes

  1. In the WSDL Prefix and Endpoint Prefix fields, enter the path prefix that should be used for WSDL URL and endpoint URL, respectively.

    The strings for the prefixes can contain a forward slash (/) character except at the start and at the end.

    Example Example

    You want to create the following mapping:

    • Internal URL: http://[host]:[port]/ExampleService/Example?wsdl

    • External URL: http://[vhost]:[vport]/my/folder/ExampleService/Example?wsdl

    To do this, you should enter a my/folder prefix for WSDL.

    End of the example.

  2. Save your entries.

4. Configure Path Mapping

  1. In the Specific URI Mapping screen area, choose Add.

  2. In the URI field, enter the path to the service for which you want to create a path mapping.

    You should include the part of the URI that starts after the port value, without the forward slash (/) character, and ends to ?wsdl. If this part contains a path prefix you should not enter the prefix, since the path mapping overrides the path prefix setting.

  3. In the Mapped URI field, enter the new path.

    The string for the new path can contain a forward slash (/) character except at the start and at the end.

    Example Example

    You want to create the following mapping:

    • Internal URL: http://[host]:[port]/ExampleService/Example?wsdl

    • External URL: http://[vhost]:[vport]/MyPath?wsdl

    To do this, you should map ExampleService/Example to MyPath.

    End of the example.

  4. Save your entries.