Background
Did you know S/4Hana Cloud has a chat-bot functionality? Did you know it used to be called SAP Co-Pilot. Recently, SAP changed this from SAP Co-pilot to SAP BTP Collaboration Manager. SAP S/4Hana Cloud provides a native free license for SAP BTP Collaboration Manager. This post shows the steps to set up the native Integration between SAP BTP Collaboration Manager and S/4Hana Cloud.
Summary of Steps to be performed
- Create a Subaccount and Subscribe to SAP Collaboration Manager
- Establish Trust for SAP IAS on SAP BTP
- Establish Trust for SAP BTP on SAP IAS
- Create Communication System / Arrangement in S/4Hana Cloud
- Create Destination on SAP BTP for S/4HanaCloud
- Configure Trusted Sites on S/4Hana Cloud
- Configure Trusted Domains on SAP BTP
- Set up Role Collection Mapping on BTP as per Default Attribute Configuration on IAS
- Disable SAP Identity Service for Authentication ( Only IAS Allowed)
- Test Your Setup
Create a Subaccount and Subscribe to SAP Collaboration Manager
Create a SubAccount
You can choose to use a existing SubAccount or create a new Subaccount. In this use case, I am setting up a new SubAccount on BTP. At the moment of writing this post, SAP collaboration manager is only supported on these data centers from SAP (EU10, US10, AP10, EU11) – Refer link here for the updated list.
Create the Subaccount as per the below screenshot.
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-43.png)
Assign Entitlements for SAP Collaboration Manager in your Subaccount
Navigate to your subaccount –> Entitlements –> Configure Entitlements –> Add Service Plans. Note: Make sure you Save!
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-44-1024x596.png?v=1694524238)
Subscribe to SAP Collaboration Manager
Navigate to your subaccount –> Services –> Service Marketplace –> Search for SAP Collaboration Manager and create a application for it.
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-45-1024x461.png?v=1694524383)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-46-1024x241.png?v=1694524401)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-47.png)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-48.png)
Assign role collection to your user
Assign the role collection of your SAP Collaboration Manager to your users.
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-49-1024x216.png?v=1694524511)
Establish Trust for SAP IAS on SAP BTP
Get the SAML2.0 Config Metadata from IAS
- Login to your S/4 Hana Cloud IAS Tenant at https://<tenant ID>.accounts.ondemand.com/admin.
- Go to Application & Resources –>Tenant Settings –> Single Sign-On –> SAML 2.0 Configuration –> Download Metadata File
- Save this file as you will need this in the next step on BTP
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-50.png)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-51.png)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-52-1024x66.png?v=1694525227)
Configure BTP Trust Configuration to IAS
- Navigate to your BTP Subaccount –> Security –> Trust Configuration –> New Trust Configuration
- In the Metadata, upload the Metadata.xml from the previous section
- Provide Name as a suitable name and Link text for user logon as Suitable name.
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-55.png)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-56.png)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-57.png)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-58.png)
Establish Trust for SAP BTP on SAP IAS
Get the SAML2.0 Config Metadata from BTP
Navigate to your BTP Subaccount –> Security –> Trust Configuration –> download SAML Metadata. Save this file for use in the next step.
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-59.png)
Configure Trust Configuration on IAS to SAP BTP
- Navigate to your IAS
- Go to Applications & Resources –> Applications
- Click on Create –>
- Provide a display name –> SAP BTP Collaboration Manager
- Type –> SAP BTP Solution
- Protocol –> SAML 2.0
- Navigate to SAML 2.0 Configuration and upload the file from the previous section and save
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-60.png)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-61.png)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-62-1024x229.png?v=1694526247)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-63-1024x235.png?v=1694526261)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-64-1024x224.png?v=1694526305)
Change the Subject Name Identifier to Email. Make sure you save
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-66-1024x268.png?v=1694526417)
Define Default Attribute to allow default role assignment in BTP
- Navigate to Default Attributes
- Click on Add
- Attribute : default_role
- Value: H2H-User
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-67-1024x450.png?v=1694526514)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-68-1024x447.png?v=1694526596)
Create Communication System / Arrangement in S/4Hana Cloud
Get the SAP Collaboration Manager Hostname
- Navigate to your SAP BTP Subaccount.
- Go to Services –> Instances and Subscriptions –> SAP Collaboration Manager
- Note down the hostname of the Collaboration Manager link that opens.
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-70.png)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-71.png)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-72.png)
Get the Trust from SAP BTP Destination
- Navigate to your SAP BTP Subaccount
- Go to Connectivity –> Destinations –> Download Trust
- Save the file for use in your next steps
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-73.png)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-74.png)
Create a Communication System
- Login to your S/4 Hana Cloud Tenant
- Go to App Communication Systems
- Create a Communication System with the below details
- Name : COLLAB_MANAGER ( or anything else)
- Hostname: The Hostname of SAP Collaboration Manager from previous step
- Identity Provider: SAML Bearer Assertion Provider
- Upload Signing Certificate – Upload the Trust file from the BTP Destination from previous section
- SAML Bearer Issuer – Provide the CN value of the Signing Certificate as the SAML Bearer Issuer
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-75.png)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-76-1024x127.png?v=1694527668)
Create a Communication Arrangement
- Login to your S/4Hana Cloud Tenant
- Go to App Communication Arrangement
- Create a Communication Arrangement for Scenario : SAP_COM_0835
- Select Communication System as the Communication System from previous section.
- Note the value of API-URL
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-69.png)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-77-1024x264.png?v=1694527801)
Create Destination on SAP BTP for S/4HanaCloud
- Navigate to your SAP BTP Subaccount.
- Go to Connectivity –> Destinations
- Create a Destination –> New Destination
- Name – Should start with CMGR_
- URL : API Hostname of S/4
- Audience: URL Hostname of S/4
- AuthnContextClassRef : urn:oasis:names:tc:SAML:2.0:ac:classes:PreviousSession
- Additional Property: nameIdFormat: urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-78-1024x319.png?v=1694528807)
Configure Trusted Sites on S/4Hana Cloud
- Navigate to the App : Manage Content Security Policy on S/4Hana Cloud.
- Go to Trusted Sites
- Go to UI_RESOURCE_SCRIPTS
- Add below entries
- https://*.cmanager.eu12.hana.ondemand.com
- URL of your SAP BTP Content Manager from previous section
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-79.png)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-80.png)
Configure Trusted Domains on SAP BTP
- Navigate to SAP BTP Subaccount.
- Go to Security –> Settings
- Go to Trusted Domains and add your S/4Hana Cloud UI endpoint
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-81.png)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-82.png)
Set up Role Collection Mapping on BTP as per Default Attribute Configuration on IAS
We defined a Default Attribute mapping in IAS for the SAP BTP Application we had defined as previous section. This is used as a Role Collection Mapping to ensure all users onboarded to IAS have the default role for using SAP BTP Collaboration Manager.
Navigate to your BTP Subaccount. Go to Security –> Trust Configuration. Click on SAML Identity Provider you created for IAS.
Click on Role Collection Mappings and add a New Role Collection Mapping as per screenshot.
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-91.png)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-92-1024x118.png?v=1694606038)
Disable SAP Identity Service for Authentication ( Only IAS Allowed)
Navigate to your BTP Subaccount. Go to Security –> Trust Configuration. Click on Default Identity Provider ( edit ) and ensure Available for User Login is not selected.
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-84.png)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-85-1024x49.png?v=1694529997)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-86.png)
Testing the Setup
Logout and Login back to your SAP S/4Hana Cloud System. Now you will see a new Icon “chat” called SAP Collaboration Manager. Sign in to SAP Collaboration Manager with your IAS User, and start collaborating with your team members on S/4Hana Cloud.
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-83.png)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-87.png)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-89.png)
![](https://www.sprintegrate.com/wp-content/uploads/2023/09/image-90.png)
Final Thoughts
If I could predict the future, I would say that this is the 1st step in enabling native AI features within S/4Hana Cloud. While SAP Collaboration Manager is the 1st Step towards Human2Human Interactions, with SAP’s roadmap for SAP Digital Assistant, native AI chat should also be available on S/4Hana Cloud very very soon.
How many customers actually user SAP Collaboration Manager for Human2Human interactions is up for debate but considering this is free to use if you are a S/4Hana Cloud customer; take it for a test drive within your organizations is what I would say.