TIBCO Cloud Integration(TCI) to Mashery Integration End to End

TIBCO Cloud Integration(TCI) to Mashery Integration End to End

book

Article ID: KB0073646

calendar_today

Updated On:

Products Versions
TIBCO Cloud N/A

Description

The following article contains the steps to publish an endpoint from TIBCO Cloud Integration to Mashery
NOTE: This article is applicable for TIBCO Cloud Integration-Develop (flogo) and Integrate ( Businessworks ) Apps.

Issue/Introduction

End to End article on publishing and testing an endpoint from TIBCO Cloud Integration(TCI) to Mashery

Resolution

 

1. Log in to Cloud account (www.cloud.tibco.com)
User-added image
2. Choose Integration domain and launch integration Apps

User-added image
User-added image

3. Click on Create/Import and Select Flogo to create new app
User-added image

User-added image

4. Click on Import  [Note : you can click on default app name to rename the app]

User-added image

5. Click on browse to upload and select the json file from local device. Click on create. 
User-added image

6. Once file is uploaded, Flows are automatically created. Review the flows. App is ready to be pushed.
User-added image

7. Once app is pushed, you can view and test the endpoint by clicking on endpoints tab. If the app is scaled up, you can also test the endpoint in a REST client like Postman

User-added image
User-added image

8. Now, that the app is tested, it is ready to be published to Mashery. You can Publish a public endpoint as shown below 

User-added image

9. On the publish to Mashery pop-up screen, select your TIBCO Cloud Mashery area from the Traffic Manager Domain dropdown and click on Next.

NOTE: For users with TIBCO Cloud Mashery subscriptions in the same level of organization, we are not required to provide a username and password since we are already signed in.

User-added image

NOTE: If you do not have a TIBCO Cloud Mashery subscription in the same Organization and want to publish to TIBCO Cloud Mashery in a different Organization or to the Area in Classic Mashery, click on the Advanced button and enter the requested details ( Service user credentials, Area UUID, and Traffic manager domain) and click on Next. 

User-added image

Details to be entered in the advanced section can be found in your mashery control center. Traffic manager domain is "<area_name>.api.mashery.com".
User-added image

10. Click on +New Definition to create a new API definition.
User-added image

11. After clicking create, select the newly created API from the displayed list.
User-added image

12. Next, select the operations that you want to publish and click on Next.
User-added image

13. In the next screen, select a package from the list. You can also create a new package.
User-added image

14. Next, Create a new plan or select an existing one and click on Add.
User-added image

17. Click on publish
 
User-added image

18. On clicking on "API definition at Mashery", you will be redirected to your API definition in Mashery.
User-added image

You can view API settings by clicking on endpoint => Domains&Traffic Routing
User-added image


19. You can make changes to the Package and plan by navigating to Design => Packages.
      Select the package.
  User-added image
 Next, select the plan.
User-added image

You can make changes under the Rate Limit and plan settings sections.
User-added image


20. Next, we need to create an application. To do so, select Manage => Applications. Create a new application.
User-added image

Enter the application name and owner. The owner has to be an existing user in the organization. Select save and close.
User-added image


21. Once the application is created we need to generate a package key. Click on created application. Select the Package keys section to create a new package key.
User-added image

Select a package and plan and generate a package key. Hit Save and Close. A new key is generated.
User-added image

Click on the waiting status to Enable the package key.
User-added image


22. Now, you are ready to test the TCI private endpoint published to Mashery. The endpoint can be tested using POSTMAN using the endpoint address shown in the API endpoint Settings in point 18.
User-added image

NOTE:

  • An app in TCI can have private or public endpoints. As of TCI 1.34.0, private Endpoints are only meant for intercommunication such as TCI->LA, TCI->Mashery use cases & are not accessible to anyone else or from other child organizations but only to other tenants like LA, etc.
  • You need  API Manager or Administrator role access in order to be able to publish the TCI endpoint to Mashery.
  • You cannot make an endpoint private after publishing it to Mashery. If this is done, a republish will be required.
  • Not all the Mashery areas are integrated with the TIBCO Cloud. For the ones that are, we can use cloud accounts to directly publish to Mashery using SSO. To publish a TCI endpoint to Mashery in a different organization or from TCI to the Classic Mashery area, you would need to use the credentials of the ServiceAccount user instead of the SSO user.
  • Each Mashery area has a service account. The service account credentials are given to the customer. Here's an example:
      User-added image
  • You cannot use a cloud account to log in to https://developer.mashery.com/ in order to get a Mashery API key/secret. You need to use the service account.
  • A BW SOAP Endpoint in TCI cannot be published to Mashery using the wizard in TCI.