Oracle
4 minute read
Connecting your Oracle Cloud Infrastructure (OCI) tenancy to Cloud2Gether allows the platform to discover and analyze your cloud resources. Cloud2Gether uses API Key Authentication with a user OCID, tenancy OCID, API key fingerprint, and private key (PEM).
Cloud2Gether requires read-only style access for discovery and analysis — it should not be granted write permissions beyond what is needed for authentication.
Prerequisites
Before you begin, make sure you have:
- An active Oracle Cloud Infrastructure (OCI) tenancy
- Access to the OCI Console with permission to:
- View your User OCID and Tenancy OCID
- Create or upload an API signing key for your user
- A Cloud2Gether account — sign up here if you don’t have one
Information You Will Need
| Value | Where to Find It |
|---|---|
| User OCID | OCI Console → Profile (user menu) → User settings → OCID |
| Tenancy OCID | OCI Console → Administration → Tenancy details → OCID |
| API Key Fingerprint | User settings → API Keys (after uploading the public key) |
| Private Key (PEM) | The private key file generated when you create the API key pair |
| Region (optional) | Home region or the region you want Cloud2Gether to focus on |
Part 1 — Oracle Cloud Configuration
Step 1 — Collect your User OCID
- Sign in to the OCI Console
- Open your user profile menu (top-right)
- Go to User settings (or My profile)
- Copy the OCID — it starts with
ocid1.user.oc1...
Step 2 — Collect your Tenancy OCID
- In the OCI Console, open the navigation menu
- Go to Governance & Administration → Tenancy details (wording may vary slightly by console version)
- Copy the tenancy OCID — it starts with
ocid1.tenancy.oc1...
Step 3 — Create an API signing key
Cloud2Gether authenticates with an OCI API signing key pair.
- Still in User settings, open the API Keys section
- Click Add API key
- Choose one of these options:
- Generate API key pair (recommended if you do not already have keys), or
- Paste public key / upload an existing public key
- If you generate a new pair, download the private key immediately and store it securely
- After the key is added, copy the Fingerprint (format like
aa:bb:cc:dd:...)
The private key (PEM) is shown or downloaded only when you create it. Store it securely and never commit it to source control or share it in chat. You will paste the PEM content into Cloud2Gether.
Step 4 — Confirm read access for discovery
Ensure the OCI user (or a group the user belongs to) has policies that allow read/inspect access to the resources you want Cloud2Gether to analyze.
Prefer policies that grant inspect/read on compartments you care about, rather than broad manage permissions. If your organization uses a dedicated automation user, create the API key on that user and use its OCID in Cloud2Gether.
Part 2 — Connect in Cloud2Gether
Step 1 — Open the Oracle link flow
- Sign in to Cloud2Gether
- In the left sidebar, open Cloud Accounts
- Click Link account → Oracle
- Or open: https://auth.cloud2gether.com/auth/login/password
The page title is Link new Oracle Cloud account. The authentication method is API Key Authentication.
Step 2 — Fill in the form
Complete the steps in the app:
| Step in app | Field | What to enter |
|---|---|---|
| 1 | Select an account name | A friendly name in Cloud2Gether (e.g. Oracle Production) |
| 2 | User OCID | ocid1.user.oc1... |
| 3 | Tenancy OCID | ocid1.tenancy.oc1... |
| 4 | API Key Fingerprint | Fingerprint from OCI API Keys |
| 5 | Private Key (PEM) | Full PEM content (-----BEGIN RSA PRIVATE KEY----- … -----END RSA PRIVATE KEY-----) |
| 6 | Region (optional) | Select a region if offered |
Step 3 — Create the configuration
- Click Create configuration
- Wait while Cloud2Gether validates the credentials
- On success, you are returned to the Cloud Accounts list — open View Account to manage Overview, Configuration, Credentials, and Logs
If you see We couldn’t verify your Oracle credentials, double-check the User OCID, Tenancy OCID, fingerprint, and that the private key matches the uploaded public key. Also confirm the user has policy access to the tenancy/compartments you expect.
Related
- Cloud Accounts overview
- Managing cloud accounts
- Getting Started — Cloud Accounts
- AWS · Azure · GCP · Alibaba
Feedback
Was this page helpful?
Was this page helpful?
Let us know how we can improve