Collaborative API Development Sample¶
This sample scenario elaborates as to how you can develop APIs in a collaborative manner while maintaining different levels of ownership and permissions.
Use case¶
-
Each business unit is responsible for their APIs and data. Some of them contain sensitive data. They need to consider security and controllability while providing value to the other business units.
-
Ability to restrict an API (and its development) by business units (e.g., Ability to restrict APIs (view/edit access) that are developed by financial business units to other business units.
-
Selected APIs should be able to be shared (view/edit access) with different business units.
Business story¶
-
ABC organization has separate departments for finance and for operations other than their core business department, which is mobile phone manufacturing (manufacturing department).
-
The core business department is named
department_core
, the finance department is nameddepartment_finance
, and the operations department is nameddepartment_operations
. -
The finance department handles the salaries of the employees. The core department is responsible for maintaining the mobile phone manufacturing stock. The operations department handles the maintenance work of the organization.
Running the sample¶
Run the sample as follows to populate the sample data:
-
Download the WSO2 API Manager sample scenarios.
-
Unzip the sample-scenarios ZIP file and rename the unzipped folder to
sample-scenarios
. - Copy the sample-scenarios folder to the
<API-M_HOME>
folder. -
Start the WSO2 API Manager Server.
-
Go to
<API-M_HOME>/sample-scenarios
directory and execute therun.sh
file../run.sh
-
Enter the scenario number as 2, when prompted.
User credentials¶
The following are the user credentials that you need to use when signing in to the WSO2 API Manager instance that has the sample data populated.
User | Username | Password |
---|---|---|
Finance department user | [email protected] | 123123 |
Manufacturing department user | [email protected] | 123123 |
Operations/Maintenance department user | [email protected] | 123123 |
Implement the scenario¶
Follow the instructions below to implement the latter mentioned business scenario using WSO2 API Manger.
-
Create three different tenants (
finance.abc.com, core.abc.com,
andoperations.abc.com
) for the three departments, with users (John, Tom, and Bob respectively) who can create APIs. -
Sign in as a finance department user, subscribe to the
Salary_details_API
API to get the employee salary details. The screen shot below shows that user John can subscribe to theSalary_details_API
API as John belongs to the finance department.The screen shot below shows that John can see the API in the publisher view and develop it. 3. Sign in as a manufacturing department (core department) user, subscribe to the
Mobile_stock_API
API to get current mobile stock details. The screen shot below shows that user Tom can subscribe to theMobile_stock_API
API as Tom belongs to the core manufacturing department.The screen shot below shows that Tom can develop the
Mobile_stock_API
API as Tom belongs to core manufacturing department.The screen shot below shows that John cannot subscribe to the
Mobile_stock_API
API as John does not belong to the core manufacturing department.4. Sign in as an operations' department (maintenance department) user, subscribe to the
Maintenance_ask_API
API to get the required maintenance tasks for the day. -
Allow visibiliy of the
Employee_info_API
API only to the finance and manufacturing departments, and restrict it to the operations departments, so that the finance and manufacturing departments can get the number of employees working in the core departments.Tip
From this you can share/restrict the consumption of the API in the Developer Portal , but you can not share/restrict editing of the API in Publisher. This has been identified as a GAP in WSO2 API Manager 2.1.0
The screen shots below show that both John and Tom can subscribe to the
Employee_info_API
API as both of them have been given the privilege to access theEmployee_info_API
API.