This section shows how to set up ODBC connectivity and configure DSNs on macOS.

Minimum macOS Version

The CData ODBC Driver for SAP SuccessFactors driver requires macOS Sierra (10.12) or above.

Licensing the Driver

In a terminal, run the following commands to license the driver. To activate a trial, omit the <key> input.

cd "/Applications/CData ODBC Driver for SAP SuccessFactors/bin"
sudo ./install-license.sh <key>

You'll be prompted for a name and password. These refer to your name and your machine's password.

The CData ODBC Driver for SAP SuccessFactors communicates to SAP SuccessFactors over the OData API. By default, it is enabled. However, if you need to provide additional permissions, please follow the steps from SAP laid out in their support here.

Connecting to SAPSuccessFactors

You can authenticate to SAP SuccessFactors using Basic authentication or OAuth with SAML assertion.

Basic

You must provide values for the following properties to successfully authenticate to SAP SuccessFactors. Note that the provider will reuse the session opened by SAP SuccessFactors using cookies. Which means that your credentials will be used only on the first request to open the session. After that, cookies returned from SAP SuccessFactors will be used for authentication.

• AuthScheme, set this to BASIC.
• Url, set this to the url of the server hosting Success Factors. Some of the servers are listed here.
• User, set this to the username of your account.
• Password, set this to the password of your account.
• CompanyId, set this to the unique identifier of your company.

Once OData is enabled, you must grant access to the API to activate Basic Auth for a given user.

Granting Permission for an RBP System

• Assign the permission in Administrator Permissions > Manage Integration Tools > Allow Admin to Access OData API through Basic Authentication.

Granting Permission for a User-based System

• Click Administrative Privileges > Integration Tools, and select Allow Admin to Access OData API through Basic Authentication.
• On the Managing Administrative Privilege page, select the Employee Export and Employee Import checkboxes to grant those permissions to the given user.

OAuth

See Using OAuth Authentication for an authentication guide for OAuth2.

Uninstalling the Driver

The easiest way to uninstall the driver is to open a terminal and run the included uninstall.sh script, located in the installation directory. For example:

cd "/Applications/CData ODBC Driver for SAP SuccessFactors"
sudo ./uninstall.sh

Note: The script needs to be run from the installation directory.