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 Cloud, and create unstructured data lake objects (UDLOs) for the data.
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 Cloud 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.
- Change IP Relaxation to Relax IP restrictions.
- Change Permitted Users policies to All users may self-authorize.
- 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.
-
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 Cloud 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.
- 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.
- To create a new UDMO, click New.
- 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.
See Also