Prepare Your Oracle Utilities Environments for Registration

Complete the steps in this section for your Oracle Utilities system.

For additional information that can help you complete these steps, see:

All Utility Environments

Complete these steps to enable Fusion APIs, CXIF Admin clients, and the OAuth client for person sync:

  1. Log in to your CXIF Identity Domain.
  2. Create an OAuth Client to manage Customer Experience for Utilities configurations and to perform administrative functions.
  3. Create an OAuth client for CXIF administrative access by navigating to existing your CXIF OAuth domain, then select Integrated Applications, and then Add Application.
  4. Select Confidential Application and complete the following:
    • Specify a name for the application. For example, enter CX4U-<your environment name>.
    • Specify a description. For example, enter CXIF ADMIN REST API Integration.
    • Configure redirect URIs and grant types and complete the remaining fields referring to the parent CXIF OAuth client application.
    • Link the Parent CXIF OAuth Client Application as an Authorized Resource as follows:
      • From the Resources tab, select Add Authorized Resource.
      • Select the Parent CXIF OAuth Client application.
      • Choose the scope (urn:opc:resource:consumer::all on the list)

After completing the above steps, locate an FA-Fabric Application representing your environment. The application name was likely provided to you with your CXIF environment information. Verify that the OAuth Client ID for this application is DX4C_APPID, and then complete the following steps to create an OAuth client for FA_Fabric API Access for Fusion Applications as the spoke system:

  1. Navigate to the existing FA-Fabric Application, select Integrated Applications, and then select Add Application.
  2. Select Confidential Application and then complete the following:
    • Specify a name for the application. For example, enter CX4U-<your environment name>.
    • Specify a description. For example, enter Fusion REST API Integration.
    • Configure redirect URIs and grant types and complete the remaining fields referring to the parent FA_FABRIC OAuth client app.
    • Link the Parent FA_FABRIC OAuth Client App as an Authorized Resource as follows:
      • Go to the Resources tab → Add Authorized Resource.
      • Select the Parent FA_FABRIC OAuth Client app
      • Choose the scope (urn:opc:resource:consumer::all on the list)

After you complete the above steps, you then create an OAuth client for FA_Fabric API access by Oracle Utilities Person Sync users using the following information:

  • Specify a name for the application. For example, enter CX4U-<your environment name>
  • Specify a description. For example, enter CX4U Person Sync Integration
  • For allowed grants, specify client credentials
  • For client type, specify Confidential
  • For the scope, search for the FA-Fabric Application and select scope all, which might appear as urn:opc:resource:consumer::all on the list.

When you have completed these steps, continue to one of the sections below to continue your environment preparation.

Additional Steps For Customer Cloud Service Environments

Before you can register your environments, you must contact your delivery team and request that they prepare your Oracle Utilities customer information system environments for registration.

Confirm the non-production Customer Cloud Service environments where you want to enable the CX for Utilities experiences. For example, DEV or TEST. Your delivery team can help you determine these details.

Then complete these steps:

  1. Log into your Customer Cloud Service Identity Domain.
  2. Under Oracle Cloud Services, locate the application that represents your environment. For example, the name will likely start with CCS-DEV.
  3. Create the OAuth client for REST API access as follows:
    • Specify a name for the application. For example, enter CX4U-<your environment name>
    • Specify a description. For example, enter CX4U REST API Integration
    • For allowed grants, specify JWT Assertion
    • For client type, specify Trusted
    • For certificate, specify please upload the <certificate file>

      Note:

      Create a service request with Oracle Customer Support to request the current CXIF certificate.
    • For scopes, specify the REST scope for your Oracle Utilities environment
  4. Create the OAuth client for REST API Access - Signals as follows:
    • Specify a name for the application. For example, enter CX4U-<your environment name> -SIGNAL
    • Specify a description. For example, enter CX4U API Integration (Signals)
    • For allowed grants, specify Client credentials
    • For client type, specify Trusted
    • For certificate, specify please upload the <certificate file>

      Note:

      Create a service request with Oracle Customer Support to request the current CXIF certificate.
    • For scopes, specify the REST scope for your Oracle Utilities environment

Additional Steps For Customer to Meter Environments

Complete these tasks:

  • Configure and verify the access to the C2M REST API with OAuth-based authorization.

  • Configure the system to support user interface embedding for CX for Utilities Agent Service and the data synchronization between Fusion Applications and Customer to Meter. This includes:

    • Set System Properties

    • Substitution Variables for Data Synchronization

    • Substitution Variables for Embedded Application Support

    • Configure the Content Security Policy

In this section: