Connectors and Connections > Data Ingestion and Replication connection properties > Oracle Cloud Object Storage connections
  

Oracle Cloud Object Storage connections

Create a Oracle Cloud Object Storage connection to read data from or write data to Oracle Cloud Object Storage files. You can use Oracle Cloud Object Storage connections to specify sources and targets in mappings and mapping tasks.

Prerequisites

Before you create an Oracle Cloud Object Storage connection to read from or write to Oracle Cloud Object Storage, be sure to complete the prerequisites.

Configure Oracle Cloud Infrastructure policies

As a user, you can use Oracle Cloud Object Storage Connector after the organization administrator creates a minimal Oracle Cloud Infrastructure (OCI) Identity and Access Management (IAM) policy for Oracle Cloud Object Storage Connector.
The Oracle Cloud Infrastructure policy defines the resources that users and groups can access in an OCI account and how to access them. You can use policies to manage certain types of resources in a specific compartment in certain ways.
You need to perform the following tasks:
  1. 1Define users, groups, and one or more compartments to hold the cloud resources for your organization.
  2. 2Create the policies.
  3. 3Place users into the appropriate groups depending on the compartments and resources they need to work with.
  4. 4Provide the users with the one-time passwords that they need to access the console and work with the compartments.
For more information about adding users, groups, and policies, see Oracle Cloud Infrastructure documentation.
You can create a policy in the following format:
Allow group <group_name> to <verb> <resource-type> in compartment <compartment_name>
For example,
Allow group ObjectReaders to read buckets in compartment ABC
Allow group ObjectWriters to manage objects in compartment ABC where any {request.permission='OBJECT_CREATE', request.permission='OBJECT_INSPECT'}
You need to add the following policies to configure the Oracle Cloud Object Storage connection, access objects, and run mappings:

Prepare for authentication

You can configure the following authentication methods for Oracle Cloud Object Storage Connector:
ConfigFile authentication
The ConfigFile authentication uses identity credentials of Oracle Cloud Infrastructure (OCI) account provided through a configuration file for authentication. This authentication method is based on the profile selected in the configuration file.
You can create a configuration file in the following format:
[<profile name>]
user=<user ocid>
fingerprint=<fingerprint>
tenancy=<tenancy ocid>
region=<region>
key_file=<private key file location>
You require the user OCID, fingerprint, and tenancy OCID information from the OCI account for the configuration file.
For more information about the steps to extract the identity credentials from the Oracle Cloud Infrastructure Console, see the Oracle Cloud Infrastructure documentation.
By default, the OCI configuration file is located at ~/.oci/config on the Secure Agent machine. The ~/.oci/config file can contain several profiles. The default profile name is DEFAULT. You can change the default profile name to any new profile names based on the profiles that you add to the ~/.oci/config file. The ~/.oci/config file cannot contain two profiles with the same name.
Simple authentication
The simple authentication uses API keys for authentication. You can provide the authentication details in the Oracle Cloud Object Storage connection. You need to place the private key file in the Secure Agent machine.
You require the user OCID, fingerprint, and tenancy OCID information from the Oracle Cloud Infrastructure account to create an Oracle Cloud Object Storage connection.
For more information about the steps to extract the identity credentials from the Oracle Cloud Infrastructure Console, see the Oracle Cloud Infrastructure documentation.

Connect to Oracle Cloud Object Storage

Let's configure the Oracle Cloud Object Storage connection properties to connect to Oracle Cloud Object Storage.

Before you begin

Before you get started, configure the Oracle Cloud Infrastructure policies and get the required information from your Oracle Cloud Infrastructure account based on the authentication type that you want to configure.
Check out Prerequisites to learn more about these tasks.

Connection details

When you create an Oracle Cloud Object Storage connection, configure the connection properties.
The following table describes the basic connection properties:
Property
Description
Connection Name
The name of the connection.
Each connection name must be unique within the organization. Connection names can contain alphanumeric characters, spaces, and the following special characters: _ . + -,
Maximum length is 255 characters.
Description
The description of the connection. Maximum length is 4000 characters.
Type
Oracle Cloud Object Storage
Runtime Environment
The name of the runtime environment where you want to run tasks.
Select a Secure Agent.

Authentication types

You can configure ConfigFile or simple authentication to connect to Oracle Cloud Object Storage. Select the required authentication type and then configure the authentication-specific parameters.
Default is ConfigFile Authentication.

Proxy server settings

If your organization uses an outgoing proxy server to connect to the Internet, the Secure Agent connects to Informatica Intelligent Cloud Services through the proxy server.
You can configure the Secure Agent to use the proxy server on Windows and Linux. You can use the unauthenticated or authenticated proxy server.
Note: You cannot use a proxy server with managed identity authentication.
You can use one of the following types of proxy servers:
To configure proxy settings for the Secure Agent, use one of the following methods: