Managing and Socialising APIs running outside of API Connect.
There are many places today to run your APIs. zOS Connect and Akamai are two such examples. Though I recommend that DataPower runs all APIs, if different API Gateways are available then you may want to socialise all of your APIs throught a single shop window. However these APIs still need to be managed and socialised. API Connect has a lesser known feature that allows you to manage and expose on portal APIs running on other platforms. This is where the enforced option comes in. Please note that authentication, authorisation and other policies will not be enforced through API Gateway as DataPower is not being used.
You would still use the same swagger spec but set the host variable to point to the external API Gateway and set the enforced option to false.. A sample is below.
swagger: '2.0'
info:
title: HTTPBin Example
x-ibm-name: httpbin-example
version: 1.0.0
host: httpbin.org
schemes:
- https
basePath: /
x-ibm-configuration:
cors:
enabled: true
type: rest
phase: realized
enforced: false
testable: true
application-authentication:
certificate: false
paths:
/ip:
get:
responses:
'200':
description: success
schema:
type: string
consumes: []
produces: []
In the Portal it will appear like the following.
For a demo on how to do this please take a look at the following developer works article. https://developer.ibm.com/APIconnect/2019/05/20/consolidated-and-unified-catalog-with-API-connect/
Thanks to Takashi Sakairi and Swetha Sridharan for proof reading.