Creating Key Rings and Pairs

Note: Key Rings and Pairs are used with cloud services only.

When using Smart Grid Gateway adapters with cloud services, connection 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 Object Storage Setup Guide for more information.

API key rings and key pairs are maintained in the Key Ring portal. 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)

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.

Once the key ring and key pair have been created, the key should be pasted into the User API Key in Oracle Identification and Access Management (IAM) See the User API Keys section in the Security and Access Management section of the Managing Object Storage chapter in the Oracle Cloud Infrastructure Services documentation. 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.

The last step is to activate the key. 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.” Note: Be sure to copy the public key to Oracle Identification and Access Management before activating it. Click OK to activate the key. The Key Status column will change to “Active”.