Part 1: Enable SAP Cloud Platform API Management in Cloud Foundry Environment

SAP Cloud Platform API Management lets you publish, promote, and oversee APIs in a secure and scalable environment. It is available in both Neo and Cloud Foundry Environment. In this blog steps to enable SAP Cloud Platform API Management in Cloud Foundry environment is covered.

SAP Cloud Platform API Management is not yet available in Cloud Foundry trial environment and therefore this steps can be tried out from a production account.  For SAP Cloud Platform Integration Suite, you can also follow this blog to enable the API Management capabilities.

Subscribe to API Management services in Cloud Foundry

• Logon to SAP Cloud Platform
• Navigate to your Global Account and then click New Subaccount button.  In case you already have a sub account for your Cloud Foundry Region this step can be skipped.
• In the New Subaccount popup dialog, enter a display name for your sub account. Select Cloud Foundry from the environment drop down list and from the provider drop down list select Amazon Web Services ( AWS) or Azure. From the region drop down list select your Region and click on Create button.

Create new sub-account dialog

• After creation the status will change Once the new sub account is created, click on the Enable Cloud Foundry button to enable Cloud Foundry organization and space in your account. Enter a name for your Cloud Foundry organization and click Create. In case you already have a sub account in Cloud Foundry Region this step can be skipped.

• Based on your entitlements and necessary license, under Subscriptions tab SAP Cloud Platform API Management tiles would be visible.  Navigate to Subscriptions tab and check for API Management, API portal and API Management, developer portal tiles.

• Select API Management, API portal tile and then click on Subscribe button to enable API Portal functionality in your Cloud Foundry environment. After Subscribe button is clicked, status would change to Processing and this would take few minutes while the API Portal service is getting activated in the selected tenant.

Subscribe to API Portal

• In Cloud Foundry environment based on your business needs you can selectively enable Developer Portal functionality of SAP Cloud Platform API Management. If you would like to enable the Developer Portal functionality then from drop down at the top select API Management, developer portal and click Subscribe. After Subscribe button is clicked, status would change to Processing and this would take few minutes while the Developer Portal service is getting activated in the selected tenant.

Subscribe to Developer portal

• With this you have successfully enabled API Portal & Developer Portal functionality of API Management.

Initial Configuration & Set up of API Management services

Next the initial configurations like setting of Virtual hosts, API Portal administrator, Developer portal set up has to be completed.  To access the initial configuration setup, your user would have to be assigned the role APIMangement.SelfService.Administrator and AuthGroup.SelfServcie.admin

• To assign roles, navigate to your sub-account overview page and select Trust Configuration from Security.

Navigate to Trust Configuration

• Choose an active Identity Provider from the list of available identity providers. In the default scenario you should be able to select the SAP ID Service.

Select the Identity Provider

• Enter your user ID from the selected Identity Provider service. In case of SAP IDP Service, you can enter email address of the user and click on Show Assignments and then select Assign Role Collection.

Assign Role Collection

• Select APIMangement.SelfService.Administrator role collection from drop down and select option Assign Role Collection.

Assign APIManagement.SelfService.Administrator role

• If you would like to enable Developer Portal capabilities, then repeat the above steps to also add role collection AuthGroup.SelfServcie.admin to your user.

• Navigate to Subscription tab, select API Management, api portal and select Go to Application link.

Navigate to API Management, API portal application

• Based on your configured identity provider you will be redirected to enter your user credentials and after successful log-in, A Configure the API Management Service screen appears. Perform the following steps: – 

• • In the Account section, select the Account Type.
    • Select Non Production account type for non-business critical activities, integrating test systems, testing new scenarios, performance testing, and sandbox activities.
    • Select Production account type for business critical usage, integrating production systems, and productive APIs.
  • In the Virtual Host section, enter the Host Alias.

    Virtual hosts are the base URLs of an API Proxy that identifies your organization. Once you enter the host alias, your API Proxy would appear in the default API Management domain as shown below:

    Example: https://{virtualHost}.apimanagement.hana.ondemand.com.

  • Provide an e-mail ID in the Notification Contact field to receive updates. You can also add multiple e-mail IDs. To add more than one e-mail ID, press the Tab button on the keyboard.
  • Select the Make <User ID> API Portal administrator checkbox to assign the APIPortal.Administrator role to the mentioned user. Assigning administrator role helps the user to access API portal user interface and services.

• You can view the entered values and confirm the setup values.

• You can view the set up progress for each of phases of API Portal service configuration. As part of testing the setup, a sample HelloWorld API Proxy will be deployed on the newly configured API Portal.

• After a successful service enablement, you would have to logout and log-in again for the on-boarding changes for API Portal administrator roles to be reflected in the current session.

Logout from API Portal

• After successful login you can view & explore the features of API Portal.

API Portal Home Page

HelloWorld API Proxy pre-deployed for tryout

• Next you can also enable your Developer portal service. Navigate to SAP Cloud Platform cockpit -> Subscription tab, select API Management, developer portal and select Go to Application link.

Developer portal service

• Based on your configured identity provider you might be redirected to enter your user credentials and after successful log-in, wait for sometime till Developer Portal is successfully set up. After set up of Developer Portal , logout and login for all changes to be reflected.

• After re-login you can on-board yourself as an Application Developer on Developer Portal side. For this, click on the Register button.

Register as Application Developer

• In the Register dialog, select your country of origin and then select OK.

Register as Application Developer Dialog

• After registration, logout and log-in again for the role changes to be reflected.

With this you have successfully enabled SAP Cloud Platform API Management service in Cloud Foundry environment.

Note:- If you encounter any issue while on-boarding of SAP Cloud Platform API Management, you raise a customer service incident on the component OPU-API-OD-OPS.

Stay tuned, more blogs on API Management in Cloud Foundry environment to come:

• Enable API Management capability ( current blog)
• Connect to on-premise APIs
• Service Plans of API Management
• Manage integration flow from Cloud Integration