Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

API URL: e.g. https://apisalesdemo8.successfactors.com - see this for more info on identifying your URL - SAP SuccessFactors URLs

OnLink supports both Basic and OAuth authentication mechanismmechanisms to connect to SuccessFactors.

...

Basic Auth:

  • API Username: format is username@company_id, provide user access via: Admin Center >>  Manage Permission Roles >> Manage Integration Tools >> Enable Allow Admin to Access OData API through Basic Authentication. OnLink requires access to these entities: User, UserAccount, EmpJob, EmpEmployment, EmpEmploymentTermination, PerPerson, PerEmail. See this link for instructions on finding your Company ID.

  • API Password: <api user’s password>

OAuth:

  • Public and Private Keys - Create key pair using openssl command described here - create certificate. Copy the public and private keys from this step. $ openssl req -nodes -x509 -sha256 -newkey rsa:2048 -keyout private.pem -out public.pem

  • Client ID - Register OAuth2 client application - register application. Copy the API Key.

  • Company ID - see this link for instructions on finding your Company ID.

  • User ID - user id of a technical user who has the right permissions to access OData API

Mock credentials for your testing:

...

URL - https://3c3343b1-1498-4a6a-b63d-71aacb64c046.mock.pstmn.io

...

Username - sapuser@onwardb

...

To confirm your OAuth credentials are valid, you can use this blog to test with a third party tool.

SuccessFactors Webhook

SAP SuccessFactors comes with Intelligent Services events that provides capabilities for HTTP-based events. As a result, a number of HR events in SAP SuccessFactors can be pushed to target systems. OnLink leverages this functionality to receive event notifications and help automate various use cases such as Employee Hire, Employee Termination, Employee Changes, etc.

Here’s the official documentation on this approach: https://community.sap.com/t5/technology-blogs-by-sap/sap-integration-suite-advanced-event-mesh-using-sap-successfactors/ba-p/13558143

Before you begin

Follow instructions in our Webhook documentation to create a new Webhook for Success Factors. Select Basic Authentication and enter username and password (called Secret for Success Factors).

Step by step procedure to configure Webhook in Success Factors

  1. In SuccessFactors, we need to set up an Intelligent Services New Hire Event to push data into OnLink. When you add a new employee, the Intelligent Services event will trigger and data will be pushed to OnLink.

  2. Login to SuccessFactors as an admin user. Search for and select ‘Integration Center’ in the search box at the top right of the page.

...