--- title: "Connect data through Oracle Cloud" slug: "connect-data-through-oracle-cloud" updated: 2025-03-04T16:32:07Z published: 2025-03-04T16:32:07Z canonical: "docs.hunters.ai/connect-data-through-oracle-cloud" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.hunters.ai/llms.txt > Use this file to discover all available pages before exploring further. # Connect data through Oracle Cloud Hunters allows you to connect data sources from different products through an intermediary Oracle Cloud bucket. This process is comprised of the following steps: 1. Create an Oracle Cloud bucket 2. Direct logs to the bucket 3. Create a user with relevant permissions 4. Generate a secret key 5. Provide information to Hunters 💡Before you start To complete the steps below you must have Oracle Cloud admin permissions. --- ****STEP 1: Create an Oracle Cloud bucket**** Follow [this](https://docs.oracle.com/en-us/iaas/compute-cloud-at-customer/topics/object/creating-a-bucket.htm) Oracle guide to create your bucket, which will eventually store the logs you want Hunters to ingest. 📘Note Upon naming your bucket, make sure to follow the AWS S3 [bucket naming conventions](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html). ![image.png](https://cdn.document360.io/5f63f0e0-3c70-4d00-b623-82493be0bde5/Images/Documentation/image%28195%29.png) ****STEP 2: Direct logs to the bucket**** 📘 Note Hunters currently supports the ingestion of several types of Oracle logs via an Oracle Cloud bucket. Click [here](/v1/docs/oracle) to learn which oracle logs are supported. #### STEP 2.1: Enable auditing Oracle Cloud logs must be enabled before they can be gathered and transported to the bucket. - To enable logging for **Oracle Audit Logs**, follow [this guide](https://docs.oracle.com/en/cloud/saas/freeform/freef/audit_config.html#admin_audit_15). - To enable logging for **Oracle Service Logs**, follow [this guide](https://docs.public.oneportal.content.oci.oraclecloud.com/en-us/iaas/Content/Logging/Task/enabling_logging.htm). #### STEP 2.2: Set up a connector Once logging is enabled, create a connector to ship the logs to the bucket. **To set up a connector:** 1. From you Oracle Cloud platform, search for **Logging** and then select **Logging** under the **Services** section. ![image.png](https://cdn.document360.io/5f63f0e0-3c70-4d00-b623-82493be0bde5/Images/Documentation/image%28196%29.png) 2. From the side menu click **Connectors** and then **Create Connector** to open a new connector which will transfer the logs to the bucket. ![image.png](https://cdn.document360.io/5f63f0e0-3c70-4d00-b623-82493be0bde5/Images/Documentation/image%28197%29.png) 3. Name the connector and select the relevant compartment. 4. Under the connector **Source**, select **Logging** and under **Target**, select **Object Storage**. ![image.png](https://cdn.document360.io/5f63f0e0-3c70-4d00-b623-82493be0bde5/Images/Documentation/image%28198%29.png) 5. Under the **Configure Source** section, select the **Log group** and **log** you want the connector to ship to the bucket. 📘 Note If this connector is shipping Audit Logs, make sure to select the **Include Audit in subcompartments** checkbox. ![image.png](https://cdn.document360.io/5f63f0e0-3c70-4d00-b623-82493be0bde5/Images/Documentation/image%28199%29.png) 6. Scroll down to the **Configure Target** section to define the target bucket. 7. Select the relevant compartment and the bucket name you want logs to be shipped to. 8. Click **Show additional options** to open more setup fields. 9. Under **Batch size**, enter **1**. Under **Batch time**, enter **420000** (this is equivalent to 7 minutes). ![image200.png](https://cdn.document360.io/5f63f0e0-3c70-4d00-b623-82493be0bde5/Images/Documentation/image%28200%29%281%29.png) 10. Click **Create**. 📘Service Logging Make sure the following are performed: - Logging is enabled individually for each of the service logs you want to ship. - A connector is created for each of the service logs you want to connect to Hunters. Services that will not have logging enabled and a connector created will not be exported to the bucket and ingested properly. ****STEP 3: Create a user with relevant permissions**** To allow Huners to access and retreive logs, you'll need to create a designated Oracle Cloud user, create a group, and provide the group with the appropriate permission policies. #### STEP 3.1 Create a designated Oracle Cloud user **To create a user:** 1. From the Oracle Cloud menu, navigate to **Identity & Security > Identity > Domains**. 2. Select the relevant domain from the list. 3. From the side menu, click **Users**. [Video](https://cdn.document360.io/5f63f0e0-3c70-4d00-b623-82493be0bde5/Images/Documentation/2024-03-14_09-03-10.mp4) 4. Click **Create user** and fill in the required fields. 💡Tip Give this user a distinctive name, such as HuntersUser, so you can find it easily in the following steps. #### STEP 3.2 Create a designated Oracle Cloud group After the Hunters user is set up, you'll need to create a new user group and add the previously created user to this group. **To create a group:** 1. From the Oracle Cloud menu, navigate to **Identity & Security > Identity > Domains**. 2. Select the relevant domain from the list. 3. From the side menu, click **Groups**. 4. Click **Create group** and fill in the required fields. 5. From the **Users** list, find the previously created Hunters user and check its box to add it to the group. ![image.png](https://cdn.document360.io/5f63f0e0-3c70-4d00-b623-82493be0bde5/Images/Documentation/image%28191%29.png) 6. Click **Create** to create the group. #### STEP 3.3 Create a permission policy After the Hunters user is assigned to the group, you'll need to give the group appropriate permissios to the bucket. **To set up a permission policy:** 1. From the Oracle Cloud menu, navigate to **Identity & Security > Identity > Policies**. 2. Click **Create policy** and fill in the required fields. 3. Under **Policy Builder**, switch the toggle to **Show manual editor**. 4. Copy and paste the policy statement below into the policy box. 📘Note Make sure to change the placeholder **GroupName**, **CompartmentName**, and **BucketName** to reflect your values. ```plaintext Allow group GroupName to read buckets in compartment where target.bucket.name='BucketName' Allow group GroupName to read objects in compartment where target.bucket.name='BucketName' ``` 5. Click **Create**. ****STEP 4: Generate a secret key and an access key**** To allow Hunters to connect to your bucket with the designated user, you'll need to create a secret key and an access key for this user. **To generate a secret key and an access key:** 1. Follow [this](https://docs.oracle.com/en-us/iaas/Content/Identity/Tasks/managingcredentials.htm#create-secret-key) Oracle guide to create a secret key and an access key. 2. Copy the secret key and access key and keep them in a safe place. ⚠️Attention Your secret key will be presented only upon creation and will not be accessible after this time. Make sure to copy it and keep it in a safe place as you will need it in the next step of the process. 3. Click **Close**. ****STEP 5: Provide information to Hunters**** You'll now need to gather specific information items and provide them to Hunters using the Hunters portal. 1. On the Hunters platform, navigate to **Data > Data sources**. ![image](https://cdn.document360.io/5f63f0e0-3c70-4d00-b623-82493be0bde5/Images/Documentation/2023-03-20_17-06-49%283%29.png) 2. Click **ADD DATA SOURCES**. ![image](https://cdn.document360.io/5f63f0e0-3c70-4d00-b623-82493be0bde5/Images/Documentation/Add%20data%20source%284%29.png) 3. From the integration tiles, locate the product you want to connect. 4. From the Oracle Cloud tile, click **Connect**. ![image.png](https://cdn.document360.io/5f63f0e0-3c70-4d00-b623-82493be0bde5/Images/Documentation/image%28204%29.png) 5. Enable the data type you want to connect by making sure the toggle is switched on. ![image.png](https://cdn.document360.io/5f63f0e0-3c70-4d00-b623-82493be0bde5/Images/Documentation/image%28205%29.png) 6. For each data type enabled, provide the following information: 💡Where can I find this information? 1. From your Oracle Cloud account, navigate to **Storage > Object Storage and Archive Storage > Buckets**. ![image.png](https://cdn.document360.io/5f63f0e0-3c70-4d00-b623-82493be0bde5/Images/Documentation/image%28210%29.png) 2. Click on the bucket you want to connect. 3. See the image below to locate the information. ![image](https://cdn.document360.io/5f63f0e0-3c70-4d00-b623-82493be0bde5/Images/Documentation/2024-04-30_11-35-41.png) - **Bucket name** - The Oracle bucket that contains the logs, as defined [in step 2](/v1/docs/connect-data-through-oracle-cloud#step1). - **Bucket Namespace** - Each Oracle bucket is attached to a top-level compartment called Namespace. - **Prefix** - In case the provided bucket contains prefixes that are not accessible within our product or you do not wish to be ingested, provide an example of an accessible prefix. The Prefix must be in the following format: `<base_prefix>`. - **Bucket Region** - The Oracle Cloud region in which your bucket is located. 7. Provide your Oracle account's **Secret key** and **Access key** as defined [in step 4](/v1/docs/connect-data-through-oracle-cloud#step4). 8. Click **Test Connection** to make sure you supplied the correct information. 9. Once the connection is established, click **Apply**.