Set Up Your SAP Cloud Platform Integration Tenant

0 %

Set Up Your SAP Cloud Platform Integration Tenant

Details

Set Up Your SAP Cloud Platform Integration Tenant

2020-04-01

Beginner

15 min.

Subscribe to the Process Integration service, assign required roles, and use the self-service application to provision your own SAP Cloud Platform Integration tenant.

You will learn

How to subscribe to the Process Integration service
How to set up your own SAP Cloud Platform Integration tenant

Step 1: Enter trial account and subscribe to Process Integration

In your web browser, open the SAP Cloud Platform trial cockpit.
Navigate to the trial global account by clicking Enter Your Trial Account.

If this is your first time accessing your trial account, you’ll have to configure your account by choosing a region (select the region closest to you). Your user profile will be set up for you automatically.

Wait till your account is set up and ready to go. Your global account, your subaccount, your organization, and your space are launched. This may take a couple of minutes.

Choose Continue.
From your global account page, choose the trial tile to access your subaccount.
Select Subscriptions > Process Integration.
Select Subscribe.

Wait for the process to complete. The status changes to Subscribed in green.

Done

Log on to answer question

Step 2: Assign required roles

IMPORTANT:
With this step, you define permissions for users accessing SAP Cloud Platform Integration. For different tasks, different role templates are predefined. Each role template contains the permissions for a set of tasks done by a typical persona such like the integration developer. We propose that you define an own role template that contains the most important role templates predefined by SAP.

In the breadcrumbs, select your subaccount to navigate to the subaccount level.
Select Security > Role Collections > New Role Collection.
In the Name field, enter Tenant_Administrator and choose Save. Select the newly created Tenant_Administrator role collection.
This newly defined role collection will be used to group all role templates predefined by SAP that you like to assign.
Choose Add Role. In the Role Template dropdown list, select AuthGroup_Administrator and click on Save.

IMPORTANT: If you have multiple application identifiers, choose the application identifier that starts with ‘it’.
Using the same procedure from the previous step, add AuthGroup_BusinessExpert and AuthGroup_IntegrationDeveloper role templates to the role collection.

IMPORTANT: You add these roles to grant you user the required permissions to access the Integration Flow Designer and model an integration flow. For additional information on roles in SAP Cloud Platform Integration, check out the official documentation on Available Roles and Authorization Groups.

Which of the following roles did you add to your role collection? AuthGroup_Administrator AuthGroup_ReadOnly AuthGroup_BusinessExpert AuthGroup_IntegrationDeveloper AuthGroup_TenantPartnerDirectoryConfigurator

Step 3: Configure trust

IMPORTANT: This newly defined role collection will be used to group all role templates predefined by SAP that you like to assign.

Select your subaccount name to navigate to your subaccount level. Select Security > Trust Configuration.
Select the default identity provider, SAP ID Service.
In the E-Mail Address field, enter your email ID and select Show Assignments. Since your user is not a part of the SAP ID Service, you get a prompt asking for the user to be added to SAP ID Service. Choose Add User.
Select Assign Role Collection. In the Assign Role Collection prompt, choose Tenant_Administrator from the dropdown list and select Assign Role Collection.

These roles are required for you to create and model your integration flow.

Done

Log on to answer question

Step 4: Provision SAP Cloud Platform Integration tenant

Launch SAP Cloud Platform Integration provisioning application by choosing <subaccount-name> > Subscriptions.
Click Go to Application in the Process Integration tile.
Login to the provisioning application by providing the same email ID and password that you used for creating the trial account. Choose Log On.
Choose Provision to provision a SAP Cloud Platform Integration tenant.
You see a tenant URL after the provisioning is complete. This is the URL for your SAP Cloud Platform Integration tenant.

IMPORTANT: Please wait for the provisioning process to complete before you proceed to the next step. This can take several minutes.
The service instance and key creation will only work after your tenant has been provisioned.

Click on the URL to launch the SAP Cloud Platform Integration application. You can now create integration packages and integration flows.

Bookmark or save this URL. This will be the URL for your SAP Cloud Platform Integration application.

Done

Log on to answer question

Step 5: Create service instance and key

View Full Instructions

Details:

In the previous steps, you configured the security settings for human users dealing with SAP Cloud Platform Integration (by assigning role collections for persona such like integration developer and administrator, for example). In other words, you have defined the required permissions for people working with SAP Cloud Platform Integration using the Web UI when creating or testing integration flows.

With the following Step 5, you enable a remote technical system to call SAP Cloud Platform Integration and to process integration flows deployed on the tenant. The responsible service to process integration flows is the Process Integration Runtime, and in order to enable remote systems to call the Process Integration Runtime, you need to define a service instance and a service key.

You can consider a service instance as a technical user associated with the request of the remote system. To be more precise, a service instance is an OAuth client that represents the remote system calling SAP Cloud Platform Integration.
A service key contains the credentials for the service instance that are required to enable the remote system to communicate with SAP Cloud Platform Integration. With the following step, you generate credentials to authorize the remote system to call SAP Cloud Platform Integration with the basic authentication option. Authentication using client certificates is not possible with the trial tenant.

Navigate back to your SAP Cloud Platform’s subaccount and access your subaccount’s space by choosing Spaces > dev. If you have intentionally specified any other space name, you can choose the space of your choice.
Choose Services > Service Marketplace > Process Integration Runtime.

TIP: If you do not see the Process Integration Runtime service in the list, at the subaccount level, choose Entitlements > Configure Entitlements > Add Service Plans. Choose Process Integration Runtime and select the integration-flow service plan checkbox and choose Add 1 Service Plan.
Select Instances > New Instance.
Choose Next to select the default service plan. In the Specify Parameters tab, enter:
```
{
 "roles":[
   "ESBMessaging.send"
 ]
}
```
Service plan integration-flow is the only option which is preset because processing integration flows is what a remote system is doing when calling SAP Cloud Platform Integration.
Choose Next until you have to specify the instance name. Provide any name of your choice and choose Finish.
Select the newly created service instance.

You create this service instance to enable inbound HTTP calls to your SAP Cloud Platform Integration tenant.
Choose Create Service Key to create a new service key.

This service key will provide you the credentials for making inbound HTTP calls to integration flows deployed on your SAP Cloud Platform Integration tenant.
Specify a name for the service key and choose Save.
Copy the values of clientid and clientsecret parameters. These are the credentials that you use to make a request to your integration flow after you deploy it.

Make a note of these credentials. You will use it when you make HTTP calls to integration flows deployed on your tenant with HTTP endpoints.