> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onyx.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Oracle Cloud Storage

> Access files from Oracle Cloud Storage buckets

## How it works

The Oracle Cloud Infrastructure (OCI) Storage connector pulls in all documents from the specified OCI bucket.
It supports various file formats including PDF, DOC, DOCX, TXT, and more.

Documents are updated every **1** day.

## Setting up

### Authorization

<Steps>
  <Step title="Open Oracle Cloud Console">
    Log into your Oracle Cloud Console.
  </Step>

  <Step title="Open User Settings">
    Click on the user icon in the top-right corner and select "User Settings".

    <img className="rounded-image" src="https://mintcdn.com/danswer/aj13v1mzLf028SWE/assets/admins/connectors/blob/oci/topbar.png?fit=max&auto=format&n=aj13v1mzLf028SWE&q=85&s=2e002c62e66683f8ad6c69171d2c8b69" alt="OCI user settings" width="3198" height="226" data-path="assets/admins/connectors/blob/oci/topbar.png" />
  </Step>

  <Step title="Open Customer Secret Keys">
    Under "Resources", click on "Customer Secret Keys".

    <img className="rounded-image" src="https://mintcdn.com/danswer/aj13v1mzLf028SWE/assets/admins/connectors/blob/oci/apikeys.png?fit=max&auto=format&n=aj13v1mzLf028SWE&q=85&s=185bd219b8249ce8c206924f9deff3f4" alt="OCI customer secret keys" width="3178" height="1018" data-path="assets/admins/connectors/blob/oci/apikeys.png" />
  </Step>

  <Step title="Generate Secret Key">
    Click "Generate Secret Key".
  </Step>

  <Step title="Name the key">
    Enter a friendly name for your key (e.g., "OnyxOCIConnector").
  </Step>

  <Step title="Generate and copy key">
    Click "Generate Secret Key". You will see your Secret Key. Make sure to copy the key immediately,
    as you won't be able to retrieve it later.
  </Step>

  <Step title="Verify keys list">
    You should now be taken to the "Customer Secret Keys" page and see a list of keys (including the name of the key you
    just generated). The corresponding access key should be present.

    <img className="rounded-image" src="https://mintcdn.com/danswer/aj13v1mzLf028SWE/assets/admins/connectors/blob/oci/secretkeys.png?fit=max&auto=format&n=aj13v1mzLf028SWE&q=85&s=aec09a344db5c3da2496ff561708f7fa" alt="OCI secret keys list" width="3168" height="1074" data-path="assets/admins/connectors/blob/oci/secretkeys.png" />

    <img className="rounded-image" src="https://mintcdn.com/danswer/aj13v1mzLf028SWE/assets/admins/connectors/blob/oci/hoverkey.png?fit=max&auto=format&n=aj13v1mzLf028SWE&q=85&s=b028e9fd8c78d8f2393737f01d651551" alt="Hover key to view access key" width="1150" height="402" data-path="assets/admins/connectors/blob/oci/hoverkey.png" />
  </Step>

  <Step title="Find Object Storage namespace">
    To find your tenancy's Object Storage namespace, click on the user icon in the top-right corner and select "Tenancy:
    \[your tenancy name]". In the tenancy details, you'll find the Object Storage namespace.
  </Step>
</Steps>

### Indexing

<Steps>
  <Step title="Open OCI Storage connector">
    Navigate to the Admin Panel and select the **Oracle Cloud Infrastructure Storage** Connector.
  </Step>

  <Step title="Enter OCI credentials">
    In **Step 1**, provide your OCI credentials:

    <img className="rounded-image" src="https://mintcdn.com/danswer/sZSCgOqeRdUK59k_/assets/admins/connectors/blob/oci/Onyx1.png?fit=max&auto=format&n=sZSCgOqeRdUK59k_&q=85&s=b25c6d78f4a4791173947d7122748a1d" alt="OCI credentials input" width="2812" height="1646" data-path="assets/admins/connectors/blob/oci/Onyx1.png" />

    * Provide your OCI Access Key, Secret Key, Namespace, and Region for authentication.
    * These credentials will be used to access your OCI buckets.
  </Step>

  <Step title="Save credentials">
    Click "Update" to save your credentials.
  </Step>

  <Step title="Select bucket">
    In **Step 2**, specify which OCI bucket you want to make searchable:

    <img className="rounded-image" src="https://mintcdn.com/danswer/aj13v1mzLf028SWE/assets/admins/connectors/blob/oci/Onyx2.png?fit=max&auto=format&n=aj13v1mzLf028SWE&q=85&s=6ed01b939873f3bab689a1ca868cf9ea" alt="OCI bucket selection" width="2826" height="1862" data-path="assets/admins/connectors/blob/oci/Onyx2.png" />
  </Step>

  <Step title="Start indexing">
    Click "Connect" to begin indexing.
  </Step>
</Steps>

## Understanding Oracle Cloud Infrastructure Object Storage Structure

Oracle Cloud Infrastructure Object Storage organizes data into buckets.
Each bucket can contain an unlimited number of objects (files). You can think of a bucket as a root directory,
and the objects as files within that directory.

For more information on OCI Object Storage structure,
visit the [Oracle Cloud Infrastructure Object Storage
documentation](https://docs.oracle.com/en-us/iaas/Content/Object/Concepts/objectstorageoverview.htm).