# OCI

Brainboard allows you to connect to your OCI environments, whether you want to provision resources, import existing infrastructure or simply manage your architecture on a daily basis.

### Configure access

To connect Brainboard to your OCI account:

1. Go to the [Cloud providers integration](https://app.brainboard.co/settings/integrations/cloud-providers) settings page.
2. Click on `Oracle Cloud Infrastructure`
3. Click on `New connection`<br>

   <figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2Fuf6ZjOXEztQ2mqD1hFq0%2FCleanShot%202025-04-24%20at%2017.30.30%402x.png?alt=media&#x26;token=21c677fb-10a8-4e3c-9496-bc7b1b3df519" alt=""><figcaption></figcaption></figure>
4. This will open the new connection page where you can add the following information

   <figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FImF2nxyCq4zqpNJuGbwp%2FCleanShot%202025-04-24%20at%2017.31.40%402x.png?alt=media&#x26;token=08974a7b-6bc1-40dc-90c3-59f5484f923c" alt=""><figcaption></figcaption></figure>

* The tenancy\_ocid variable specifies the OCID of the tenancy that you want to use. You can find your tenancy OCID in the Oracle Cloud Infrastructure Console under the "Tenancy Information" section.
* The user\_ocid variable specifies the OCID of the user to use. You can find your user OCID in the Oracle Cloud Infrastructure Console under the "User Settings" section.
* The fingerprint variable specifies the fingerprint of the public key that you have added to your user. You can find your public key fingerprint in the Oracle Cloud Infrastructure Console under the "User Settings" section.
* The private\_key variable specifies the path to the private key file that corresponds to the public key that you have added to your user. This private key will be used to sign the requests to the OCI API.

### Generate OCI credentials

To generate Oracle Cloud Infrastructure (OCI) credentials, you can use the OCI Console or the OCI CLI.

1. Using OCI Console:
2. Log in to the OCI Console
3. Go to the Identity service
4. Select Users from the navigation menu
5. Click on the "Create User" button
6. Enter a username, select "Programmatic" for the access type and then click on "Create"
7. Click on the username of the user you just created
8. Click on the "Create API Key" button

Click on the "Download" button to download the private key in PEM format

### Set the scope

Once your credentials are added you can specify where exactly they will be used

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2F36CwK4MT8qJ4WhDxUNDv%2FCleanShot%202025-04-24%20at%2017.35.09%402x.png?alt=media&#x26;token=3e7b0f1a-9cee-4d4d-82d2-cc672962891a" alt=""><figcaption></figcaption></figure>

This allows you to specify whether you want:

1. Make the credentials the default to use within your organization: which means any architecture created in Brainboard will use these credentials if it doesn't have its own ones.
2. Use in a specific project
3. Use in a specific environment
4. Use in a specific architecture

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FAeyLy9mmtDQ29QiV9ecC%2FCleanShot%202025-04-24%20at%2017.03.39%402x.png?alt=media&#x26;token=d073a475-fd61-4b28-acd0-35d297c81b01" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.brainboard.co/settings/integrations/cloud-providers/oci.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.