Set Up the MuleSoft Direct Connector (Beta)

To set up the MuleSoft Direct connector, you need to create a connected app, add the connector in Data 360, and create unstructured data lake objects (UDLOs) for the data. See the Unstructured Data File Formats and Connectors for a list of supported file formats.

Before You Begin

Review these prerequisites.

You should have some familiarity with MuleSoft business groups, environments, and deployment targets.
Make sure that you have the necessary credentials to connect to the external sources. Refer to the MuleSoft Direct Reference for details.

From Setup, enter External Client Apps in the Quick Find box, and then select External Client App Settings.
Turn on Allow creation of connected apps.

Select New Connected App and set these values.

Value	Description
Connected App Name	Enter the connected app’s name, which displays in the App Manager and on its App Launcher tile. The connected app name must be unique within the org, for example, My MuleSoft Direct.
API Name	Enter the API name used when referring to your app from a program. It defaults to a version of the name without spaces for example., My_MuleSoft_Direct.
Contact Email	Enter the contact email for Salesforce to use to contact you or your support team.

In the API (Enable OAUTH Setting) area, select Enable OAuth Settings.
Select Enable for Device Flow.
Select these OAuth scopes.
- Manage user data via APIs (api)
- Perform requests at any time (refresh_token, offline_access)
- Manage Data 360 Ingestion API data (cdp_ingest_api)
Select Enable Client Credentials Flow.
When you understand the security risks, accept the warning and save your changes.
Click Manage Consumer Details and copy the consumer key and secret values.
At the top of your newly created connected app click Manage.
Select Edit Policies.
1. Change IP Relaxation to Relax IP restrictions.
2. Change Permitted Users policies to All users may self-authorize.
3. Under Client Credentials Flow, for Run As, click the search icon, and find the user who you want to assign the client credentials flow to. For Enterprise Edition orgs, we recommend that you select an execution user who has the API Only User permission.
Save your changes.
In Setup search for “OAuth and OpenID Connect Settings”, and then turn on Allow Authorization Code and Credentials Flows.

Set Up MuleSoft Direct in Data 360

In Salesforce, click Setup.
Select Integrations > Integration Solutions > MuleSoft Direct Setup.
Click Connect to MuleSoft.
Select the US or EU server.
Authenticate to the Anypoint Platform using your user credentials or to the connected app using your client ID and secret.
(For orgs with Industry and Data Cloud licenses) In the Available Assets section, select the Data Cloud filter.
Select the application asset that you want to use, and click Enable Instance.

Add the necessary details to enable the instance

Display Name	The unique name of the application
App Name	The unique name of the application instance
Business Group	The MuleSoft business group in which you’re deploying the app instance
Environment	The MuleSoft environment in which you’re deploying the application instance
Deployment Target	The MuleSoft deployment target in which you’re deploying the application instance

Click Next.
Authenticate to the external source, and click Next.
Each source has different authentication options.
Wait for the asset instance to deploy.

When the instance is ready, its status changes to Active. An application instance can also be in an error state or still require authentication.

After the application instance deploys and is active, Data 360 creates a read-only connector for that application instance. Use the connector to create unstructured data lake objects (UDLOs) to ingest data from the external source.

Create an Unstructured Data Lake Object from MuleSoft Direct

From App Launcher, select Data Cloud.
Click Data Lake Objects and then click New.
From the New Data Lake Object menu, select From External Files, and click Next.
Click MuleSoft Direct and click Next.
From the Select Connection dropdown list, select a connection to an application instance.
For File Details, use wildcard characters to specify a file name pattern for multiple files.
To add more directories, click Add more files, and add up to five file name patterns.
Click Next.
Add an object name and an object API name for the UDLO. See Data Lake Object Naming Standards.
From the Data Space dropdown list, select the data space where you want to create the UDMO, or select a data space that has an existing UDMO.
Map the UDLO to a UDMO.
1. To create a new UDMO, click New.
2. To use an existing UDMO, click Existing, and select a UDMO from the list.
(Optional) Select the option to create a search index configuration for the UDMO using system defaults. You can deselect this option and create a search index configuration later.
Click Next, or if you chose to create a search index configuration, review the details, and save your work.
To initiate data ingestion, go to the details page for the new UDLO and click Refresh Now.

Set Up the MuleSoft Direct Connector (Beta)

Before You Begin

Set Up MuleSoft Direct in Data 360

Create an Unstructured Data Lake Object from MuleSoft Direct

See Also