--- parser: v2 auto_validation: true primary_tag: topic>abap-development tags: [ tutorial>beginner, topic>abap-development, topic>abap-extensibility ] time: 15 author_name: Raz Korn author_profile: https://github.com/raz-korn slug: abap-custom-ui-communication-systems canonical_url: https://developers.sap.com/tutorials/abap-custom-ui-communication-systems --- # Define SAP Web IDE as Communication Partner in S/4HANA Cloud Create an inbound communication system and user for SAP Web IDE to call into S/4HANA Cloud system via OAuth ## Prerequisites - **Authorizations:** Your user needs a business role with business catalog **Communication Management** (ID: `SAP_CORE_BC_COM`) in **S/4HANA Cloud** ## You will learn - How to create a communication system and user in S/4HANA Cloud for SAP Web IDE - How to enable this communication system for OAuth ## Intro This tutorial focuses on creating an OAuth communication system. To create such an OAuth communication system, you have to create an inbound user, give your Web IDE's URL as host name, create and upload the SAP Cloud Platform Subaccount's certificate so that the S/4HANA system trusts that. ## Additional Information - **SAP S/4HANA Cloud Release** (tutorial's last update): 1902 --- ### Open communication system application Navigate to **Communication Systems** tile to start the application. ![Open communication system application](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-custom-ui-communication-systems/s4_communicationSystems_tile.png) ### Create communication system Create a new communication system by clicking **New**. ![Create communication system](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-custom-ui-communication-systems/s4_communicationSystem_newButton.png) ### Add system ID and system name By adding a system ID, system name and clicking **Create**, you are able to register a new communication system. ![Add system ID and system name](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-custom-ui-communication-systems/s4_communicationSystem_createPopUp.png) ### Get SAP Web IDE URL Switch to your SAP Cloud Platform cockpit, go to **Services** and select **SAP Web IDE**. Copy the link address of **Go to Service**, paste it to some text editor and remove `https://` from that SAP Web IDE's URL. This will be needed in the creation process of the communication system. ![Get SAP Web IDE URL](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-custom-ui-communication-systems/sapcp_WebIDE_getServiceLink.png) ### Set SAP Web IDE URL as host name Switch back to the communication system maintenance in SAP S/4HANA Cloud system. Set SAP Web IDE's URL without `https://` that you got before as Host Name of the communication system. ![Set SAP Web IDE URL as host name](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-custom-ui-communication-systems/s4_communicationSystem_hostname.png) ### Add inbound communication user to system Click **`+`** to add a user for inbound communication. Inbound communication means that the here defined system is used from a communication partner to call from external into the S/4HANA system. Doing this, the user that will be added next has to be used to get authorized. ![Add inbound communication user to system](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-custom-ui-communication-systems/s4_communicationSystem_addInboundUserButton.png) ### Create communication user Click **New User** to create one. ![Create communication user](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-custom-ui-communication-systems/s4_addUserPopUp_newButton.png) ### Add user data and password Enter a **user name** and **description** for your user. Give your user a password and click **Create**. ![Add user data and password](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-custom-ui-communication-systems/s4_userCreate.png) ### Confirm user to add The new user will be taken as inbound communication user by clicking **OK**. ![Confirm user to add](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-custom-ui-communication-systems/s4_addUserPopUp_okButton.png) ### Get SAP Cloud Platform subaccount's signing certificate Switch to your SAP Cloud Platform subaccount. Open trust settings, copy all data from the Signing Certificate field ( in windows: click inside and press `CTRL+a`) and paste it to some text editor. ![Get SAP Cloud Platform subaccount's signing certificate](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-custom-ui-communication-systems/sapcp_getSigningCertificate.png) ### Create certificate file 1. In the text editor file that you pasted SAP Cloud Platform subaccount's signing certificate into before, add a line with value "`-----BEGIN CERTIFICATE-----`" in front of the `` and a line with value "`-----END CERTIFICATE-----`" after. ```swift -----BEGIN CERTIFICATE----- -----END CERTIFICATE----- ``` 2. Save your changes as `.cer` file. ### Upload signing certificate to communication system Go back to your SAP S/4HANA Cloud system and open your created communication system draft. **Edit** your draft and enable it for `OAuth 2.0` by checking the **Enabled** box. Then upload the certificate by clicking **Upload Signing Certificate**. Take the value of the `CN` attribute of the Signing certificate subject - that appears after upload - and enter it as the **Provider Name**. Click **Save**. ![Upload signing certificate to communication system](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-custom-ui-communication-systems/s4_communicationSystem_enableOAuth.png) With this step, you've uploaded your certificate to your communication system. Now your S/4HANA system trusts your SAP Cloud Platform subaccount. ### Test yourself