IBM App Connect passes key data between IBM Cloud Object Storage and other apps – automatically, in real time.

You can use App Connect to connect IBM Cloud Object Storage to your apps by mapping data graphically – without the need for coding – meaning that you can achieve a return on your investment in minutes or hours, not days or months.

If you can’t find what you want, or have comments about the “how to” information, please either add comments to the bottom of this page or .

About IBM Cloud Object Storage (COS) S3

IBM Cloud Object Storage (COS) S3 is ideal for holding large amounts of colder production data, such as backups and archives, and very large individual files, such as video files, image files, and genomic data. IBM’s Cloud Object Storage S3 is a reliable, durable, and resilient object storage.

Scenario:

Say you are using Salesforce to manage customers and use IBM Cloud Storage to store some related documents. You also use Dropbox to share files in folders specific to users. When a new contact is created, you want to create a folder on your Dropbox and as a first step, send a “Getting Started” document to this contact. The “Getting Started” manual is a PDF file stored in your IBM Cloud Object Storage account.

Event-Driven flow to download a document from IBM Cloud Object Storage when a new contact is created in Salesforce and upload that document to Dropbox. (Click image to view full size.)

What should I consider first?

To use Cloud Object Storage with App Connect, you must have provisioned a Cloud Object Storage service on IBM Cloud.

You can connect App Connect to the Cloud Object Storage application either from the Applications tab on the App Connect Catalog page, or when you add the application to a flow.

  • If your service instance uses IBM Cloud Identity and Access Management (IAM) authentication, provide the following connection details:
    • Endpoint URL: The Cloud Object Storage service endpoint URL for your location or region
    • IAM API key: The API key for the Cloud Object Storage service ID
    • Resource instance ID: The unique identifier for the Cloud Object Storage instance
  • If your service instance uses HMAC credentials for authentication, provide the following connection details:
    • Endpoint URL: The Cloud Object Storage service endpoint URL for your location or region
    • Secret access key: The secret access key of the instance
    • Access key ID: The access key ID of the instance
    • Region: The region of the instance
  • Example of completed fields for connecting from App Connect using IAM authentication

    Example of Cloud Object Storage connection details

You can find the connection values on the Endpoint and “Service credentials” pages for the service instance in IBM Cloud:

  1. Log in to IBM Cloud.
  2. From the IBM Cloud Dashboard, click the Cloud Object Storage service instance that you want to work with.
  3. To view the endpoint URLs, click Endpoint in the left pane and select your preferred location or region.
    • If your service instance uses IAM authentication, copy and paste your preferred public or private endpoint (for example, s3.us.cloud-object-storage.appdomain.cloud) into the App Connect Endpoint URL field.
    • If your service instance supports legacy HMAC authentication, copy and paste your preferred public or private endpoint (for example, s3.us.cloud-object-storage.appdomain.cloud) into the App Connect Endpoint URL field. Then, copy and paste your preferred location or region (for example, us-geo) into the App Connect Region field.

      Viewing Cloud Object Storage service endpoints

  4. To view the service credentials, click Service credentials in the left pane, and then click View credentials. (If you want to define new credentials to use, click New credential.)
    • If your service instance uses IAM authentication, copy the apikey value and paste it into the App Connect API key field. Then, copy the resource_instance_id value and paste it into the App Connect Resource instance ID field.

      Viewing the IAM service credentials for Cloud Object Storage

    • If your service instance supports legacy HMAC authentication, copy the cos_hmac_keys/secret_access_key value and paste it into the App Connect Secret access key field. Then, copy the cos_hmac_keys/access_key_id value and paste it into the App Connect Access key ID field.

      Note: To get the Secret access key and Access key ID values, you need to have a credential created with the option to generate HMAC credentials. (When adding a new credential, specify {"HMAC":true} in the Add Inline Configuration Parameters (Optional) field. For more information, see “Service credentials” in IBM Cloud Docs / Cloud Object Storage.

      Viewing the HMAC authentication credentials for Cloud Object Storage

Example

Creating an event-driven flow to download a file from IBM Cloud Object Storage to a Dropbox folder

Learn how to use IBM App Connect on IBM Cloud to create an event-driven flow such that when a new contact is created in Salesforce, a “Getting Started” document is automatically downloaded from IBM Cloud Object Storage and then sent to a specific folder in Dropbox.

Join The Discussion

Your email address will not be published. Required fields are marked *