Skip to Content

Summary

This blog describes the steps necessary to configure user-propagation (a.k.a. Single-Sign-On or SSO) between an extension app running on SAP Cloud Platform (SCP) and SAP Hybris Cloud for Customer (C4C) based on the User ID of the user logged in to SCP. (Soon, I will write another blog to show the configuration based on the email address of the user logged in to SCP)

SAP Hybris Cloud for Customer supports OAuth 2.0 SAML Bearer Assertion Flow.

For more up-to-date information on this topic, please refer to this online help page.

Prerequisites

  • The OAuth 2.0 based authentication between SCP and C4C requires the same user-id to exist in both SAP Cloud Platform and SAP Hybris Cloud for Customer.
  • In C4C:
    • An OAuth Identity Provider is configured.
    • An OAuth client is registered to be used by the destination created in SCP.
  • In SCP:
    • A destination pointing to the OAuth client registered in C4C.
    • The App uses the destination created in the previous step.

Configuring SAP Hybris Cloud for Customer

Capturing the required information from SAP Cloud Platform

In order to configure the OAuth Identity Provider in C4C, you will need some information from the respective SCP tenant. Hence, in a separate browser window, go to SAP Cloud Platform Cockpit and open Trust under Security.

Then follow the steps below:

  1. Temporarily change the Configuration Type to “Custom”.
  2. Copy “Local Provider Name” to provide as the value for “Issuing Entity Name” while configuring the OAuth 2.0 Identity Provider in C4C.
  3. Copy the text under “Signing Certificate” and save it as a .cer certificate file.

The Certificate file mentioned above should have the following format:

-----BEGIN CERTIFICATE-----
<The text copied from the Signing Certificate box in Trust Management screen in SCP>
-----END CERTIFICATE-----

Make sure to click on Cancel to discard any changes you might have made in the “Trust Management” screen.

Creating an OAuth Identity Provider

Open Configure OAuth 2.0 Identity Provider under ADMINISTRATOR à COMMON TASKS and click on New OAuth 2.0 Provider.

Then follow the steps below:

  1. Set “Issuing Entity Name” to the value of “Local Provider Name” copied from Trust Management screen in SCP Cockpit.
  2. Set the .cer certificate file created in the previous topic, to “Primary Signing Certificate”.
  3. Marking Email Address in the above screen has no effect. Hence, leave it as is.

 

After successful configuration, OAuth 2.0 Identity Provider should be listed as active.

Registering an OAuth 2.0 Client

 

Open OAUTH2.0 CLIENT REGISTRATION tab under ADMINISTRATOR and click on New.

Then follow the steps below:

  1. Client ID is automatically generated.
  2. Enter a value under Client Secret.
  3. Provide a suitable description for your client registration.
  4. Choose the previously defined OAuth 2.0 Identity provider, as the Issuer Name.
  5. By default, OAuth token will be valid for 3600 seconds (i.e. 1 hour). Feel free to change this value, if you need.
  6. Under scope, select the desired value(s). UWC:CC_HOME should work for most.

Configuring SAP Cloud Platform

Capturing the required information from SAP Hybris Cloud for Customer

In C4C, go to ADMINISTRATOR à COMMON TASKS à Configure Single Sign-On. The value under Local Service Provider should be assigned to Audience in the respective SCP destination.

Defining an OAuth 2.0 destination in SAP Cloud Platform

In SAP Cloud Platform, destinations are the ports that allow access to external systems based on various options. Extension apps then refer to these destinations to connect to their desired external systems.

In order to create a new OAuth 2.0 destination pointing to your C4C tenant, in SAP Cloud Platform Cockpit, under Connectivity, choose Destinations. Then, Click on “New Destination”

Following table describes the parameters required for configuring an OAuth 2.0 destination in SCP.

Parameter Value
Name A descriptive name uniquely identifying the newly created destination
Type HTTP
URL

OData Service URL

e.g. https://my315537.crm.ondemand.com/sap/c4c/odata/v1/c4codata

Proxy Type Internet
Authentication OAuth2SAMLBearerAssertion
Audience “Local Service Provider” from C4C SSO Configuration screen
Client Key Generated “Client ID” of the registered OAuth 2.0 Client in C4C
Token Service URL https://my<tenantID>.crm.ondemand.com/sap/bc/sec/oauth2/token
Token Service User Generated “Client ID” of the registered OAuth 2.0 Client in C4C
Token Service Password “Client Secret” of the registered OAuth 2.0 Client in C4C

 

Additional Parameter Value
authnContextClassRef urn:none
nameIdFormat urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
scope Required scope in C4C. E.g. UIWC:CC_HOME

 

Here is an example for a destination definition named “OAuth2” with standard and additional parameters:

Please note that modifications to an existing destination will take several minutes to take effect. In order to avoid possible issues, you may want to stop your app and restart it before testing your changes in the destination.

As there are several steps, it is rather easy to make mistakes while configuring the OAuth between SCP and C4C. Hence, please take your time in following the steps above.

Best,
-Mustafa.

To report this post you need to login first.

6 Comments

You must be Logged on to comment or reply to a post.

  1. Anders Brødsgaard

    Hi Mustafa.

    Great document – with a lot of valuable information.

    You are using SCP as the platform for your extension app – but do you know if the same can be achieved when using Azure as the platform. We are using Azure as IdentityProvider for both the extension app and for C4C (set up as SSO IDP).

    What I would like is when my users are authenticated to the extension app, then the app should be able to extract data via oData from C4C with the user’s credentials without the user having to sign in to C4C.

    The extension app is developed in .net, and used from a browser (IE/Chrome).

    Will this be possible?

     

    Best regards

    Anders Brødsgaard/Vestas Wind Systems

     

    (0) 
    1. Mustafa Saglam Post author

      Hi Anders,

      OAuth 2.0 being an industry standard, I don’t see any issue from the C4C side to support your Azure based app. Essentially, when your non-SAP IdP is defined as an OAuth IdP in C4C, and the associated users exist on both systems (C4C and Azure), it should work – assuming that Azure supports OAuth 2.0 SAML Bearer flow.

      Regards,
      Mustafa.

      (0) 
      1. Anders Brødsgaard

        Hi Mustafa,

        Thanks for the reply!

        I need to check up on the Azure capabilities, but according to their documentation “Azure AD supports the OAuth 2.0 and OpenID Connect standards that make extensive use of bearer tokens, including bearer tokens represented as JWTs.”

        I’m not sure how if a JWT token differs from flow SAP is using?

        https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-authentication-scenarios

        Regards,

        Anders

         

        (0) 
        1. Mustafa Saglam Post author

          Hi Anders,

          JWT and SAML bearer flow are not the same. Please note that if Azure doesn’t provide built-in support for OAuth 2.0 SAML Bearer flow, you can always implement it within your application.

          Please refer to the sample app on C4C OData API Developer’s guide – https://github.com/SAP/C4CODATAAPIDEVGUIDE/tree/master/OAuthSAMLClient. Possibly, you can also find a .net example on the Internet.

          Regards,
          Mustafa.

           

           

          (0) 

Leave a Reply