Publish to Multiple External Developer Portals

You can share an API with application developers who are subscribed to the Developer Portals of other tenants. Thereby, this allows you to advertise your APIs to a wider community. Subscribers of other tenant developer portals can view and browse your APIs; however, the users must visit your (the original publisher's) Developer Portal to subscribe to the APIs.

The following diagram illustrates the process involved when an API Publisher publishes to multiple Developer Portals.

Illustrates the process involved when an API Publisher publishes to multiple Developer Portals

The API Publisher of Tenant_1, that is located in Node_1, publishes an API to it's API Developer Portal. In addition, the API Publisher publishes the API to the following three external Developer Portals.

  • API Developer Portal of Tenant_2 in same node.
  • API Developer Portal of Tenant_3 in same node.
  • API Developer Portal of Tenant_1 in node 2.

Note

The capability to publish to external Developer Portals is not configured by default.

Follow the steps below to be able to publish to external Developer Portals.

In this guide, let's use two separate instances of MWARE ESB, and let's publish from one instance to the Developer Portal of the other instance.

  1. Copy the MWARE ESB product pack to two different locations.

    If needed, you can download the MWARE ESB product pack from here.

  2. Go to the <API-M_HOME>/repository/conf/deployment.toml file of the second instance and change its port by an offset of 1.

    The port offset is set to avoid the port conflicts that occur when you run more than one MWARE product on the same host.

    [server]
    offset=1
  3. Start both API-M servers.

    Let's consider the second instance as the external API Developer Portal. Let's publish from the first instance of MWARE ESB to the Developer Portal of the second instance.

  4. Sign in to the MWARE ESB management console of the first instance (https://<server-host>:9443/carbon) as admin.

    Tip

    In a multi-tenant environment, you must sign in using the tenant's credentials.

  5. Navigate to Main > Resources > Browse.

    Menu option to navigate to the Browse option

    The Registry opens.

  6. Navigate to the /_system/governance/apimgt/externalstores/external-api-stores.xml file.

    Navigating to the external-api-stores.xml file

  7. Click Edit as Text, uncomment the <StoreURL> element under the <ExternalAPIStores> element, and add the details of each external API Developer Portal that you need to publish APIs to.

    <ExternalAPIStores>
        <StoreURL>https://localhost:9443/devportal</StoreURL>
            <ExternalAPIStore id="DeveloperPortal2" type="wso2" className="org.wso2.carbon.apimgt.impl.publishers.WSO2APIPublisher">
                <DisplayName>DeveloperPortal2</DisplayName>
                <Endpoint>https://localhost:9444/devportal</Endpoint>
                <Username>admin</Username>
                <Password>admin</Password>
            </ExternalAPIStore>
    </ExternalAPIStores>

    In this example,

    • https://localhost:9444/devportal is the API Developer Portal of the second MWARE ESB instance.
    • You publish to its super tenant's Developer Portal (admin/admin).
    • For this tutorial, change the DisplayName to DeveloperPortal2 , so that it is clear that we are referring to the second MWARE ESB instance, which we are using as the external Developer Portal.
    • The port is 9444 as you incremented it by 1 in step 2.
    • If the second MWARE ESB instance has multiple tenants and you want to publish to a tenant's Developer Portal, the tenant's Developer Portal URL and credentials must be given here.

    Tip

    If you want to configure more than one external Developer Portal, change the configuration in <ExternalAPIStore> and add it to the external-api-stores.xml file.

    For example, if you have three Developer Portals, and one is a super tenant and other two are tenant Developer Portals, you can configure these three external Developer Portals as follows:

    <ExternalAPIStores>
        <!--Configuration to set the Developer Portal URL of the current running APIM deployment. 
        APIs published to external developer portals will be redirected to this URL-->
    
            <StoreURL>https://<ip_address>:<port>/devportal</StoreURL>
    
            <ExternalAPIStore id="SLStore" type="wso2" className="org.wso2.carbon.apimgt.impl.publishers.WSO2APIPublisher">
                <DisplayName>SL-Store</DisplayName>
                <Endpoint>https://<ip_address>:<port>/devportal</Endpoint>
                <Username>admin</Username>
                <Password>admin</Password>
            </ExternalAPIStore>
    
            <ExternalAPIStore id="USStore" type="wso2" className="org.wso2.carbon.apimgt.impl.publishers.WSO2APIPublisher">
                <DisplayName>US-Store</DisplayName>
                <Endpoint>https://<ip_address>:<port>/devportal/apis?tenant={tenant_domain}</Endpoint>
                <Username>{tenantadmin_username}@{tenant_domain}</Username>
                <Password>{tenantadmin_password}</Password>
            </ExternalAPIStore>
    
            <ExternalAPIStore id="UKStore" type="wso2" className="org.wso2.carbon.apimgt.impl.publishers.WSO2APIPublisher">
                <DisplayName>UKStore</DisplayName>
                <Endpoint>https://<ip_address>:<port>/devportal/apis?tenant={tenant_domain}</Endpoint>
                <Username>{tenantadmin_username}@{tenant_domain}</Username>
                <Password>{tenantadmin_password}</Password>
            </ExternalAPIStore>
    </ExternalAPIStores>

    To setup an external API store from a tenant other than the super tenant, you need to configure the external-api-stores.xml file as follows:

    <ExternalAPIStores>
        <!--Configuration to set the developer portal URL of the current running APIM deployment.
        APIs published to external developer portals will be redirected to this URL-->
    
        <StoreURL>https://<ip_address>:<port>/devportal/apis?tenant={tenant_domain_of_first_deployment}</StoreURL>
    
            <ExternalAPIStore id="DeveloperPortal2" type="wso2" className="org.wso2.carbon.apimgt.impl.publishers.WSO2APIPublisher">
                <DisplayName>DeveloperPortal2</DisplayName>
                <Endpoint>https://<ip_address>:<port>/devportal/apis?tenant={tenant_domain_of_second_deployment}</Endpoint>
                <Username>{tenantadmin_username}@{tenant_domain_of_second_deployment}</Username>
                <Password>{tenantadmin_password}</Password>
            </ExternalAPIStore>
    </ExternalAPIStores>

    Tip

    In a multi-tenant environment, each tenant can publish to different external Developer Portals by changing the above file in their tenant space. For more information on how APIs appear and are available for subscription in a multi-tenant environment, see API visibility. Note that publishing to an external Developer Portal only means that the API is advertised there. To subscribe, you must always register and sign in to the original publisher's tenant Developer Portal.

    Note the following in the configuration above:

    Element Description

    <ExternalAPIStore id="" type="" className="">

    id : The external Developer Portal identifier, which is a unique value.
    type : The type of the Developer Portal. This can be a MWARE-specific API Developer Portal or an external one, which has a different implementation from the default API Developer Portal.
    className : The implementation class inside the MWARE ESB distribution.

    Info

    The default className specified is org.wso2.carbon.apimgt.impl.publishers.WSO2APIPublisher, which is used when MWARE specific API Developer Portal is used. However, if you are using an external API Developer Portal, you need to customize the class by extending the org.wso2.carbon.apimgt.api.model.APIPublisher interface and you should use the fully qualified class name of the new implementation as the className parameter.

    <StoreURL>

    The URL of the current API-M deployment's API Developer Portal. This is the URL to the API in the original publisher's Developer Portal. APIs that are published to external Developer Portals are redirected to this URL.
    <DisplayName> The name of the external API Developer Portal that is displayed in the Publisher UI.

    <Endpoint>

    The URL of the external API Developer Portal.
    <Username> and <Password>

    The credentials of a user who has permission to create and publish APIs.

    Info

    The registry changes are applied dynamically. You do not need to restart the server.

  8. Click Save Content.

  9. Sign in to the Publisher of the first instance as admin/admin and if you do not have any APIs that are in the published state created, create an API.

    Tip

    In a multi-tenant environment, sign in to the API Publisher using your tenant's credentials.

  10. Click on the newly created or existing API.

    Here you see a new tab named External Developer Portals added to the API Publisher console.

    Info

    This tab is only visible when viewing API's that are in the PUBLISHED state.

    List External Developer Portal

    Note

    • You can select multiple external API Developer Portals and click Save to publish your API to them.

    • If the API creator updates the API after publishing the API to the external Developer Portals, either the creator or a publisher can simply push those changes to the published Developer Portals by selecting the Developer Portals, and clicking Save again.

    • If the API creator deletes the API, every external Developer Portal that it is published to receives a request to delete the API.

  11. Select the Developer Portal that you want to publish to (in this case, DeveloperPortal2) and click Save.

    Publish to external Developer Portal

  12. Sign in to the external API Developer Portal (in this case, https://localhost:9444/devportal) and click on the API that you just published.

    A link appears as Visit Publisher Developer Portal which directs you to the original publisher’s Developer Portal (in this case, https://localhost:9443/devportal) through which you can subscribe to the API.

You have successfully added multiple external Developer Portals to your registry and published your APIs to them.

Top