7 Connecting the Oracle Utilities Application to OCI Object Storage

The Auto Pay batch processes described in Configuring the Integration require the use of Object Storage for sending/receiving files to/from the Oracle Utilities application (such as Oracle Utilities Customer Cloud Service). In production, the Object Storage in the utility's Cloud tenancy is used. For development/QA purposes, a third-party payment processor uses Object Storage in their own Cloud tenancy.

To connect the Oracle Utilities applications (such as Oracle Utilities Customer Cloud Service) to OCI Object Storage:

  1. Login to Oracle Utilities Customer Cloud Service.
  2. In the search box, enter “key ring”. From the search results, select Key Ring.

    Figure 7-1 Select Key Ring


    Shows Key Ring in the search results.

  3. On the Key Ring page, click Add.

    Figure 7-2 Add the Key Ring.


    Shows adding a new king ring to the existing list.

  4. From the Key Ring Business Object drop down, select the RSA Signature Key Pair business object and click OK.

    Figure 7-3 Select the Key Ring Business Object


    Shows the Key Ring Business Object drop-down list.

  5. Specify the Key Ring and Description values. Click Save.

    Figure 7-4 Key Ring Details


    Enter the Key Ring and Description values.

  6. Verify the details. Click Generate Key to populate a key pair.

    Figure 7-5 Generate New King Ring


    Verify the details and generate key.

  7. Click View to display the Public Key value. Copy the value to the clipboard. You can paste the value in Notepad.

    Figure 7-6 Display Public Key


    Shows the Public Key value.

  8. Navigate to the OCI console and click the icon for Profile options (on the top-right corner). Select your username from the list.

    Figure 7-7 Profile Options


    Select the username from the Profile options.

  9. Navigate to the Tokens and keys tab and click Add API key.

    Figure 7-8 Add API Key


    On the Tokens and keys tab, add the API key.

  10. Select Paste a public key. Copy the public key value that you have pasted in Notepad (see step 7) and paste it in the text box. Click Add.

    Figure 7-9 Add API Key


    Copy and paste the public key.

  11. Navigate to Oracle Utilities Customer Cloud Service.
  12. In the search box, enter “extendable”. From the search results, select the Extendable Lookup menu item.

    Figure 7-10 Select Extendable Lookup


    Select the Extendable Lookup menu item.

  13. On the Extendable Lookup Query screen, search for the “F1-FileStorage” business object. From the search results, select the respective record.
  14. Lookup values for the selected business object are displayed. Click Add.

    Figure 7-11 Extendable Lookup Value List


    Displays lookup values for the selected business object.

  15. Provide the details of the OCI user using the configuration output generated by the API key on the OCI console (Step 9 above).

    Note:

    Make sure you select the correct region supported by the Utilities application and is subscribed on the OCI console.
  16. From the menu on the top-left corner of the OCI console, navigate to Storage > Object Storage & Archive Storage and select Buckets.

    Figure 7-12 Object Storage


    Select Buckets from the Storage list.

  17. Create a bucket (meaningful and easy to remember). This is the key to generate file path for the application. Confirm that the compartment matches with what was listed in the Extendable Lookup.

    The extendable lookup value is provided in the Value field on the File Storage Configuration page. See step 15 above for more details.

    Using the value, make sure the file path looks as follows: file-path://CM-EXAMPLE/input or file-path://CM-EXAMPLE/output

    Each bucket region should match the region declared in the extendable lookup and be unique (distinct bucket for each endpoint).

    Figure 7-13 Create a Bucket


    Enter a name for the bucket.

    Figure 7-14 Create a Bucket


    Enter the bucket name.