Loading

ERROR: Could not authenticate with the provided token when setting up and pairing a Mule Standalone Server with Anypoint Runtime Manager

Publish Date: May 11, 2026
Description

Prerequisites:

  - > A Mule standalone server distribution file (e.g., a .zip or .tar.gz file).
  - > Access to Anypoint Platform with permissions to manage servers in Runtime Manager.


Step 1: Prepare the Mule Standalone Server

1.  Download and Unzip: Download the new Mule standalone server distribution.
      - Unzip the file to your desired location.
2.  Rename (Optional but Recommended): Rename the unzipped server directory to a unique, descriptive name (e.g., serverspaceRTM).

 

Step 2: Create a Server Entry in Runtime Manager

1.  Log in to Anypoint Platform.
2.  Navigate to Runtime Manager.
3.  Go to the Servers tab.
4.  Click "Add Server".
5.  Define a Unique Name: Enter a unique name for your server that matches the directory name or your naming convention. This name will be used to identify the server in the Runtime Manager UI.
6.  Upon saving, Runtime Manager will generate a pairing command. (Copy this command)

 

 

Step 3: Execute the Pairing Command

The command copied from Runtime Manager must be executed on the standalone server to pair it with the platform.

1.  Navigate to the /bin Directory: Open a terminal or command prompt and navigate to the server's /bin directory.
      Example: If your server directory is named mule-server-production-01, navigate to mule-server-production-01/bin.
2.  Paste and Execute the Command: Paste the copied pairing command into the terminal and press Enter.


Troubleshooting: The Authentication Error

If there is an error during the copy/paste process—such as extra white spaces, incorrect characters, or if the token is malformed — you will encounter an authentication failure.

Error Log Example (Incorrect Command/Token):


Communication between Anypoint Management Center and the Mule Agent is authorized by using two way SSL verification. In the following step we are 
going to create a keystore and request Anypoint Management Center to sign it. Your private key will never leave your machine.

    INFO: Configuring HTTP Client with no Proxy

Sending Sign request to Anypoint Management Center 
    ERROR: Could not authenticate with the provided token
 

Action to resolve:Make sure to copy the command rightly from Runtime Manager and re-execute it to pair the server correctly.

Successful Pairing Log:

When the command is copied and executed correctly, the terminal will show success logs, indicating that the Mule Agent has been configured and the pairing is complete.

 

Success Log Example (Correct Command/Token):


Communication between Anypoint Management Center and the Mule Agent is authorized by using two way SSL verification. In the following step we are 
going to create a keystore and request Anypoint Management Center to sign it. Your private key will never leave your machine.

    INFO: Configuring HTTP Client with no Proxy

Sending Sign request to Anypoint Management Center 
Mule Agent configured successfully
Mule Agent configuration saved successfully

Step 4: Manage the Server Runtime

Once the agent is configured successfully, the server will appear in the Servers tab of Runtime Manager. The server status will initially be Unregistered or Unknown. To make it Active, you must start the server.

  To start the Mule runtime:
  
    ./mule start
    
  To stop the Mule runtime:
    
    ./mule stop
    

Once the server is started, its status in Runtime Manager will change from created to Active and you can begin deploying applications.

Knowledge Article Number

005229026

 
Loading
Salesforce Help | Article