Controlling the Use of Directives
A directive is a way to access or invoke resources. Integration Server supports these directives:
Directive | Used to... |
default | Route requests to the document handler the Integration Server uses to process DSP pages. |
invoke | Run services. |
odata | Process incoming OData service requests. |
rest restv2 | Perform service invocations submitted as REST requests. Note: | REST resources configured using the legacy approach are invoked using the rest directive while REST resources configured using the URL template-based approach are invoked using the restv2 directive. For more information about the approaches for configuring REST resources, see REST Developer’s Guide. |
|
soap | Route requests to the Integration Server SOAP message handler. Note: | The soap directive is deprecated. |
The SOAP message handler routes messages to SOAP processors provided in versions of Integration Server prior to version 7.1.2. These processors have since been deprecated. The SOAP message handler also provides support for web services developed in Integration Server version 6.5. |
web | Access JSP files. |
ws | Invoke web services, specifically, operations in provider web service descriptors. |
Note: | JSON requests can use the invoke, rest, and restv2 directives only. |
Users specify directives as follows:
http://host:port/directive/interface/service_name
For example:
http://localhost:5555/invoke/wm.server/ping
By default, all
Integration Server ports except the proxy port allow all the directives listed above. The proxy port allows all directives except the web directive. However, for security reasons, an organization typically allows only those directives that are necessary to fulfill its business requirements. You might allow all directives on ports that are accessible only to users within your firewall, but you might want to restrict directives on ports that are exposed to users outside the firewall. For example, if you want to receive only SOAP requests on a particular port, from both internal and external users, you could allow the soap directive but no other directives on that port. To restrict the use of directives to certain ports only, you set the watt.server.allowDirective parameter (see
watt.server.).
You can specify alternative names for the invoke, soap, and rest directives. For example, by default, the invoke directive is specified on URLs as "invoke" (that is, http://host:port/invoke/folder/service_name). You can identify an alternative word for users to specify as the invoke directive. For example, you might want to allow users to specify the invoke directive as "submit" (that is, http://host:port/submit/folder/service_name).
To specify an alternative word for the invoke directive, set the watt.server.invokeDirective parameter (see
Server Configuration Parameters).
To specify an alternative word for the soap directive, set the watt.server.SOAP.directive parameter (see
Server Configuration Parameters).
To specify an alternative word for the rest directive, set the watt.server.RESTDirective parameter (see
Server Configuration Parameters).
Note: | You cannot specify an alternative word for the restv2 directive. |