Authentication

There are two authentication options available for this web service—password and certificate.

Password Authentication

Password authentication provides a relatively simple mechanism for authenticating, i.e. username and password. In order to leverage password authentication, a “license key” must be created and will avoid the requirement of password rotation for the user. Refer to the SAP Fieldglass Configuration Manager to create the key. Specifics on where to apply the license key are provided in the Request Types and Data Transfers section.

Certificate Authentication

Certificate-based authentication provides a more secure mechanism for authentication. To leverage certificate authentication, do the following:

Use a required X509 certificate issued by a trusted Certificate Authority (e.g. DigiCert). Contact your SAP Fieldglass representative for more information.
Use the correct URL.

Note

The URL will include “auth” in the sub-domain.
- The URL is in the following format: [Enviornment base URL]/ws2/services/connectorn. Environment base URL should include the protocol. The company code in the environment base URL should have "-auth" appended to it.
  
  Note
  
  Not all test environments are configured. You may need to submit a request to have it configured.

To setup the X509 certificate for use in web service authentication, the following steps should be completed within the SAP Fieldglass application. This will add the public certificate to the application and link it to a user (ensure it is a valid, active user), thus not requiring the credentials to be supplied as part of the web service request, itself.