Managing API Services

Contents

Overview
Virtualizing a Service in API Service Manager
Step 1—Basic Information
Step 2—Service Exposure
Step 3—Request Processing
Step 4—Routing
Step 5—Response Processing
Step 6—Monitoring
Step 7—Tags
Deploying to a Group

Overview

You can use the API Services tab in API Service Manager to virtualize services with the API Gateway. The Business Services repository stores service URLs, definitions and related information such as XML schemas. Clients can query this repository for service information (for example, URLs or WSDL files), and use it to send messages to the service through the API Gateway.

When you virtualize a service in the repository, the API Gateway exposes a virtualized version of the service. The host and port for the service are changed dynamically to point to the machine running the API Gateway. For example, the client can then send a message to the virtualized service through the API Gateway, without knowing its real location. Some policies are also automatically generated for the virtualized service. These include resolvers and connection filters, and are hidden by default in API Service Manager.

You can also use the API Services tab to perform tasks such as assigning policy packages to a service, configuring monitoring options, and assigning tags to help identify a service. A policy package is a sequence of modular, reusable message filters, each of which processes a message in a particular way. For example, a typical policy might contain an authentication filter (WS-Security UserNameToken), followed by several content-based filters (Schema Validation, Threatening Content, and Message Size). If all configured filters run successfully, the message is routed on to the configured destination.

Virtualizing a Service in API Service Manager

If you have not already done so, you must first perform the following steps to create a workspace in API Service Manager:

  1. Click the API Service Manager button in the API Gateway Manager toolbar.

  2. Select the group and API Gateway instance that you wish to use to virtualize the service (for example, Group1) and APIServer1.

  3. Click the Create button to create the workspace.

  4. Enter the configuration passphrase if one exists for this API Gateway instance, and click OK.

  5. Click the Virtualize API Service button on the left in the toolbar of the API Services tab to launch the New API Service wizard.

Step 1—Basic Information

The first step in the New API Service wizard enables you to virtualize a service with or without a Web Services Definition Language (WSDL) file.

Virtualizing a REST API-based Service

To virtualize a REST API-based service without a WSDL file, perform the following steps:

  1. Click No, my Service will be defined manually, and enter the details for your service, for example:

    • Name: MyService

    • Destination URL: http://www.example.com/my_service

  2. Click Next to specify how service is exposed.

Virtualizing a Web Service

To virtualize an example Web service using the API Service Manager, perform the following steps:

  1. Click Yes, I know a URL from which to get a WSDL, and enter a URL in the WSDL URL field, for example: 

    http://localhost:7070/axis/services/urn:xmltoday-delayed-quotes?wsdl

  2. Click Next to view a WSDL import summary.

  3. Click Next to specify how the service is exposed.

Step 2—Service Exposure

The second step in the wizard enables you to specify how the service is exposed. Perform the following steps:

  1. Enter or select the protocol. Defaults to HTTP. You can also click Show Details to view the default port address (${env.PORT.TRAFFIC} defaults to 8080).

  2. Enter or select the services group. Defaults to Default Services.

  3. Enter the relative path. Defaults to the path after the service domain name (for example, my_service). You may wish to virtualize the service on a different relative path.

  4. Click Next.

Step 3—Request Processing

The third step in the wizard enables you to specify policy packages used for request processing. (for example, an OAuth policy package for authentication. Perform the following steps:

  1. Click the green plus icon, and select a policy package from the list.

  2. Select whether this policy package is Required or Optional. Defaults to Required.

  3. Click the Edit Parameters icon to specify any policy parameters (for example, the value of a message attribute selector such as ${http.request.uri}).

  4. Repeat these steps to add more request processing policy packages.

  5. Click Next when finished.

[Note] Note

You can use the Policy Studio to create reusabe policy packages that can be applied to services in API Service Manager. For more details, see Configuring Policy Packages.

Step 4—Routing

The fourth step in the wizard enables you to specify policy packages used for routing (for example, JMS). Perform the following steps:

  1. Click the green plus icon, and select a policy package from the list.

  2. Select whether this policy package is Required or Optional. Defaults to Required.

  3. Click the Edit Parameters icon to specify any policy parameters (for example, the value of a message attribute selector such as ${http.headers}).

  4. Repeat these steps to add more routing policy packages.

  5. Click Next when finished.

Step 5—Response Processing

The fifth step in the wizard enables you to specify policy packages used for response processing (for example, a policy package that removes sensitive information such as credit card details from the message). Perform the following steps:

  1. Click the green plus icon, and select a policy package from the list.

  2. Select whether this policy package is Required or Optional. Defaults to Required.

  3. Click the Edit Parameters icon to specify any policy parameters (for example, the value of a message attribute selector such as ${content.body}).

  4. Repeat these steps to add more repsonse processing policy packages.

  5. Click Next when finished.

Step 6—Monitoring

The sixth step in the wizard enables you to select the following monitoring options for the service:

  • Monitor API Service usage:

    Specifies whether to store message metrics for this service. This is selected by default.

  • Monitor API Service usage per client:

    Specifies whether to generate reports monitoring which authenticated clients are calling which services. This is selected by default.

  • Monitor client usage:

    If you want to generate reports on authenticated clients, but are not interested in which services they are calling, select this option and deselect Monitoring service usage per client.

  • Message Attribute:

    Enter the message attribute to use to identify authenticated clients. The default authentication.subject.id attribute stores the identifier of the authenticated user (for example, the username or user's X.509 Distinguished Name).

Click Next when finished.

Step 7—Tags

The final step in the wizard enables you to specify tags for this service. Tags are user-friendly names to help organize, search, and browse API Gateways and services in API Gateway Manager and Policy Studio. Perform the following steps:

  1. Click the green plus icon to add a tag.

  2. Enter a Tag name (for example, Dept).

  3. Enter a Value (for example, QA).

  4. Click Finish.

To view services by tag in API Gateway Manager, perform the following steps:

  1. Click the Show Columns button on the right in the API Services toolbar.

  2. Select the tag that you wish to display.

  3. Click Apply to view tag in the list.

The virtualized service is displayed on the API Services tab:

Registered Service

Deploying to a Group

When you have completed the steps in the wizard, you must deploy the updated configuration to a API Gateway group, or a subset of API Gateways in a group, as follows:

  1. Click Actions -> Deploy on the left in the API Services tab.

  2. In the Deployment Wizard, select the group and API Gateway instance(s) to which you wish to deploy the current working configuration, and click the Next.

  3. Enter a comment for this deployment (for example, registering google search service).

  4. Click Deploy.

  5. Click Finish.

[Note] Note

Services virtualized using API Service Manager and deployed to the API Gateway can also be viewed in the Policy Studio tree under the Business Services -> API Service Manager node. For details on using Policy Studio to import services, see Web Service Repository.

Prev  Up  Next
  Home