Skip to main content

​
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

Setup runs through four steps, shown in the left rail of the connector page: Credential, Connector, Space, and Advanced. Before you connect in the Admin panel, create OCI customer secret keys and note your namespace and region (see Authorization below).

​
Authorization

Create OCI credentials in the Oracle Cloud Console before connecting in UtopikAI.
  1. Log into your Oracle Cloud Console.
  2. Click on the user icon in the top-right corner and select User Settings.
OCI console — open User Settings from the profile menu
  1. Under Resources, click on Customer Secret Keys.
OCI console — Customer Secret Keys page
  1. Click Generate Secret Key.
  2. Enter a friendly name for your key (for example UtopikAIOCIConnector).
  3. Click Generate Secret Key.
  4. Copy the Secret Key immediately — you will not be able to retrieve it later.
  5. You should now see the Customer Secret Keys page with a list of keys, including the one you just generated. The corresponding access key should be present.
OCI console — generated customer secret keys OCI console — access key shown on hover
  1. To find your tenancy’s Object Storage namespace, click on the user icon in the top-right corner and select Tenancy: [your tenancy name].
  2. In the tenancy details, find the Object Storage namespace.
Store the access key and secret key securely. You will need both values, along with your namespace and region, when creating an Oracle Storage credential in the Admin panel.

​
Step 1: Select Credential

  1. Open Admin from the profile menu, then go to Connectors → Add Connector.
  2. Under Storage, select Oracle Storage.
Add Connector — select Oracle Storage under Storage
  1. In Step 1, select an existing credential from the list, or click Create New to add one.
Step 1: Select Credential for Oracle Storage Existing credentials are listed with their ID, Name, Created date, and Last Updated date. If no credential has been set up yet, the list shows No credentials found and Continue stays disabled until you select or create a credential.
Ensure the credential you select has read access to the OCI bucket you plan to index. A credential without the required bucket permissions cannot index its contents.

​
Create a credential

Clicking Create New opens the Create Oracle Storage Credential modal: Create Oracle Storage Credential modal
  1. Enter an optional Name to label the credential (for example Production OCI).
  2. Enter your OCI Namespace and OCI Region.
  3. Enter your OCI access key in GCS Access Key ID and your OCI secret key in GCS Secret Access Key. (The Admin panel uses these field labels; map them to the access key and secret key from the OCI Customer Secret Keys page.)
  4. Click + Create to save the credential.
Select the credential you created, then click Continue.

​
Step 2: Configure the connector

  1. Confirm the Credential to use for this connector.
  2. Enter the Bucket Name you want to make searchable.
  3. Optionally enter a Path Prefix to limit indexing to a folder within the bucket.
  4. Click Continue.
You can add more buckets later using the same credential.

​
Step 3: Select a space

Choose the space to index the documents from. This controls which space the connector’s indexed content belongs to. Use the search field to filter the list if you have many spaces, then click Continue.

​
Step 4: Advanced Configuration

The final step controls how often UtopikAI syncs with OCI Object Storage and how far back it indexes. The defaults work for most setups. Entering 0 or leaving Refresh Frequency blank means UtopikAI will never pull new documents for this connector. Entering 0 or leaving Prune Frequency blank disables pruning for this connector. Pruning checks every document against the source, so lower values (more frequent pruning) increase load — raise the frequency with care on large buckets. Use Reset to restore the default values. When you are done, click Create Connector to save the connector and begin indexing your OCI files. You can return to any earlier step using the Previous button or the step list in the left rail.

​
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.