Help Center> ROMA Connect> User Guide> Service Integration Guide> Plug-in Management> Using Plug-ins
View PDF

Using Plug-ins

Overview

ROMA Connect provides flexible extension capabilities for APIs through plug-ins.

Prerequisites

  • Plug-ins are independent of APIs. A plug-in takes effect for an API only after they are bound to each other. When binding a plug-in to an API, you need to specify the published environment, only in which a plug-in takes effect for an API.
  • An API can be bound to only one plug-in of the same type in the same environment.
  • Plug-ins that have been bound to APIs cannot be deleted.

Creating a Plug-in

  1. Log in to the ROMA Connect console. On the Instances page, click View Console next to a specific instance.
  2. In the navigation pane on the left, choose API Connect > API Management. On the Plug-ins tab page, click Create Plug-in.
  3. In the Create Plug-in dialog box, configure the plug-in information.
    Table 1 Plug-in configuration

    Parameter

    Description

    Plug-in Name

    Enter a user-defined plug-in name. It is recommended that the plug-in is named according to the naming rules to facilitate search.

    Plug-in Type

    Select the plug-in type, which determines the extension capabilities.

    Cross-origin resource sharing (CORS): Provides the capabilities of specifying precheck request headers and response headers and automatically creating cross-origin precheck request APIs for cross-origin API access.

    Plug-in Scope

    Select the visible scope of the plug-in.

    • Integration application: The plug-in belongs to an integration application. Only users who have the permission of the integration application can view and use the plug-in.
    • Global: All users can view and use the plug-in.

    Integration Application

    This parameter is mandatory only if Plug-in Scope is set to Integration application.

    Select the integration application to which the plug-in belongs. If no integration application is available, click Create Integration Application on the right to create one.

    Description

    Enter the plug-in description.

    Plug-in Content

    Plug-in content, which can be configured in forms or scripts.

    The plug-in content configuration varies depending on the plug-in type:
  4. Click OK.

    After a plug-in is created, you need to perform Binding a Plug-in to an API to make the plug-in take effect for the API.

Binding a Plug-in to an API

  1. In the navigation pane on the left, choose API Connect > API Management. On the APIs tab page, click the name of the API to which the plug-in is to be bound. The API details page is displayed.
  2. On the Plug-ins tab page, click Bind.
  3. In the Bind Plug-in dialog box, set Environment and Plug-in Type, and select the plug-in to be bound.

    You can search for a plug-in by name.

  4. Click OK. The plug-in is bound to the API.
Parent topic: Plug-in Management