How to connect an Oracle Cloud account

In this article, you’ll learn how to connect an Oracle Cloud (OCI) compartment to Cloud Entitlements, including all the users and groups under the compartment.

Requirements

• An OCI account with permission to generate API keys.
• A group with an attached policy containing the following statements:
  • Allow group <group name> to read users in tenancy
  • Allow group <group name> to read groups in tenancy
  • Allow group <group name> to read policies in tenancy

Generate an API key for a user in Oracle Cloud

1. Access your Oracle Cloud Infrastructure account.
2. Click the Profile icon > My profile.
3. Navigate to the API keys page.
4. Click Add API key.
5. Download the RSA private key and click Add.
6. Copy the contents or download the configuration file. It should be in the following format:

[DEFAULT]
user=<user ID>
fingerprint=<RSA fingerprint>
tenancy=<tenancy ID>
region=<OCI region>
key_file=<path to your private keyfile>

Connect an OCI organization

1. Go to Cloud Entitlements left menu.
2. Click Setup to open a dropdown menu.
3. Select Oracle Cloud (OCI).
4. On the upper-right corner, click + Connect.
5. Fill in the following fields:
   1. Name.
   2. User: fill in with the value of user from the configuration file.
   3. Region: select the region set in Oracle Cloud and shown in the configuration file.
   4. Fingerprint: fill in with the value of fingerprint from the configuration file.
   5. Compartment ID.
   6. Tenancy: fill in with the value of tenancy from the configuration file.
   7. Passkey phrase: if set during the creation of the API key, add the passphrase for the .pem file.
6. Click Save.

If connected successfully, your OCI compartment will appear in the list of connected accounts.

You can activate or deactivate the compartment by turning the Status switch on or off.