Connecting to IBM Cloud Object Storage

Edit online

IBM Cloud Object Storage (IBM COS) is a highly scalable cloud storage service designed for unstructured data, such as documents, images, audio, video, and backups. It offers enterprise-grade durability, security, and flexibility for storing and retrieving data across various applications and workflows. Integrating IBM COS with IBM watsonx Orchestrate enables automated data ingestion, backup, archiving, and content-based workflows.

To integrate IBM COS with IBM watsonx Orchestrate, you need to establish a secure connection that enables both systems to communicate seamlessly. For general guidance on managing integrations, refer to Connecting apps for prebuilt agents.

To enable this integration, you must establish a secure connection that enables both platforms to communicate. See Managing connectionsfor more details.

Note:

The Single sign-on (SSO) toggle is enabled only for supported OAuth 2.0 authentication types and applications. If the application does not support an SSO-enabled authentication type, the toggle remains disabled. For supported configurations, see Configuring single sign-on for applications.

Steps to connect

Use the following steps to connect IBM Cloud Object Storage to watsonx Orchestrate:

Go to Manage > Connections and search for the corresponding app name or IBM COS Connection ID.
Click edit next to the matching connection ID.
Select Key Value Pair as the authentication type.
Enter the IBM COS‑specific fields. See Connecting apps for prebuilt agents page for general connection workflow.
Complete the Draft and Live setup steps.
Save and test the connection to confirm successful connection.

Authentication methods

IBM Cloud Object Storage supports the following authentication type in watsonx Orchestrate:

Key Value Pair (KVP)

Connection ID

Use the following Connection ID when locating your IBM COS connection in the Connections settings page. To understand how to search for a Connection ID and open a connection for editing, see Connecting apps for prebuilt agents.


Authentication type	Connection ID
Key Value Pair	`ibm_cos_ibm_184bdbd3`

Key Value Pair connection details

Set Authentication type to Key Value Pair and add the following fields using Add new field:


Key	Description
`server_url`	The server URL for the IBM COS instance
`api_key`	The IBM Cloud API key associated with your COS service instance
`instance_id`	The service instance ID of your IBM COS instance
`base_url`	The base URL for IBM COS API operations

Note: When using Key Value Pair, only Team credentials are supported.

To get these values, refer to the IBM COS API documentation.

What to do next

Now that your app connection is live, you can start using it in watsonx Orchestrate.

Run an agent in Orchestrate Chat to complete tasks using natural language. See Using Orchestrate Chat for more details.
Use relevant agents and tools to perform app-specific actions. See Prebuilt agents and Prebuilt tools for more details.