# Oracle Cloud

## Connection Requirements

{% stepper %}
{% step %}

### Domain

Domain of the Oracle Cloud. Pattern: `iaas.<REGION>.oraclecloud.com` (example region: `us-ashburn-1`).
{% endstep %}

{% step %}

### Tenancy OCID

The OCID of your Oracle Cloud tenancy.

How to get: Console -> Profile menu -> **Tenancy information** -> copy the OCID value.

Format: `ocid1.tenancy.oc1..[unique-identifier]`
{% endstep %}

{% step %}

### User OCID

The OCID of the IAM user that owns the API key (not the console username).

How to get: Console -> Profile menu -> **User settings** -> copy the OCID value.

Format: `ocid1.user.oc1..[unique-identifier]`
{% endstep %}

{% step %}

### Fingerprint

The fingerprint of your API signing key. This is generated when you upload your public key.

How to get: Console -> Profile menu -> **User settings** -> **API Keys** -> view the fingerprint of your uploaded key.

Format: `aa:bb:...:aa:bb`
{% endstep %}

{% step %}

### Private Key

The private key (PEM format) used to sign API requests.

How to get: Generate an RSA key pair using OpenSSL or OCI CLI. Upload the public key to Console -> Profile menu -> **User settings** -> **API Keys**, then use the private key here.

Command:

{% code title="Generate RSA private key" %}

```bash
openssl genrsa -out ~/.oci/oci_api_key.pem 2048
```

{% endcode %}
{% endstep %}

{% step %}

### Compartment OCID

OCID of the compartment to scope API calls (e.g., listing instances).

How to get: Console -> **Identity & Security** -> **Compartments** -> select your compartment -> copy OCID.

Format: `ocid1.compartment.oc1..[unique-identifier]`
{% endstep %}

{% step %}

### Version

OCI core services API version. Default is `20160918` for compute and networking services.

How to get: Use the default value `20160918` unless you need a specific API version.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Please perform a connection test to ensure there is a valid connection to the Oracle Cloud host. When the discovery operation finalizes you will be able to see the details on the Assets page.
{% endhint %}