This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Sharing Applications Between Multiple Groups

WSO2 API Cloud provides the facility for users to share their applications and subscriptions with a specific group(s). Users can view and manage applications and subscriptions belonging to other users in the same group.  

The API Cloud uses role names as the grouping entity.  In order to enable sharing, a role name, as the group must be specified when creating an application. All users who have been assigned that role,  will share the application and subscriptions which have that role name as the grouping entity, within the tenant domain.

Before you Begin

In this tutorial, you will share an Application and a subscription among two users who has the same role, within the same tenant domain.


Let's get Started.

  1. Go to http://cloud.wso2.com and check if you have two users with a shared role. For this tutorial I will be using users Sam@mailinator.com, Joe@mailinator.com & the role 'AppSharingRole'.
  2. Sign in as Joe@mailinator.com and add application 'JoeTestSharedApplication'. Make sure to add the role 'AppSharingRole' in the Groups field. Please note that the role 'AppSharingRole' is a role used in the tutorial for better explanation. Alternatively, an already existing role or a custom role can be used for this purpose.

  3. Verify the group is correctly set, when viewing the application details.
  4. In a separate browser session, Sign in to the store as Sam@mailinator. com.
  5. Click on Applications and view all Applications. Notice the shared application being listed. Sam can view  Joes application that Joe shared with the 'AppSharingGroup'.

  6. Click on API's and select PhoneVerification API.
  7. When the 'Application' drop down is expanded the shared application will be visible. Subscribe the API to the shared application.
  8. Verify the Subscription by  clicking "View All Subscriptions" on the pop up box that appears. Alternatively, click on Applications, select  'JoeTestSharedApplication'  and click on the subscriptions tab.
  9. Note that at this point, Sam cannot create keys for the application because Sam is not the owner of the application. Once Joe generates the keys once, the keys will be visible to Sam. Sam will then be able to regenerate keys for the application.
  10. Now, from Joe@malinitaor.coms API store, click on Applications. Notice that the subscription count is shown. The subscriptions are shared.
  11. Click on the Application "JoeTestSharedApplication" and click on the "Subscriptions" tab.
  12.  Generate Keys for the application.
  13. Now from Sam's store view check the visibility of the keys. Sam can also regenerate keys for the shared application.
  14. You have shared Applications and Subscription among users within the same tenant having the same role assigned.