In this lesson, the following topics are discussed:
- What are Products in the context of SAP API Management?
- Create and publish a Product.
- Show Products at API Business Hub Enterprise Portal.
- Navigate to your Product.
- Navigate to your API.
- API Business Hub Enterprise portal in a glance.
What are Products in the Context of SAP API Management?
Products are artifacts that appear on the SAP API Business Hub Enterprise portal. The SAP API Business Hub Enterprise portal is accessed using its own URL. This is accessible in the SAP Integration Suite cockpit through the navigation in the upper right corner of the interface.
After opening the API Business Hub Enterprise portal, the products are displayed as tiles. The API used under a product corresponds to the API Proxy URL of the corresponding API.
Needed Roles (Role Collection) to use the API Business Hub Enterprise
To open the API Business Hub Enterprise portal, one of the following role collections is required:
- AuthGroup.API.Admin
- AuthGroup.API.ApplicationDeveloper
We have already assigned both role collections to the user when provisioning the Integration Suite capabilities.
If you are coming via learning.sap.com then you have to assign your user account to the mentioned Role Collections.
Open a API Business Hub Enterprise portal with published products as a sample
In this screenshot, you can see an already created product named 01_API_GWSAMPLE_BASIC_v1 based on the GWSAMPLE_BASIC_v1 API.
This page is empty, if you have not yet created a product.
The products can then be searched for, found, and consumed by developers.
Procedure for creating a Product
Note
You perform this step in the SAP Integration Suite cockpit.
The following steps must be carried out in the following order:
- Create a Product using the Create button.
- Add the entries under the Overview tab.
- Add an API under the APIs tab.
- Choose the Publish button.
- Open the API Business Hub Enterprise portal.
- Check out your Product.
Create and Publish a Product
Prerequisite for creating a product is a working API. The creation is started using Engage. Then navigate to the Products tab.
Choose the Create button, to start the procedure.
At least the following entries must be made:
- Tab: Overview
- The Name and Title should be the same. The Title is the heading of the tile. The description is also displayed on the tiles and is intended to give the user the most important information about the API.
- Example
- Name: P_GWSAMPLE_BASIC_v1 Title: P_GWSAMPLE_BASIC_v1 Description: An API based on the Enterprise Procurement Model (EPM). Authentication is done using policies. No additional authentication is required.
The other entries such as Quota, Requests Every and Scope are optional and must be defined by policies.
A sample setting for that is found here: Create a Product
- Tab: APIs
Here you can choose your previous created API proxy, which you can add to your creating API product. When you select the Add button, all available APIs are displayed. You can assign any combination of the displayed APIs. It is also possible to combine individual resources.
In the following case, the entire (all resources) of the GWSAMPLE_BASIC_v1 API is added.
Entries under the tabs Permissions, Rate plans and Custom Attributes are optional.
A sample setting of custom attributes is described here: Custom Attributes
Publish your Product
After the product has been configured, the product implementation must be published on the API Business Hub Enterprise portal. This is called Publish.
Show Products at API Business Hub Enterprise Portal
The API Business Hub Enterprise portal is its own application. This was provisioned together with SAP management.
The API Business Hub Enterprise portal is connected to the API Management using its own URL. These can be checked under Settings → API if problems occur.
After opening the API Business Hub Enterprise portal, as described above, all published products display as tiles.
Navigate to Your Product
At the moment you still have the possibility to choose between two representations. We use the new design. Navigate into the tile, you will be routed to the Test Environment tab.
Explanations:
- No. 1: Here is your description of the product.
- No. 2: Here is the metadata of the product.
- No. 3: The design decision.
- No. 4: The logged-in user.
To test the API, navigate to the APIs tab. Here you can now see the title of the assigned API. In this case, it is GWSAMPLE_BASIC. The name of this API is GWSAMPLE_BASIC_v1. The product name is P_GWSAMPLE_BASIC_v1.
Navigate to Your API
When you select the tile with the title of the associated API, you are in the API. Under the tab, API Reference, you will find the swagger UI for calling the assigned resources.
If you successfully test a selected resource, here GET/ProductSet, you will see the well-known Proxy URL from SAP API Management as a Request URL.
API Business Hub Enterprise Portal at a Glance
The API Business Hub Enterprise portal offers a platform to deploy products with your associated APIs, centrally in your enterprise. This should be the only place where developers search, find, and test APIs, and ultimately consume the corresponding proxy URL in their own processes. For this purpose, the API Business Hub Enterprise portal offers the following:
- Your own user management.
- A role-based access to the products.
- An additional authentication Layer with its own API key.
- A self-registration Unknown developer.
Resources
Resources are available at SAP Help: SAP Help Portal
Resources are also available at Blogs: Protect Your API Proxy by Adding Application Key Verification | Tutorials for SAP Developers
Summary
A product in the context of SAP API Management is its own artifact that encapsulates created APIs or parts of them (resources). The product is configured and deployed (publish) on the API Business Hub Enterprise portal. The product can be tested on the API Business Hub Enterprise portal. Access to the products can be restricted through roles.
