Skip to Content

Set Up Trust Between Identity Authentication and SAP Business Technology Platform Neo Environment

Requires Customer/Partner License
Set up trust between SAP Cloud Identity Services - Identity Authentication and SAP Business Technology Platform for secure communication via SAML 2.0.
You will learn
  • How to set up SAP Business Technology Platform Subaccount for secure communication (with Security Assertion Markup Language = SAML 2.0)
  • How to set up SAP Business Technology Platform Subaccount on SAP Cloud Identity Services - Identity Authentication for secure communication
  • How to get necessary information from your SAP Business Technology Platform Subaccount and your SAP Cloud Identity Services - Identity Authentication tenant to set up the mutual trust between them
raz-kornRaz KornNovember 27, 2024
Created by
mervey45
March 21, 2023
Contributors
mervey45
Liebherr

Prerequisites

Authorizations: Your user needs
- Administrator access to your SAP Business Technology Platform (aka SAP BTP) Neo subaccount
- Administrator access to your SAP Cloud Identity Services tenant

Glossary

Identity: individual people, but also computers, services, computational entities like processes and threads, or any group of such things

Identity Provider: system entity that creates, maintains, and manages identity information for identities

Identity Authentication: process of authenticating an identity

SAP Cloud Identity Services: SAP’s solution to enable identity authentication

SAP Cloud Identity Services tenant: a customer’s instance of the services

SAP Cloud Identity Services console: Web application to configure your tenant

Be aware that in case of an integration with SAP S/4HANA Cloud the used Identity Authentication for the SAP BTP subaccount should be the very same as the one used for the SAP S/4HANA Cloud system.

Your SAP S/4HANA Cloud system you got already delivered by SAP with a configured trust between it and your SAP Cloud Identity Services tenant. Now you will configure the trust between that and your SAP BTP subaccount on your own.

SAP S/4HANA Cloud and SAP BTP subaccount share same Identity Provider

Additional Information

  • Step 1

    Enter the SAP Business Technology Platform subaccount as an administrator and expand the Security area to open Trust Management by clicking the Trust section.

    Enter SAP Business Technology Platform Subaccount
  • Step 2

    To enable secure (Security Assertion Markup Language = SAML 2.0) communication the SAP Business Technology Platform Subaccount has to be set up as Service Provider.

    Being in the trust management, click Edit to change the default Local Service Provider.

    Edit local service provider

    Change and add following information to your local provider:

    Configuration Type Custom
    Local Provider Name <platform region s URL>/<subaccount name> (set automatically)
    Principal Propagation Enabled
    Force Authentication Disabled

    Click Generate Key Pair

    Generate Key Pair for and save Local Service Provider

    Save your changes.

    Confirm the “Now you can proceed to configuring the trusted identity provider settings on the next tab.” pop up.

  • Step 3

    To set up the trust from Identity Authentication to the Subaccount soon you need the subaccount’s metadata.
    Download the metadata by clicking Get Metadata.

    Get metadata of subaccount
  • Step 4

    Open the SAP Cloud Identity Services - Identity Authentication Administration Console with its URL which follows the pattern:

    https://<YOUR_TENANTS_ID>.accounts.ondemand.com/admin

    Tenant ID is an automatically generated ID by the system. The first administrator created for the tenant receives an activation e-mail with a URL in it. This URL contains the tenant ID.

    SAP Cloud Identity Services - Identity Authentication Administration Console entry screen looks (depending on authorizations) like that

    Enter SAP Cloud Identity Services administration console
  • Step 5

    The SAP BTP subaccount is represented in SAP Cloud Identity Services as Application.

    Choose Applications & Resources (1) and go to Applications (2). Click Create (3) on the left hand panel and enter a Display Name (4) to represent your SAP BTP subaccount. Create (5) the application.

    Add SAP BTP subaccount as application
  • Step 6
    1. The newly created application will be shown, choose SAML 2.0 Configuration.

      Configure application’ s SAML 2.0 trust with SAP BTP subaccount
    2. Browse (1) for the SAML metadata XML file of your SAP BTP subaccount that you downloaded before and upload it.

      Upload SAP BTP subaccount’ s metadata

      All the needed properties will be automatically fetched from the XML file.

    3. Save (2) the SAML 2.0 configuration.

  • Step 7

    Now you have to configure which attribute is used to identify users during SAML2.0 secure communication. By default this is User ID, but as SAP S/4HANA Cloud by default works with Login Name it shall be switched to that.

    1. Still being in your application’s Trust settings select Subject Name Identifier.

      Open Subject Name Identifier configuration
    2. Under Primary Attribute use Identity Directory as Source, choose Login Name as Value and save your changes.

      Set Login Name as application’ s Subject Name Identifier
  • Step 8

    As most common use case the SAP Cloud Identity Services - Identity Authentication does not act as Identity Provider itself but as proxy for an already existing corporate identity provider. This has to be set now.

    Still being in your application’s Trust settings scroll down and open Conditional Authentication.

    Open application’ s identity provider configuration

    Under Default Authenticating Identity Provider select your corporate identity provider as Default Identity Provider and click Save.

    Set identity provider

    Save that XML to a file.

  • Step 9

    To set the SAP Cloud Identity Services tenant as trusted identity provider in the SAP BTP subaccount next, you need to get its SAML metadata first.

    Open SAP Cloud Identity Services tenant’s settings - SAML 2.0 configuration
    1. Choose Applications & Resources

    2. Switch to Tenant Settings

    3. Go to Single Sign-On section

    4. Open SAML 2.0 Configuration

    5. Click the Download Metadata file button

      Button to start download of SAML 2.0 Metadata
    6. In the pop-up that opens, use Default certificate and press the Download button.

      Pop-up to download SAML 2.0 Metadata

    Alternatively you can open the metadata XML by entering your tenant’s web address for it which follows pattern https://<YOUR_TENANTS_ID>.accounts.ondemand.com/saml2/metadata and saving that XML to a file.

  • Step 10

    Switch back to your SAP BTP cockpit and the Neo subaccount’s trust management.

    Choose Application Identity Provider to add a trusted identity provider.

    Add subaccount’ s trusted identity provider

    Upload metadata XML file of your SAP Cloud Identity Services tenant in the Metadata File field. Add it as identity provider.

    Upload identity tenant’ s metadata as trusted identity provider
  • Step 11

    What are synonyms for your SAP BTP Neo Subaccount in the context of trust configuration?

Back to top