SAP SuccessFactors Sources > Before you begin > Create a connection
  

Create a connection

Create an SAP SuccessFactors connection object in Administrator with the connection details of the SAP SuccessFactors source system.
To use an external secrets manager to connect to the source system, use one of the following authentication tools:
    1In Administrator, select Connections.
    2Click Add Connection.
    3Enter the following connection details:
    Property
    Description
    Connection Name
    Name of the connection.
    Each connection name must be unique within the organization. Connection names can contain alphanumeric characters, spaces, and the following special characters: _ . + -,
    Maximum length is 255 characters.
    Description
    Description of the connection. Maximum length is 4000 characters.
    Use Secret Vault
    Stores sensitive credentials for this connection in the secrets manager that is configured for your organization.
    This property appears only if secrets manager is set up for your organization.
    When you enable the secret vault in the connection, you can select which credentials that the Secure Agent retrieves from the secrets manager. If you don't enable this option, the credentials are stored in the repository or on a local Secure Agent, depending on how your organization is configured.
    Note:
    If you’re using this connection to apply data access policies through pushdown or proxy services, you cannot use the Secret Vault configuration option.
    For information about how to configure and use a secrets manager, see Secrets manager configuration.
    Runtime Environment
    The name of the runtime environment where you want to run tasks.
    User name
    The user name to access the SuccessFactors ODATA account.
    The user name uses a combination of company ID and user name of your SucessFactors OData account in the following format:
    User name@Company ID
    Password
    Password to access the SuccessFactors ODATA account.
    URL
    SuccessFactors service root URL. For example, enter https://apisalesdemo8.successfactors.com/odata/v2
    For more information, see the SAP SuccessFactors documentation.
    The following table describes the advanced connection properties:
    Property
    Description
    Security Type
    Security protocol that you can use to establish a secure connection with the SuccessFactors server. Select SSL or TLS.
    TrustStore File Name
    Applies to security type.
    Name of the truststore file that contains the public certificate for the SuccessFactors server.
    TrustStore Password
    Applies to security type.
    Password for the truststore file that contains the public certificate for the SuccessFactors server.
    KeyStore File Name
    Applies to security type.
    Name of the keystore file that contains the private key for the SuccessFactors server.
    KeyStore Password
    Applies to security type.
    Password for the keystore file that contains the private key for the SuccessFactors server.
    Authentication Type
    Method to authenticate access to the SuccessFactors ODATA account
    Select one of the following authentication types:
    • - HTTP Basic Authentication. Requires administrator access to the OData API and credentials for a valid account.
    • - OAuth 2.0. Requires you to register a OAuth 2.0 client application that is authorized to access the OData API and valid OAuth token associated with the client application.
    5Select the authentication type to connect to SAP SuccessFactors and enter the required properties.
    You can use the following authentication types:
    6Click Test to test your connection to the source system.
    7Click Save.

OAuth 2.0 authentication

The following table describes the connection properties for OAuth 2.0 authentication:
Property
Description
User name
The user name to access the SuccessFactors ODATA account.
The user name uses a combination of company ID and user name of your SucessFactors OData account in the following format:
User name@Company ID
API KEY
Enter the API key that the OAuth Utility returns when you register your OAuth 2.0 client application. For more information about how to get the API key,, see the SuccessFactors documentation.
PRIVATE KEY
Enter the private key that the OAuth Utility returns when you generate the X.509 certificate. For more information about how to get the private key, see the SuccessFactors documentation.
COMPANY ID
If you select OAuth 2.0 authentication, enter the company ID that SuccessFactors returns when you create an account in SuccessFactors.