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

# Oracle

The following steps outline how to create an Oracle integration in Encord.

## 1: Create a User for Encord

1. In Oracle, navigate to *Identity* and click on *Domain*.
2. Select your domain.
3. Navigate to *Users* and click **Create user**.
   A dialog box will appear, prompting you to enter details for the new user.

<div class="flex justify-center">
  <img src="https://storage.googleapis.com/docs-media.encord.com/static/img/oracle-create-user.png" width="800" />
</div>

4. Fill in the details for the new user.

<div class="flex justify-center">
  <img src="https://storage.googleapis.com/docs-media.encord.com/static/img/oracle-create-user-2.png" width="500" />
</div>

## 2: Create an Access Key for the User

1. Select the user you created in Step 1.
2. Navigate to *Customer secret keys* in the left hand navigation.
3. Click **Generate secret key**.
   A dialog appears.

<div class="flex justify-center">
  <img src="https://storage.googleapis.com/docs-media.encord.com/static/img/generate-secret-key.png" width="500" />
</div>

4. Give your access key a meaningful name and create the access key.
   The access key and secret key are generated.

5. Click **Copy** to copy the secret key. Store it in a secure location - you will need it later.

<div class="flex justify-center">
  <img src="https://storage.googleapis.com/docs-media.encord.com/static/img/copy-key-password.png" width="550" />
</div>

6. Hover over the access key, and click **Copy** to copy the access key.

<div class="flex justify-center">
  <img src="https://storage.googleapis.com/docs-media.encord.com/static/img/copy-access-key-oracle.png" width="800" />
</div>

## 3: Create a Group for the User

1. In Oracle, navigate to *Identity* and click on *Domain*.

2. Select your domain.

3. Navigate to *Groups* and click **Create group**.
   A dialog box will appear, prompting you to enter details for the new group.

<div class="flex justify-center">
  <img src="https://storage.googleapis.com/docs-media.encord.com/static/img/groups-oracle.png" width="800" />
</div>

4. Enter a meaningful name for the group and add the user you created in Step 1.

<div class="flex justify-center">
  <img src="https://storage.googleapis.com/docs-media.encord.com/static/img/enter-details-oracle.png" width="800" />
</div>

## 4: Create a Policy

1. In Oracle, navigate to *Identity* and click on *Policies*.

2. Click **Create policy**.
   A dialog box will appear, prompting you to enter details for the new policy.

<div class="flex justify-center">
  <img src="https://storage.googleapis.com/docs-media.encord.com/static/img/create-policy-oracle.png" width="800" />
</div>

3. Give the policy a meaningful name and description.

4. Enable the *Manual policy editor* toggle and paste the following into the policy editor, replacing \<ENCORD\_USER\_GROUP\_NAME> with the name of the group you created in Step 3, and replacing \<BUCKET\_NAME\_USED\_FOR\_INTEGRATION> with the name of your storage bucket.

   `Allow group <ENCORD_USER_GROUP_NAME> to read objects in TENANCY where target.bucket.name='<BUCKET_NAME_USED_FOR_INTEGRATION>'`

<div class="flex justify-center">
  <img src="https://storage.googleapis.com/docs-media.encord.com/static/img/create-policy-oracle-2.png" width="800" />
</div>

## 5: Create the Integration

1. In the *Integrations* section of the Encord platform, click **+New integration** to create a new integration.
   The integration dialog appears.

<div class="flex justify-center">
  <img src="https://storage.googleapis.com/docs-media.encord.com/static/img/create-integration-new.png" width="600" />
</div>

2. Select *Oracle* in the integration dialog.

3. Paste the *Account access key* and the *Account secret access key* from Step 2 into the integration dialog.

4. Enter the bucket namespace of your storage bucket into the integration dialog. The bucket namespace can be found in your bucket details in Oracle.

<div class="flex justify-center">
  <img src="https://storage.googleapis.com/docs-media.encord.com/static/img/bucket-name-oracle.png" width="800" />
</div>

5. In Encord, click **Create** to create the integration.

<div class="flex justify-center">
  <img src="https://storage.googleapis.com/docs-media.encord.com/static/img/oracle-integration-encord.png" width="400" />
</div>