3.18. Configuring Gateway

The DigitMarket™ API Manager Gateway serves as a control hub for APIs. It decides which traffic is authorized to access the back-end services that are exposed via APIs. It manages server loads by enforcing policies such as, Rate Limiting and Throttling. It logs all transactions passing though it and sends them to the servers for analytics and billing purposes.

To learn more about how the Gateway functions, refer the topic: Gateway.

3.18.1. Microgateway

DigitMarket™ API Manager also supports the Microgateway feature. With Microgateway an artifact like Backend, API, Usage Plan, Usage Policy, API Pack, as well as Subscriptions for a pack can be propagated to all or selective gateways.

DMAPIM users have the option to define multiple gateways under a publisher organization with multiple Gateway instances. Whenever any artifact such as a backend, API, API pack, Usage Plan, Usage Policy etc. is configured, by default it will be propagated to the default gateway that is configured on the publisher organization. With the Microgateway feature, users have the option to define their own Gateway. Users can change this setting in the publisher portal by choosing the Gateways to which they want to propagate their desired artifact. The artifact can either be propagated to a single Gateway, multiple Gateways or all Gateways.

Note

Multiple Production Gateways can be created but only one Sandbox Gateway can be created.

For example, let us assume that there are three production gateways: Gateway 1 (G1), Gateway 2 (G2), Gateway 3 (G3). Let us also assume that a user creates two artifacts, say a Backend (B1) and a Usage Plan (P1). The default settings allow the user to propagate both artifact B1 and P1 to all Gateways- G1, G2, G3. With Microgateway feature, the user can choose to configure which Gateway the respective artifact needs to be propagated, such as-Backend B1 to Gateway G1 and Usage Plan P1 to Gateway G3. Backend B1 can also be propagated to Gateways G1 and G2, or all three Gateways – G1, G2, and G3. Similarly, Usage Plan P1 can be propagated to only Gateway G3, Gateways G2 and G3, or all three Gateways – G1, G2, G3.

Microgateway also allows automatic mapping of dependant artifacts. If any of the artifacts have a dependency on other artifacts then the dependant artifacts will also be mapped along with the original artifact.

An API has dependency on Backend. A Plan has dependency on API and Usage Policy. If a Plan is created and mapped to one of the Gateways, but the Usage Policy under that Plan is not mapped to the Gateway, then it is automatically mapped to when the Plan is mapped to that Gateway.

For better understanding, let us assume that for an API 1, the dependency is Backend 1. Plan 1 also has dependency on API 1. Plan 1 and its dependencies are propagated to Gateway 1. Let us suppose that for a Gateway 2 which has no API mapped to it, a user tries to map API 1 to Gateway 2. The application analyzes that API 1 has dependency on Backend 1. But as the Backend 1 is not mapped to Gateway 2, it too needs to be mapped to Gateway 2. So in this case, it automatically maps both Backend 1 and API 1 to Gateway 2.

The following can be mapped to Gateways:

• API

• Plan

• Subscription

• Usage Policy

• Backend Point

Note

An artifact can be propagated to multiple Gateways but a Subscription can be propagated only to one Gateway.

Only Draft, Approved and Published states for artifacts of API/Plan/Usage Policies are listed under each Gateway.

Common Tasks

Following is the common task identified for this section:

• Navigating to the Gateways screen

  To navigate to the Gateways screen:

  • In the main Navigation menu, click Gateways.

  

  Fig. 3.422 Gateways menu

  The Gateways list screen displays.

  

  Fig. 3.423 Gateways list screen

3.18.1.1. Add a New Gateway

To add a new Gateway:

1. Navigate to the Gateways screen.

2. Click the plus icon to add new Gateway. The Add Gateway dialog box displays.

   

   Fig. 3.424 Add Gateway dialog

3. In the Gateway Name box, type the new Gateway name.

4. Click the Gateway Type drop-down list to choose whether the Gateway is designated to the Production or Sandbox environment.

5. In the URL box, enter the URL for accessing the gateway. Gateway URL is a combination of the IP address and host name for the new Gateway.

6. In the Description box, type the description to describe the API Gateway.

7. After entering the Gateway details, click Proceed to enter the Instance details. The Instance Details dialog box displays.

   

   Fig. 3.425 Add Gateway Instance dialog

   Note

   A Gateway can have multiple instances but one Gateway must have at least one instance. At the time of its creation, only one Gateway instance can be created.

8. In the Gateway Instance Name box, enter the Gateway Name.

9. In the URL box, enter the URL for accessing the main gateway instance.

10. In the Description box, enter the description to describe the API Gateway instance.

11. Click Save to finish adding the new Gateway. The newly added Gateway will be included in the Gateways list.

Note

Users can also configure a Sandbox Gateway to test APIs in a Sandbox environment. For details visit: Configuring Sandbox Gateway.

3.18.1.2. Edit an Existing Gateway

To edit a Gateway:

1. Navigate to the Gateways screen.

2. From the list of Gateways, select the Gateway that you want to edit.

   

   Fig. 3.426 Gateway - edit

3. Click the edit icon next to the Gateway name. The Edit Gateway dialog box displays with populated data.

   

   Fig. 3.427 Edit Gateway dialog

4. Make the necessary changes and then click Update to save changes. The user will be navigated to Gateways page and updated changes will get reflected.

3.18.1.3. Delete a Gateway

You can delete a Gateway only if any of the artifacts are not mapped.

To delete a Gateway:

1. Navigate to the Gateways screen.

2. From the list of Gateways, select the Gateway that you want to delete.

3. Click the delete icon next to the Gateway name.

   

   Fig. 3.428 Gateway - delete

A confirmation message displays.

Fig. 3.429 Gateway - delete

1. Click OK to proceed.

The Gateway is removed from the Gateways list.

3.18.1.4. Instance

Under the Instance tab, you can find the list of all the instances that are mapped to this particular Gateway.

3.18.1.4.1. Add an New Instance

1. Navigate to the Gateways screen.

2. From the list of Gateways, select the Gateway under which you want to add an instance. The Instance tab displays.

3. Click Add New Gateway Instance. The Add new Instance dialog box displays.

   

   Fig. 3.430 Add Instance dialog

4. To fill the instance details, follow steps – 8 to 10 from the Add a New Gateway section.

5. Click Add. The newly added Gateway Instance is now included to the Instances list.

3.18.1.4.2. Edit an Existing Instance

To edit an Instance:

1. Navigate to the Instance tab.

   

   Fig. 3.431 Edit Instance

2. In the row that has the Instance that you want to edit, click the edit icon . The Edit Instance dialog box displays with populated data.

3. Click the edit icon next to the Instance name. The Edit Instance dialog box displays with populated data.

   

   Fig. 3.432 Edit Instance dialog

4. Make the necessary changes and then click Update to save changes. The user will navigate to the Gateways tab and the updated instance details will get reflected.

3.18.1.4.3. Delete an Instance

To delete an Instance:

1. Navigate to the Instance screen.

2. In the row that has the Instance that you want to delete, click the delete icon .

   

   Fig. 3.433 Instance - delete

   A confirmation message displays. Click OK to delete.

   

   Fig. 3.434 Instance - delete

   The Instance is removed from the Instance list.

Note

Atleast one instance should be present under each Gateway.

3.18.1.5. API

Under the API tab, you can find the list of all the APIs that are mapped to this particular Gateway.

The API tab displays all the API along with details such as:

• API Name with details (REST or SOAP API)

• API Version with details about the status(Draft/Approved/Published)

• API Status (Propagated or not)

• Mapped Filter - This option allows you to display - all API versions/only mapped API versions/only unmapped API versions.

• Map to Gateways - Toggle button to map the unmapped API versions to the Gateway and unmap mapped API versions. Mapped API Versions are displayed in green while unmapped API Versions are displayed in red.

• Search box to search for a particular API version. Enter the query in the search box and click the search icon to display the results.

• Repropagate - This button allows users to repropagate propagated API versions.

To map the API Versions to a Gateway:

1. Navigate to the Gateways screen.

2. From the list of Gateways, select the required Gateway and then click the API tab. The API tab displays a list of all the API Versions under this particular Gateway.

   

   Fig. 3.435 API

3. Use the Mapped filter to filter API Versions using the options: All, Mapped, Unmapped. You can also search for the required API Version using the Search box.

   

   Fig. 3.436 Mapped Filter

Note

Only draft, published or approved API versions are available to map.

4. In the row that has the API Version that you wish to map, click the Map to Gateways toggle button. Inversely, click the toggle button again to unmap.

   

   Fig. 3.437 Toggle to Map

A notification message appears asking you to confirm the mapping.

Fig. 3.438 Mapped Toggle

5. Click Proceed to map. The API version will be mapped. The toggle button will turn green.

Although the API version is mapped, it is not yet propagated. The API version will be available to propagate in the Gateways Sync page.

Note

Gateway mapped API’s which are consumed in a plan cannot be unmapped.

To repropagate the propagated API Versions:

1. Navigate to the API tab.

2. Click Repropagate. The Propagate API dialog displays a list of already propagated APIs that are available for repropagation.

   

   Fig. 3.439 Propagate API

3. Select the required APIs and click Repropagate. A success message displays upon successful propagation.

3.18.1.6. Plan

Under the Plan tab, you can find the list of all the Plans that are mapped to this particular Gateway.

The Plan tab displays all the mapped plans along with details such as:

• Plan Name with details (Monetization Strategies)

• Pack Name with details (REST or SOAP Plan) and status of the Plan (Draft/Approved/Published)

• Mapped Filter - This option allows you to display - all Plans/only mapped Plans/only unmapped Plans.

• Map to Gateways - Toggle button to map the unmapped Plans to the Gateway. Mapped Plans are displayed in green while unmapped Plans are displayed in red.

• Plan Status (Propagated or not)

• Search box to search for a particular Plan. Enter the query in the search box and click the search icon to display the results.

• Repropagate - This button allows users to repropagate propagated Plans.

To map the Plans to a Gateway:

1. Navigate to the Gateways screen.

2. From the list of Gateways, select the required Gateway and then click the Plan tab. The Plan tab displays a list of all the Plans under this particular Gateway.

   

   Fig. 3.440 Plan

3. Use the Mapped filter to filter Plans using the options: All, Mapped, Unmapped. You can also search for the required Plan using the Search box.

   

   Fig. 3.441 Mapped Filter

Note

Only Draft, Approved or Published plans are available to map.

4. In the row that has the Plan that you wish to map, click the Map to Gateways toggle button. Inversely, click the toggle button again to unmap

   

   Fig. 3.442 Toggle to Map

Map Gateway to Developer Organizations dialogue box appears as shown below.

Fig. 3.443 Mapped Toggle

5. Choose Deleloper Organization from the drop-down.

6. Click Update to map.

Although the Plan is mapped, it is not yet propagated. The Plan will be available to propagate in the Gateways Sync page.

Note

Gateway mapped plan which has an active subscription cannot be unmapped.

To repropagate the propagated Plan:

1. Navigate to the Plan tab.

2. Click Repropagate. The Propagate Plan dialog displays a list of already propagated Plans that are available for repropagation.

   

   Fig. 3.444 Propagate Plan

3. Select the required plans and click Repropagate. A success message displays upon successful propagation.

3.18.1.7. Subscription

Under the Subscription tab, you can find the list of all the Subscriptions that are mapped to this particular Gateway.

The Subscription tab displays all the mapped subscription along with details such as:

• Developer Name with subscription status details (active)

• Pack Name

• Plan Name

• Subscription Status (Propagated or not)

• Search box to search for a particular Plan. Enter the query in the search box and click the search icon to display the results.

• Repropagate - This button allows users to repropagate propagated Plans.

1. Navigate to the Gateways screen.

2. From the list of Gateways, select the required Gateway and then click the Subscription tab. The Subscription tab displays a list of all the Subscription under this particular Gateway.

   

   Fig. 3.445 Subscription

Note

If all the subscriptions under this tab are already mapped to the Gateway, then Mapped Filter option and Map to Gateways toggle button column will not be visible to the user.

Note

A Subscription can be mapped to only one Gateway and not multiple Gateways.

Although when a Subscription is mapped, it is not yet propagated. The Subscription will be available to propagate in the Gateways Sync page.

To repropagate the propagated Subscription:

1. Navigate to the Subscription tab.

2. Click Repropagate. The Propagate Subscription dialog displays a list of already propagated Subscriptions that are available for repropagation.

   

   Fig. 3.446 Propagate Subscription

3. Select the required subscription and click Repropagate. A success message displays upon successful propagation.

3.18.1.8. Usage Policy

Under the Usage Policy tab, you can find the list of all the Usage Policies that are mapped to this particular Gateway.

The Usage Policy tab displays the mapped Usage Policies along with details such as:

• Policy Name with status details (Draft/Approved/Published)

• Policy Type

• Mapped Filter - This option allows you to display - all Policies/only mapped Policies/only unmapped Policies.

• Map to Gateways - Toggle button to map the unmapped Policies to the Gateway. Mapped Policies are displayed in green while unmapped Policies are displayed in red.

• Policy Status (Propagated or not)

• Search box to search for a particular Policy. Enter the query in the search box and click the search icon to display the results.

• Repropagate - This button allows users to repropagate propagated Policies.

To map the Policies to a Gateway:

1. Navigate to the Gateways screen.

2. From the list of Gateways, select the required Gateway and then click the Policies tab. The Policies tab displays a list of all the Policies under this particular Gateway.

   

   Fig. 3.447 Policies

3. Use the Mapped filter to filter Policies using the options: All, Mapped, Unmapped. You can also search for the required Policy using the Search box.

   

   Fig. 3.448 Mapped Filter

Note

Only Draft, Approved or Published policies are available to map.

4. In the row that has the Policy that you wish to map, click the Map to Gateways toggle button. Inversely, click the toggle button again to unmap.

   

   Fig. 3.449 Toggle to Map

A notification message appears asking you to confirm the mapping.

Fig. 3.450 Mapped Toggle

5. Click Proceed to map. The Policy will be mapped. The toggle button will turn green.

Although the Policy is mapped, it is not yet propagated. The Policy will be available to propagate in the Gateways Sync page.

Note

Gateway mapped Usage policy which is consumed in a plan having active subscription cannot be unmapped.

To repropagate the propagated Policy:

1. Navigate to the Usage Policy tab.

2. Click Repropagate. The Propagate Plan dialog displays a list of already propagated Policies that are available for repropagation.

   

   Fig. 3.451 Propagate Policy

3. Select the required usage policy and click Repropagate. A success message displays upon successful propagation.

3.18.1.9. Backend Point

Under the Backend Point tab, you can find the list of all the Backend Points that are mapped to this particular Gateway.

The Backend Pointtab displays all the mapped Backends along with details such as:

• Server Name with details (Production/Sandbox)

• IP and Port details

• Description

• Mapped Filter - This option allows you to display - all Backends/only mapped Backends/only unmapped Backends.

• Map to Gateways - Toggle button to map the unmapped Backends to the Gateway. Mapped Backends are displayed in green while unmapped Backends are displayed in red.

• Status (Propagated or not)

• Search box to search for a particular Backend. Enter the query in the search box and click the search icon to display the results.

• Repropagate - This button allows users to repropagate propagated Backends.

To map the Backend to a Gateway:

1. Navigate to the Gateways screen.

2. From the list of Gateways, select the required Gateway and then click the Backend Point tab. The Backend Point tab displays a list of all the Backends under this particular Gateway.

   

   Fig. 3.452 Backends

3. Use the Mapped filter to filter Backends using the options: All, Mapped, Unmapped. You can also search for the required Backend using the Search box.

   

   Fig. 3.453 Mapped Filter

4. In the row that has the Backend that you wish to map, click the Map to Gateways toggle button. Inversely, click the toggle button again to unmap.

   

   Fig. 3.454 Toggle to Map

A notification message appears asking you to confirm the mapping.

Fig. 3.455 Mapped Toggle

5. Click Proceed to map. The Backend will be mapped. The toggle button will turn green.

Although the Backend is mapped, it is not yet propagated. The Backend will be available to propagate in the Gateways Sync page.

Note

Gateway mapped backend when associated with an API or any artifact cannot be unmapped.

To repropagate the propagated Backend:

1. Navigate to the Backend Point tab.

2. Click Repropagate. The Propagate Plan dialog displays a list of already propagated Policies that are available for repropagation.

   

   Fig. 3.456 Propagate Backend

3. Select the required backends and click Repropagate. A success message displays upon successful propagation.

3.18.1.10. Setting the Fault Configuration at each Gateway

Fault Configuration for all Gateways is by default set at Global level. You can edit the Default Fault Configuration settings configured at Global level, at each Gateway, by following the steps below.

To set the REST Fault Configuration at Gateway Level:

1. Navigate to the Gateways page.

2. Click the settings icon and then click the REST tab to open the Gateway Fault Configuration window.

   

   Fig. 3.457 Gateway Fault Configuration

3. Click to expand the Default Content Type accordion tab. At Gateway Level, you can overwrite the Gateway/Plan/Resource Level Content Type that was configured at Global level. Move the Overwrite toggler to the right to activate overwrite and do the inverse to retain the Default Content Type settings. Upon enabling Overwrite, the Content Type options for Gateway/Plan/Resource level will be enabled.

   

   Fig. 3.458 Gateway Content Type

4. Click the required Content Type (JSON/XML/PlainText) option to select to be configured at Gateway/Plan/Resource Level and then click Save.

5. Next, click to expand the Fault Structure accordion tab. At Gateway Level, you can overwrite the Gateway/Plan/Resource Level Fault Structure that was configured at Global level. Move the Overwrite toggler to the right to activate overwrite and do the inverse to retain the Default Fault Structure settings. Upon enabling Overwrite, the Fault Structure options for Gateway/Plan/Resource level will be enabled.

   

   Fig. 3.459 Gateway Fault Structure

6. (Optional) Edit the JSON/XML/PlainText Fault box to make any required changes to the Fault template at Gateway/Plan/Resource Level and then click Save to save the changes.

7. Next, click to expand the Scenario-wise Fault Message accordion tab. At Gateway Level, you can overwrite the Gateway/Plan/Resource Level Fault Message that was configured at Global level. Move the Overwrite toggler to the right to activate overwrite and do the inverse to retain the default Fault Message settings. Upon enabling Overwrite, the Fault Message options for Gateway/Plan/Resource level will be enabled.

   

   Fig. 3.460 Scenario-wise Fault Message

8. (Optional) Click the Response Code box corresponding to the Fault scenario to type in a different fault code in the box.

9. (Optional) Click the HTTP Code box corresponding to the Fault scenario to type in a different HTTP code in the box.

10. (Optional) Click the Fault Message Content box corresponding to the Fault scenario to type in a different Fault Message in the box.

11. Click Save. This will overwrite the default Fault Message settings.

After any changes in the Fault configuration at Gateway/Global configuration, gateway needs to be re-propagated.

To set the SOAP Fault Configuration at Gateway Level:

1. Navigate to the Gateways page.

2. Click the settings icon and then click the SOAP tab to open the Gateway Fault Configuration window.

   

   Fig. 3.461 Fault Configuration

3. Click to expand the Fault Structure accordion tab. At Gateway level, you can overwrite the Gateway/Plan/Operation level Fault Structure that was configured at Global level. Click the Overwrite toggler to activate overwrite and click again to disable overwrite and retain the Default Fault Structure settings. Upon enabling Overwrite, the Fault Structure options for Gateway/Plan/Operation level will be enabled.

   

   Fig. 3.462 Fault Structure

4. (Optional) Edit the XML Fault box to make any required changes to the Fault template at Gateway/Plan/Operation Level and then click Save to save the changes.

5. Next, click to expand the Scenario-wise Fault Message accordion tab. At Gateway level, you can overwrite the Gateway/Plan/Operation level Fault Message that was configured at Global level. Click the toggler to activate Overwrite and click again to disable overwrite and retain the Default Fault Message settings. Upon enabling Overwrite, the Fault Message options for Gateway/Plan/Operation level will be enabled.

   

   Fig. 3.463 Fault Message

6. (Optional) Click the Response Code field corresponding to the Fault scenario to enter a different fault code in the box.

7. (Optional) Click the HTTP Code field corresponding to the Fault scenario to enter a different HTTP code in the box.

8. (Optional) Click the Fault Message Content field corresponding to the Fault scenario to enter a different Fault Message in the box.

9. Click Save. This will overwrite the default Fault Message settings.

To set the GraphQL Fault Configuration at Gateway Level:

1. Navigate to the Gateways page.

2. Click the settings icon and then click the GraphQL tab to open the Gateway Fault Configuration window.

   

   Fig. 3.464 Gateway Fault Configuration GraphQL

3. Click to expand the Fault Structure accordion tab. At Gateway Level, you can overwrite the Gateway/Plan/Resource Level Fault Structure that was configured at Global level. Click the Overwrite toggler to activate overwrite and click it again to disable overwrite and retain the Default Fault Structure settings. Upon enabling Overwrite, the Fault Structure options for Gateway/Plan/Resource level will be enabled.

   

   Fig. 3.465 Gateway Fault Structure GraphQL

4. (Optional) Edit the JSON Fault box to make any required changes to the Fault template at Gateway/Plan/Resource Level and then click Save to save the changes.

5. Next, click to expand the Scenario-wise Fault Message accordion tab. At Gateway Level, you can overwrite the Gateway/Plan/Resource Level Fault Message that was configured at Global level. Click the Overwrite toggler to activate overwrite and click again to disable overwrite and retain the default Fault Message settings. Upon enabling Overwrite, the Fault Message options for Gateway/Plan/Resource level will be enabled.

   

   Fig. 3.466 Scenario-wise Fault Message GraphQL

6. (Optional) Click the Response Code field corresponding to the Fault scenario to enter a different fault code in the box.

7. (Optional) Click the HTTP Code field corresponding to the Fault scenario to enter a different HTTP code in the box.

8. (Optional) Click the Fault Message Content field corresponding to the Fault scenario to enter a different Fault Message in the box.

9. (Optional) For Plan and Resource level override, from the Select Fault Template drop-down, select Allow Override.

10. Click Save. This will overwrite the default Fault Message settings.

After any changes in the Fault configuration at Gateway/Global configuration, gateway needs to be re-propagated.

3.18.1.11. Setting Gateway Properties at Gateway Level

3.18.1.11.1. Core Properties

Under this section, you can configure the main gateway properties for each gateway at gateway level.

1. Navigate to the Gateways page.

2. Click the settings icon to open the Gateway Fault Configuration window.

Fig. 3.467 Gateway Fault Configuration

3. Click the Core Properties tab to configure the core gateway properties at gateway level. The default core properties for all gateways configured at global level can be overridden here.

   

   Fig. 3.468 Core Properties

4. Under Core properties tab, populate the mandatory details. Use the scroll to navigate up and down the screen.

• Possible protocols: Click the check-box to select any one or both of the protocols: HTTP / HTTPS.

• Cors Headers: Enter the Cors Headers that will allow you to whitelist requests to your gateway from certain locations like domain, scheme, or port.

• API Gateway Request Timeout: Enter the time (in ms) after which your API Gateway Request will be timed out.

• Attachment Download Content Type: Enter the content-type for file download.

• Attachment Upload Fault Content Type: Enter the content-type of fault response for file upload request.

• oAuth Token Masked: To enable masking of oAuth Token, click oAuth Token Masked toggle button to set the value to True. Click the toggle again to disable this option and set the value to False.

• Basic Header Masked: To enable masking of basic header, click Basic Header Masked toggle button to set the value to True. Click the toggle again to disable this option and set the value to False.

• WSSE Name Space: Enter the WSSE namespaces supported by the gateway.

• Soap Envelope NS: Enter the namespace identifier that defines the SOAP envelope.

• oAuth Base Path: Enter the oAuth basepath.

• oAuth Plugin Enabled: To enable oAuth plugin, click oAuth Plugin Enabled toggle button to set the value to True. Click the toggle again to disable this option and set the value to False.

• Http Client Connect Timeout: Enter the time taken (in ms) to establish connection with the client.

• Http Client Idle Timeout: Enter the time (in ms) during which a client connection is inactive.

• Http Client Max Pool Size: Enter the maximum number of connections acceptable from the client.

• Http Client Keep Alive: To allow client to send and receive multiple HTTP requests/responses using the same TCP connection, click Http Client Keep Alive toggle button to set the value to True. Click the toggle again to disable this option and set the value to False.

• Http Client Pipelining: To allow client to send multiple HTTP requests over a single TCP connection without waiting for the corresponding responses, click Http Client Pipelining toggle button to set the value to True. Click the toggle again to disable this option and set the value to False.

• Http Client Trust All: To trust all certificates using Http Client, click Http Client Trust All toggle button to set the value to True. Click the toggle again to disable this option and set the value to False.

• Access Token Header Key: Enter the access token header key.

• Client Id Header Key: Enter the client Id header key.

• Health Check URI: Enter the endpoint that determines the operational status of the service instance.

• Default Content Type For Request Enabled: To enable the default content type for request, click Default Content Type For Request Enabled toggle button to set the value to True. Click the toggle again to disable this option and set the value to False.

• Default Content Type For Response Enabled: To enable the default content type for response, click Default Content Type For Response Enabled toggle button to set the value to True. Click the toggle again to disable this option and set the value to False.

• Default Content Type Request SOAP1 1: Enter the default content-type for SOAP 1.1 request.

• Default Content Type Response SOAP1 1: Enter the default content-type for SOAP 1.1 response.

• Default Content Type Request SOAP1 2: Enter the default content-type for SOAP 1.2 request.

• Default Content Type Response SOAP1 2: Enter the default content-type for SOAP 1.2 response.

• Default Content Type Request REST JSON: Enter the default content-type for request Rest JSON.

• Default Content Type Response REST JSON: Enter the default content-type for response Rest JSON.

• Default Content Type Request REST XML: Enter the default content-type for request Rest XML.

• Default Content Type Response REST XML: Enter the default content-type for response Rest XML.

• Remove Token Delay: Enter the time taken (in ms) to release the token.

• Quota Usage Policy Sync To DB Frequency: Enter the time taken (in ms) to sync quota usage policy To database frequency.

• Dependency Connection Timeout: Enter the time (in ms) within which connection will be established between gateway and its dependent components.

• Health Check Fault Response Status Code: Enter the HTTP status code for health check.

• Print Incoming Response Enabled: To enable printing of all information from an incoming response, click Print Incoming Response Enabled toggle button to set the value to True. Click the toggle again to disable this option and set the value to False.

• Response Content Types: Enter the comma-separated content types for response.

• Response Content Type Validation: To enable validation of content type for response, click Response Content Type Validation toggle button to set the value to True. Click the toggle again to disable this option and set the value to False.

• Allow Empty Response Payload: To enable empty payload as part of http response, click Allow Empty Response Payload toggle button to set the value to True. Click the toggle again to disable this option and set the value to False.

• Enable Data Recordng On Failure: To enable data recording for every system failure, click Enable Data Recordng On Failure toggle button to set the value to True. Click the toggle again to disable this option and set the value to False.

• oAuth Rate Limit: Enter the oAuth rate limit.

• oAuth Rate Limit Time Unit: Enter the unit for measuring oAuth rate limit time.

• Enable Payloads To Store On Transaction Logs: To enable storing of payloads on transaction logs, click Enable Payloads To Store On Transaction Logs toggle button to set the value to True. Click the toggle again to disable this option and set the value to False.

5. Click Save to save the changes.

3.18.1.11.2. Alarm Properties

Under this section, you can configure the alarm properties for gateway responses for each gateway at gateway level.

1. Navigate to the Gateways page.

2. Click the settings icon to open the Gateway Fault Configuration window.

Fig. 3.469 Gateway Fault Configuration

3. Click the Alarm Properties tab to configure the alarm properties at gateway level. The default alarm properties for all gateways configured at global level can be overridden here.

   

   Fig. 3.470 Alarm Properties

4. Click each gateway response to populate the alarm properties under it.

• Error Type: From the dropdown, select the type of error encountered. The available options are: Warn, Error, Fatal, Info, Debug.

• Error Code: Enter the error code.

• Error message: Enter the error message to be displayed.

• Error Message Reason: Enter the cause of error.

  

  Fig. 3.471 Alarm properties for each response

Use the scroll to navigate up and down the screen.

5. Click Save to save the changes.

Listed below are the gateway responses for which alarm properties can be set:

1. Invalid Client IP: The gateway response when request is from invalid client IP.

2. Unauthorized Request: The gateway response when a client lacks valid authentication request.

3. Subscription Key Expired: The gateway response when the client tries to make a request after their subscription key has expired.

4. Subscription Term Expired: The gateway response when the subscription term of the client has expired.

5. Black Listed IP: The gateway response when the client’s IP is blacklisted.

6. White Listed IP: The gateway response when the client’s IP is not whitelisted.

7. Resource Not In Plan: The gateway response when the resource is not part of the plan.

8. Request Time Out: The gateway response when the client request has timed out.

9. Invalid Authentication: The gateway response when client authentication fails due to invalid credentails.

10. Rate Limit Exceeded: The gateway response when the number of client requests exceeds the prescribed rate limit.

11. Monthly Limit Exceeded: The gateway response when the number of client requests exceeds the prescribed monthly limit.

12. Endpoint Limit Exceeded: The gateway response when the number of client requests exceeds the prescribed limit for the backend endpoint.

13. MCT Limit Exceeded: The gateway response when the number of client requests exceeds the prescribed maximum concurrent transactions.

14. Request Handling: The gateway response when the gateway is unable to send request to the backend due to connection to the backend issue.

15. Response Handling: The gateway response when the gateway is unable to handle the backend response either due to missing or unsupported Content-Type or due to invalid response body.

16. Unexpected Error In Endpoint Protection: The gateway response when there is an unexpected error in endpoint protection.

17. Empty Request Body: The gateway response when request body is empty.

18. Invalid Request Body: The gateway response when request body is invalid.

19. Request Schema Validation Failed: The gateway response when request body is not as per the schema.

20. Response Schema Validation Failed: The gateway response when response body is not as per the schema.

21. WSDL Not Found: The gateway response when WSDL file is not found for WSDL download requests.

22. Actual EP Not Populated: The gateway response when actual endpoint is not populated.

23. Invalid Configuration: The gateway response for an invalid configuration error.

24. Gateway Configuration: The gateway response when the required artefacts are not configured or propagated.

25. OAuth Plugin Configuration: The gateway response when there is oAuth Plugin configuration error.

26. OAuth Server: The gateway response when the gateway is unable to connect to oAuth server.

27. OAuth Server Timeout: The gateway response for OAuth server timeout.

28. OAuth Plugin Execution: The gateway response when there is an error in oAuth plugin during execution.

29. Invalid OAuth Request: The gateway response for invalid OAuth request.

30. Connection Closed: The gateway response when the backend endpoint has closed connection with gateway before responding.

31. SSL Connection Failed: The gateway response for failed SSL connection.

32. Connection Refused: The gateway response when the gateway is unable to connect to the backend endpoint.

Next Steps

In the next section, we will learn about synchronizing Approved artifacts to the Gateway.