Prerequisites for Creating a Connection

You must satisfy the following prerequisite to create a connection with the SAP S/4HANA Cloud Adapter.

Prerequisites to Use the Basic Authentication Security Policy

You must satisfy the following prerequisites if you want to use the Basic Authentication security policy with the SAP S/4HANA Cloud Adapter.

Create a Communication User

  1. Log in to the SAP S/4HANA Cloud application with administrator credentials.
  2. Search for Communication Management in the search box in the upper right pane, then click Maintain Communication Users in the search results.
  3. Click New to create a new communication user.
  4. On the Create Communication User page, enter a user name, description, and password. You can click Propose Password to get a system-generated password.
    The General section shows the User Data subsection, which includes fields for User Name and Description. Below this is the Password subsection, which includes a Password field and two buttons: Propose Password and Deactivate Password. The Create and Cancel buttons are in the lower right corner.

  5. Copy the user name and password for your communication user.

    You'll need to enter those values on the Connections page when you configure security for your SAP S/4HANA Cloud Adapter connection in Oracle Integration. See Configure Connection Security.

  6. Click Create.

Create a Communication System

Perform the following steps to create a communication system and assign a communication user to the communication system.

  1. Log in to the SAP S/4HANA Cloud application with administrator credentials.
  2. Search for Communication Management in the search box in the upper right pane, then click Communication Systems in the search results.
  3. Click New to create a new communication system.
  4. Enter a system ID and system name, then click Create.
    The New Communication System dialog shows the System ID and System Name fields. In the lower right are the Create and Cancel buttons.

  5. Click a communication system in the list.
  6. Under Technical Data, enter the host name of your SAP S/4HANA Cloud tenant in the following format. 
    myxxxxxx.s4hana.ondemand.com
  7. Click the User for Inbound Communication tab, then click the add (+) icon.
  8. Assign the communication user you created and select the authentication method as User Name and Password.
  9. Click Save.

Create a Communication Arrangement

  1. Log in to the SAP S/4HANA Cloud application with administrator credentials.
  2. Search for Communication Management in the search box in the upper right pane, then click Communication Arrangements in the search results.
  3. Click New to create a new communication arrangement.
  4. Select your communication scenario, enter an arrangement name, and click Create.
  5. Click a communication arrangement in the list. The inbound communication user is automatically assigned.
  6. Under Inbound Services, the service URL to call the OData service can be found in the following format: 
    https://your-system-api.s4hana.ondemand.com/sap/opu/odata/sap/API-name
  7. Click Save.

Prerequisites to Use the Client Certificate-Based Security Policy

You must satisfy the following prerequisites if you want to use the Client Certificate-based security policy with the SAP S/4HANA Cloud Adapter.

Create a Communication User

  1. Log in to the SAP S/4HANA Cloud application with administrator credentials.
  2. Search for Communication Management in the search box in the upper right pane, then click Maintain Communication Users in the search results.
  3. Click New to create a new communication user.
  4. On the Create Communication User page, enter a user name, description, and password. You can click Propose Password to get a system-generated password.
  5. Upload the certificate (.pem file) on the Certificates page. To create a trusted Certificate Authority (CA)-signed X.509 certificate, see S/4HANA Cloud APIs with Client Certificate Authentication.
  6. Click Create.

Create a Communication System

Perform the following steps to create a communication system and assign a communication user to the communication system.

  1. Log in to the SAP S/4HANA Cloud application with administrator credentials.
  2. Search for Communication Management in the search box in the upper right pane, then click Communication Systems in the search results.
  3. Click New to create a new communication system.
  4. Enter a system ID and system name, then click Create.
  5. Click a communication system in the list.
  6. Under Technical Data, enter localhost in the Host Name field.
  7. In the Logical System field, enter a system name.
  8. Click the User for Inbound Communication tab, then click the add (+) icon.
  9. Assign the communication user you created and select the authentication method as SSL Client Certificate.
  10. Click the User for Outbound Communication tab, then click the add (+) icon.
  11. Select the authentication method as User Name and Password, and enter the user name and password.
  12. Click Create.
  13. Click Save.
  14. Check that the status is Active.

Create a Communication Arrangement

Follow the steps to create a communication agreement. See Create Communication Agreement.

Upload the Client Certificate X.509 Certificate into Oracle Integration

Upload the X.509 client certificate. See Upload a Certificate to Connect with External Services.