User Authentication Structure

All API methods use the 'user' structure as authentication to determine the permissions of the Oracle Field Service client company user.

All customers can use the Client_ID and Client_Secret instead of login and password to populate the User Authentication Structure with credentials:
  1. Register an application.

    1. In the Field Service Manage interface, click Configuration and select Applications.

    2. In the left pane, click the plus icon to open the New application window, specify the Application Name and Application ID, and click Submit.

    3. Under Authentication settings, select the Authenticate using Client ID/Client Secret check box.

    4. Click Save.

  2. Select the application and under Authentication settings section, click Show Client ID / Client secret to view the Client ID and Client Secret.

  3. Make a note of the Client ID and Client Secret.

The following table describes the Oracle Field Service SOAP authentication structure mandatory fields.

Authentication Structure Fields

Name Type Description

now

string

current time in ISO 8601 format

company

string

case-insensitive identifier of the Client for which data is to be retrieved. provided by Oracle during integration.

login

string

The client ID of the application.

auth_string

string

authentication hash; The value of this field must be computed as follows:

auth_string = SHA256(now + SHA256(CLIENT_SECRET+SHA256(CLIENT_ID)));

For example:

<user>

<now>CURRENT_TIME</now>

<login>CLIENT_ID</login>

<company>ENVIRONMENT_NAME</company>

<auth_string>SHA256(CURRENT_TIME + SHA256(CLIENT_SECRET + SHA256(CLIENT_ID)))</auth_string>

</user>