Configure SuccessFactors OData Settings

Strato gets your data from SuccessFactors through the Open Data Protocol (OData). Admins can configure the details and credentials needed for Strato to connect with SuccessFactors in the Strato Admin Tool.

This article serves as a guide on how to configure your Admin Tool's SuccessFactors OData Settings.

Requirements

Access to both the Strato Admin Tool and SuccessFactors Admin Center is required to perform these steps.

Contact your SF administrator if you need help accessing your SF Admin Center, and your Regional Consultants if you need help accessing your Strato Admin Tool.

You must also have an existing Strato system ready. Learn more about New System Creation.

Instructions

In SuccessFactors

First, set up your SuccessFactors to connect to your Strato system:

1. Login to your SuccessFactors instance.
2. In the top navigation bar, click Home, then Admin Center.
3. 
   
4. 
   
   
5. In the search bar of the Tools section, type Manage OAuth2 Client Applications and select it.
6. 
   
7. 
   
   
8. Click Register Client Application. This action will take you to a page where you can input details from your Strato system.
9. 
   
10. 
11. 
    

12. Enter the following details:

    • Application Name: Strato (or any appropriate name for easy identification)

    • Application URL: Your Strato system's URL (for example, demo.test.stratohcm.com)

13. Your system URL can be found under General Settings of the Strato Admin Tool.

14. 
    

15. 

    
    

16. Click Generate X.509 Certificate. This action will take you to another page where you can input details for the certificate you will be using in later steps.
17. 
    
18. 
19. 
    
20. 
21. 
    

22. Enter the following details:

    • Common Name: Strato
    • Validity (Days): 36499
    • 
      
      💡

      Strato has native Single Sign-On integration with SuccessFactors, and the API key used to connect to Strato is only valid for one year. To make sure that SSO with SuccessFactors works for more than a year, input 36499 (approximately 100 years) in the Validity (Days) field.

23. 

    
    

    
    

24. Click Generate. This will create the certificate.
25. Get the certificate by downloading the PEM file.
26. 
    
27. 
28. 
    
29. Once you have your certificate, click Register. This will redirect you back to the Client Applications list.
30. Click View on the client application you just created, and copy the API Key. The API Key will only be generated after registering, and you will be using this in later steps.
31. 
    
32. 

In Strato Admin Tool

After setting up SuccessFactors, you will need to connect your Strato system to your SuccessFactors instance.

1. Login to your Strato Admin Tool.
2. 
   
3. 
   
   
4. Click the company where your system can be found. Click the edit button beside your system.
5. 
   
6. 
   
   
7. Go to the SuccessFactors OData Settings section and enter the following details:
8. 
   
   
   
   
   • URL for OData calls: Formatted as <SF API endpoint URL> + /odata/v2
   • SuccessFactors Company ID
   • Identification Type: Basic or Bearer
   • Depending on the selected Identification Type, different fields are available:
     • Basic
       • Username and Password of the user who can access your SuccessFactors OData
     • Bearer (Recommended)
       • Username
       • Token Service URL: Formatted as <SF API endpoint URL> + /oauth/token
       • Identity Provider (IdP) URL: Formatted as <SF API endpoint URL> + /oauth/idp
       • API Key: Paste the API Key that was previously generated.
       • Certificate: Click the Input Certificate button to show the field and upload the PEM file that you had previously downloaded.
         
         
9. Hover over the lower right action button, and click Save.
10. 
    
11. 
12. 
    

SuccessFactors Endpoint URLs

Your endpoint URL for accessing the OData APIs depends on the data center which hosts your SuccessFactors instance. You can find your endpoint URL from the official SAP SuccessFactors documentation.