Configuring a Payload Storage API
Anypoint Partner Manager enables you to configure your own storage solution (for example, a database, Amazon S3, or Azure Blob Storage) to store transmission content.
To use your own storage solution, you must implement an API that provides Partner Manager with a standardized way to connect to your storage.
If you want the payload to be available from the Partner Manager Activity page, the payload storage API must be publicly accessible. If your payload storage API is accessible only through your network, you must implement the API differently. See Payload view URL for more information. |
Download and Deploy the Payload Storage API
Before you create your first partner and message flow, you must configure your payload storage API within the host organization in Partner Manager:
-
Access and download the following APIs from Anypoint Exchange:
-
Partner Manager Content Storage API
RAML specification for the payload storage API, which includes the URI parameters and record ID (contentRecordId) that the API implementation’s HTTP response header must return
-
Partner Manager Content Storage API - S3 Template
Sample template for creating the payload storage API using Amazon S3
-
-
Implement the API to connect with your choice of storage location; for example, a database, Amazon S3, or filesystem.
-
Deploy the API on a runtime that can access the storage solution.
-
Make a note of the API URL and configuration values:
-
Host, port, and path connection
-
Connection Idle and Response timeouts
-
Authentication types:
-
None
-
API Key
-
Basic
-
Client Credentials
-
OAuth Token
-
-
Certificate (
.PEM
format) and connection typesYou’ll need this information when you associate Anypoint Partner Manager with your payload storage API. Your payload storage API must be accessible over the internet via HTTPS. Ensure you implement the appropriate authentication mechanisms to enable access over HTTPS.
-
Add the Payload Storage API to the Host Profile
-
In Anypoint Platform, open Anypoint Partner Manager.
-
From the sidebar, select your organization’s host page.
-
In the Payload storage section of the page, click Edit to add the path to your payload storage.
-
Enter the following values:
-
Endpoint name: The name of the payload storage API
-
Description: The optional description for your payload storage
-
URL: The path to your payload storage
This URL does the following:
-
Stores payloads when transactions process in the runtime
-
Retrieves the payload when you click View Payload on the Transaction Activity page, unless a payload view URL is configured
-
-
Payload view URL: (Optional) A secondary payload storage API URL that you can use to view the payload on the Activity page if the payload storage API is restricted to your internal network. See the Partner Manager API implementation example in Exchange for more information.
If the payload storage API isn’t restricted to your internal network, leave this field blank so that you can view the payload by using the View Payload button.
-
-
Optionally, if you want to view (or allow your users to view) the raw payloads of the files you receive or send, select Allow users to download payloads.
-
Click Save.
Change the Payload Storage API Configuration
To change the payload storage API configuration:
-
In the Payload storage section of the Host page, click Edit.
-
Modify the field values that require changing.
-
Click Save.
-
To have the changes take effect, either redeploy an existing message flow or deploy a new message flow.