Oracle Utilities Cloud Service Configuration for Object Storage Connection

Authentication and connection between the Oracle Utilities cloud service and Object Storage enables batch processes to import and export files from and to Object Storage locations. Setting up this authentication requires the following in your Oracle Utilities cloud service:

• Creating API Keys

• Creating An Object Storage Connection

Refer to the Oracle Utilities Cloud Services Administration Guide for details concerning setting up Keys and Key Rings, an object storage connection configuration, and registering the API key.

Note: You can use the same API Keys and Object Storage Connection setup for both import and export process.

Creating API Keys

Create a key ring for the cloud service environment. The key ring should be active and should have a set of private/public encryption key pairs. This key ring will be included in the Object Storage Connection Configuration.

Creating Key Rings and Pairs

Authentication between the Oracle Utilities cloud service and Oracle Object Storage requires an API signature key. See API Key Management in the Oracle Utilities Cloud Services Administration Guide for more information.

API key rings and key pairs are maintained in the Key Ring portal in the cloud service. This portal contains the following zones:

• Key Ring: Displays basic information about the key ring

• Key Pairs: Displays a list of key pairs for the current key ring

Key rings are defined by the following:

• Key Ring: A unique code for the key ring

• Key Ring Class: Signature (default)

• Status: The current status of the key ring.

Note: Key pairs can only be generated for Active key rings. Once a key ring has been deactivated, you can no longer create key pairs for that ring.

• Description: A name for the key ring (this will be referenced in the File Location extendable lookup, see below)

Once the key ring is created, you need to generate and activate the key pair. Click Generate Key to generate a key pair for the key ring.

Key Pairs are defined by the following:

• Sequence: The sequence of the key pair (the order in which the key pair was created)

• Creation Date/Time: The date/time when the key pair was created

• Key Status: The current status of the key pair. Key pairs are inactive when first created.

• Public Key: Click View to open a dialog box containing the public key.

• Action: Click Activate to activate an inactive key pair.

Click Activate in the Actions column in the Key Pairs zone. A dialog box opens displaying the following message: “Warning(s): Activating a key assumes that you have already registered the public key with the appropriate third parties. Press Cancel to abort.” Click OK to activate the key. The Key Status column will change to “Active”.

Note: Be sure to register the API Key with Object Storage by copying the public key to Oracle Identification and Access Management. To copy the public key, click View in the Actions column in the Key Pairs zone, and select and copy the text in the View Public Key dialog box. Refer to Register API Key to Oracle Cloud Object Storage for more information.

Creating An Object Storage Connection

Create an object storage connection via the File Storage Configuration extendable lookup (F1-FileStorage). This defines the Object Storage location where the files will be stored.

Creating File Storage Extendable Lookup Values

Apart from the authentication, the cloud service also needs information about the Object Storage locations to be used. Object Storage locations are defined by values in the File Storage Configuration (F1-FileStorage) extendable lookup. These file storage configurations will be referenced by the batch processes that will import or export records.

Values for the File Storage Configuration extendable lookup are defined by the following:

• Value: A unique code for the extendable lookup value. This value will be referenced as a batch control parameter value.

• Description: A description of the extendable lookup value

• Status: The current status of the value. Select “Active”.

• File Storage Details: This section defines details for the object storage location, including:

• File Adapter: The type of file adapter for the location. Select “Oracle Cloud Object Storage”.

• User: The user Oracle Cloud ID (ODIC) for the object storage location

• Tenancy: The tenancy Oracle Cloud ID (ODIC) for the object storage location

• Compartment: The compartment Oracle Cloud ID (ODIC) for the object storage location

• Namespace: The namespace for the object storage location

• Key Ring: The Key Ring you created earlier

• Region: The region of the object storage tenancy for the connection (Values for this field are defined in the F1_REGION_FLG lookup.

Refer to External File Storage in the Oracle Utilities Application Framework Administrative User Guide and the Oracle Utilities Cloud Services Administration Guide for more information.