Specifying a REST server

During discovery, the external service is automatically set to point to the REST server. You can modify the server binding properties that your external service uses to invoke a REST API.

About this task

External services must provide connection information and authentication information to invoke a service on the host. The connection information, as well as defaults for basic authentication information, are defined in a server. Server configurations can be shared by multiple external services in a business automationor toolkit. A server lets you maintain the connection information in one place so that you need to update it only once if something changes. If the API changes but the server is the same, you can rediscover the service without changing the server.

When you discover a REST service, you can choose to use an existing REST server or create a new one. The host, port and secure server properties are added for you if the Swagger definition specifies them.

Procedure

To modify an existing REST server, perform the following steps.

  1. Select the Servers tab from the Process App Settings editor. You see the Process App Settings editor when you first open a newly created process application in the Business Automation Studio.
  2. Select the server that you want to modify. You can change the following binding properties.
    • The Name of the server.
    • The Description of the server.
    • The Default settings are used if nothing is specified for the other environments. You can have several environment types, which are added by clicking +. The other environment types that you can add are as follows:
      • Development: The environment where you develop your services. This is any Business Automation Studio or a workflow server that has its environment type set to Development.
      • Test: The environment where you test your services.
      • Staging: The environment where you deploy your services for pre-production testing.
      • Production: The environment where your services are deployed for use by your organization.
    • Host name: The host name of the server that hosts the REST service. Specify an IP address or a host name and domain. For example: myHost.labwide.ibm.com.
    • Port: The port number of the server.
    • Secure Server: Specify whether you want your service to be secure, that is, to use the Hypertext Transfer Protocol Secure (HTTPS) protocol by selecting this check box. If you select the HTTPS protocol, make sure that you have the security certificate that the REST service requires and that you specify the correct port number for the secure server.
    • SSL Configuration: Check the server certificate for the REST service that you want to invoke. If the external service uses OAuth authentication, check the server certificate for the OAuth provider.
      • If the server certificate is signed by a public certification authority, you can use the preconfigured SSL configuration that is named PublicInternetSSLSettings.
      • If the server certificate is not signed by one of the public certification authorities that are included in the preconfigured SSL configuration:
        • An administrator should create a new SSL configuration for this service and import the server certificate into a new trust store. See Operating cloud environments.
    • Authentication: The defaults for the basic authentication method that is used to invoke the REST service. These settings take effect when no basic authentication settings are configured in the Binding tab of the external service. You can use one of the following options:
      None
      No credentials are required.
      Basic - user name and password
      Authenticate by using the user name and password that are specified.
      Basic - invocation credential
      Authenticate by using the J2C authentication alias that holds the username and password.
    • Request and Response Timeout: The amount of time before a connection to the server times out.
      Request timeout
      The amount of time, in milliseconds, that the client attempts to establish a connection before it times out. The default is 30000. If you choose None, the client attempts to open a connection indefinitely.
      Response timeout
      The amount of time, in milliseconds, that the client waits for a response before it times out. The default is 60000. If you choose None, the client waits indefinitely.