Skip to main content

# SAP Cloud Integration

## Prerequisites​

To configure the cloud service, the following prerequisites must be done in SAP BTP by an administrator.

1. If one does not exist already, create a service instance in the chosen subaccount of type Process Integration Runtime with plan `api`. Ensure that the correct roles are assigned:
   1. for the Neo environment:
      - IntegrationOperationServer.read
      - NodeManager.read
      - NodeManager.readsecuritycontent
      - ESBDataStore.read
   2. for Cloud Foundry:
      - DataStoresAndQueuesRead
      - MonitoringDataRead
      - SecurityMaterialDownload
2. An OAuth authentication service is required to be configured and activated. This is done following the SAP documentation: Authentication and depends on whether you use the Neo or Cloud Foundry environments.

It is recommended to use the OAuth Client Credentials Grant option. The created service key will have the details required for calling the OAuth service and the API.

## Create SAP Cloud Integration cloud service in Avantra​

1. Navigate to System > Cloud Services.
2. Click New.
3. Select the Service Type - **SAP Cloud Integration (SCI)*.
4. Define a Service.
5. Select a Customer.
6. Select a System Role.
7. Click New.
8. Double-click the newly created service to open its Properties panel, where you can set up a connection to the SCI.
9. Define a URL with the tenant management node URL to allow Avantra to communicate with the SAP Cloud Integration.
10. In the Credentials tab, check the OAuth Credentials and click Edit.
11. Define a Name.
12. Define a Client ID
13. Define a Client Secret.
14. Define an Access Token URL.
15. Click OK.
16. Click Apply to save the credentials.
17. Activate the monitoring via the Monitoring switch and allow time for the check cycles to run, and the checks will be displayed.

The four checks are implemented automatically once the service has been saved. These checks are:

- CPI_MessageLogs: View details of all failed messages over a period of time where the statuses are ESCALATED or FAILED.
- CPI_KeystoreExpiration: View any certificates that are due to expire within the next 120 days.
- CPI_JMSMessageQueues: This check displays the SCI JMS message queues so their status can be monitored in Avantra. Only activate this check if you have JMS Message Queues active.
- CPI_CertificateUserMappingExpiration (only for SAP Neo): View any certificates that are due to expire within the next 120 days.