Before You Begin

This 15-minute tutorial shows you how to generate API signing keys for the Cloud Manager installation.

Background

An API signing key pair is needed for authentication when Cloud Manager submits API requests. After you generate the key, you add the key to your user account in the Oracle Cloud Infrastructure Compute Console. You will also enter the key as input in the Resource Manager stack.

After you generate the keys in this tutorial, you can use the same API keys with the Lift Utility to create and upload DPKs to Oracle Cloud Infrastructure. See the information on using the Lift Utility in PeopleSoft Cloud Manager for Oracle Cloud Infrastructure on the PeopleSoft Hosted Online Help site.

This is the ninth tutorial in the Install PeopleSoft Cloud Manager series. Read the tutorials in the order listed. The optional tutorials offer alternate methods for setup.

Step 1: Generate the API Key Pair

  1. In a Bash shell (Linux) or git bash shell (Microsoft Windows), create the API signing pair and note the names and passphrase.

    The passphrase for the Cloud Manager installation must contain only alphanumeric characters and the following special characters: ~@#%^*-_=+[{]}:.,?/

    This tutorial uses cm_api_key.pem and cm_api_key_public.pem as the key names.

    See Required Keys and OCIDs in the Oracle Cloud Infrastructure Documentation.

    Tip:

    The path /c/Users/username/.oci in the git bash shell corresponds to the path C:\Users\username\.oci in the Windows File Explorer. To view the current working directory in the git bash shell, enter pwd.
  2. Open the public key in a text editor, or view the contents. For example: 
    $ more cm_api_key_public.pem
  3. Copy the text into your clipboard.

    The method to copy text in Putty may vary. For example, select the text and left-click to copy it. Use this format to enter the API key in your user account.

    -----BEGIN PUBLIC KEY-----
MIIBxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    xxxxxxxxxxxxxxxxxxx
    -----END PUBLIC KEY-----
  4. Open the private key in a text editor, or view the contents. Save the contents to use in the tutorial Install Cloud Manager with Resource Manager.

Step 2: Add the API Public Key to Your User Account

  1. In the Oracle Cloud Infrastructure console, select Identity, Users, and then your user name.
  2. Under API Keys, click Add Public Key.
    User details page with Add Public Key button
    Description of this illustration (generate-api-key8-user-page-addkey.png)
  3. Paste the key contents into the field and click Add. The key appears on the user details page.
    Add Public Key dialog box
    Description of this illustration (generate-api-key9-add-dbox.png)
  4. Save the full path, names, and passphrase for the public and private API keys.

    You will use them in the next tutorial.

Next Steps

Install the PeopleSoft Cloud Manager Stack with Resource Manager

Learn More