Yuan's SOA Blog

Mule ESB uses Java properties file to set the dynamic properties for application. We all know we need to encrypt passwords in the property files. I know two ways to encrypt properties with Mule ESB.

One is to use Mule Enterprise Security module

https://developer.mulesoft.com/docs/display/current/Installing+Anypoint+Enterprise+Security I have posted step by step instructions here: http://blogs.perficient.com/integrate/2016/05/16/mule-enterprise-security-password-encryption-steps/

The other one is Jasypt

http://blogs.mulesoft.com/dev/mule-dev/encrypting-passwords-in-mule/

This post will follow the above blog and show an end to end example of Jasypt with full sample code. I’ll cover the other method in a different post.

Let’s get started.

Step 1. Create a Hello World Application

<http:listener-config name="HTTP_Listener_Configuration" host="0.0.0.0" port="8081" doc:name="HTTP Listener Configuration"/>

<http:listener config-ref="HTTP_Listener_Configuration" path="/enc" doc:name="HTTP"/>

<expression-filter expression="#[message.inboundProperties.'http.request.uri' != '/favicon.ico']" doc:name="Filter favicon" />

<set-payload value="Hello World" doc:name="Set Payload"/>

</flow>

Do a quick test to make yourself feel good.

Step 2. Mavenize the project

Right click on the project name, move to “Maven support in studio”, then select “Mavenize”

This will create a pom.xml for you.

I would like to point out, if you are not happy at any point with your Maven pom.xml, you can chose to delete pom.xml (backup if needed), and then re-run the above step to Mavenize it again.

Step 3. Add a property file to the project

The default property file is my-app.properties. But you should create your own under "src/main/resources". Let’s create “enc.properties” over there.

p1=hello

p2=world

p3=welcome1

p4=foo

Let’s change the flow

<set-payload value="Here are the parameters p1=${p1} p2=${p2} p3=${p3} p4=${p4}" doc:name="Set Payload"/>

If you test the program, it may not pick up those properties. If that’s the case, add this line right above the flow

<context:property-placeholder location="enc.properties" />

Test it again, you should see “Here are the parameters p1=hello p2=world p3=welcome1 p4=foo”. If not, try to re-generate the pom.xml again. Hope that solves your problem.

Step 4. Add Jasypt dependency to pom

<groupId>org.jasypt</groupId>

<artifactId>jasypt-spring3</artifactId>

</dependency>

Step 5. Add the spring bean section from this post http://blogs.mulesoft.com/dev/mule-dev/encrypting-passwords-in-mule/

<spring:beans>

<spring:bean id="environmentVariablesConfiguration" class="org.jasypt.encryption.pbe.config.EnvironmentStringPBEConfig">

<spring:property name="algorithm" value="PBEWithMD5AndDES"/>

<spring:property name="password" value="mypass"/>

</spring:bean>

<spring:bean id="configurationEncryptor" class="org.jasypt.encryption.pbe.StandardPBEStringEncryptor">

<spring:property name="config" ref="environmentVariablesConfiguration"/>

</spring:bean>

<spring:bean id="propertyConfigurer" class="org.jasypt.spring.properties.EncryptablePropertyPlaceholderConfigurer">

<spring:constructor-arg ref="configurationEncryptor"/>

<spring:property name="locations">

<spring:list>

<spring:value>enc.properties</spring:value>

</spring:list>

</spring:property>

</spring:bean>

</spring:beans>

Please note 1) I commented out the above “property-placeholder” line. Spring bean we are adding should be sufficient to make the applicaiton include the property file. 2) I have put enc.properties in the “locations” section. 3) I commented out “passwordEnvName”, and added “password” property. I’ll explain 3) later.

If the compiler whines, you may consider re-generating the pom again, remember to put Jasypt dependency back in if you ended up regenerating the POM file.

If everything works, your application should work exactly like before. If not, then you may need to

stop the application if you are running inside the studio, and re-run it again. Sometimes, the property file change is not picked up properly without restarting the application.

Step 6. Encrypt the Parameters

In command window, run this (you need to pick your own path to the “jasypt” jar file):

java -cp C:\m2\repository\org\jasypt\jasypt\1.9.1\jasypt-1.9.1.jar org.jasypt.intf.cli.JasyptPBEStringEncryptionCLI input="hello" password="mypass" algorithm=PBEWithMD5AndDES

Run the same command for “world”, “welcome1”.

You should have 3 encrypted string for “hello”, “world”, “welcome1” . Put them in the property file like below, the encrypted strings are inside ENC():

p1=ENC(jDkJK7Ns+OJCRXAZ+7kcUA==)

p2=ENC(eMgHrLD5bPQrVEhu4yOaZw==)

p3=ENC(ennXknKsiEUhAO1a4rpuMXonJ94Nooa1)

p4=foo

Now re-run the program again, you should get the same result. This illustrates that the encryption/decryption is working properly.

Step 7. Wrap it up (using environment variable to keep your master password)

I have copied the final finished source code at the end.

A few notes here:

1 In the previous step, I used “password” property to test the encryption/decryption without using the environment variable

2 In the final code, I have removed (commented out) the “password” property and put back in “passwordEnvName” property, in this case, it is called “MULE_ENCRYPTION_PASSWORD”. This is telling you that you need to setup an environment variable “MULE_ENCRYPTION_PASSWORD” with the value “mypass”.

3 After you setup environment variable, you may need to restart the studio, so it can pick up the environment variable (if you are running standalone Mule ESB, you may need to close that command window and start a new command window, then restart Mule ESB)

Is it safe to use the env varialbe to keep the password? Well, password need be specified by the admin, it has to be somewhere. As explained in the other posts, you can setenv right before you start the server,then unset the env varialbe right after the server is started.

That should be it!

<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:context="http://www.springframework.org/schema/context"

xmlns:http="http://www.mulesoft.org/schema/mule/http" xmlns="http://www.mulesoft.org/schema/mule/core" xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"

xmlns:spring="http://www.springframework.org/schema/beans" version="EE-3.7.0"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="

http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-current.xsd http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-current.xsd

http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd

http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd">

<spring:beans>

<spring:bean id="environmentVariablesConfiguration" class="org.jasypt.encryption.pbe.config.EnvironmentStringPBEConfig">

<spring:property name="algorithm" value="PBEWithMD5AndDES"/>

<spring:property name="passwordEnvName" value="MULE_ENCRYPTION_PASSWORD"/>

</spring:bean>

<spring:bean id="configurationEncryptor" class="org.jasypt.encryption.pbe.StandardPBEStringEncryptor">

<spring:property name="config" ref="environmentVariablesConfiguration"/>

</spring:bean>

<spring:bean id="propertyConfigurer" class="org.jasypt.spring.properties.EncryptablePropertyPlaceholderConfigurer">

<spring:constructor-arg ref="configurationEncryptor"/>

<spring:property name="locations">

<spring:list>

<spring:value>enc.properties</spring:value>

</spring:list>

</spring:property>

</spring:bean>

</spring:beans>

<http:listener-config name="HTTP_Listener_Configuration" host="0.0.0.0" port="8081" doc:name="HTTP Listener Configuration"/>

<http:listener config-ref="HTTP_Listener_Configuration" path="/enc" doc:name="HTTP"/>

<expression-filter expression="#[message.inboundProperties.'http.request.uri' != '/favicon.ico']" doc:name="Filter favicon" />

<set-payload value="Here are the parameters p1=${p1} p2=${p2} p3=${p3} p4=${p4}" doc:name="Set Payload"/>

</flow>

</mule>

For the sake of completeness, I am including the pom.xml as well, which really doesn’t have anything special:

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">

<groupId>com.mycompany</groupId>

<artifactId>encrypt</artifactId>

<version>1.0.0-SNAPSHOT</version>

<name>Mule encrypt Application</name>

<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>

<mule.version>3.7.0</mule.version>

<mule.tools.version>1.1</mule.tools.version>

</properties>

<build>

<groupId>org.mule.tools.maven</groupId>

<artifactId>mule-app-maven-plugin</artifactId>

<version>${mule.tools.version}</version>

</configuration>

</plugin>

<artifactId>maven-assembly-plugin</artifactId>

<descriptorRef>project</descriptorRef>

</descriptorRefs>

</configuration>

</plugin>

<groupId>org.codehaus.mojo</groupId>

<artifactId>build-helper-maven-plugin</artifactId>

<id>add-resource</id>

<phase>generate-resources</phase>

<goals>

<goal>add-resource</goal>

</goals>

</resource>

<directory>mappings/</directory>

</resource>

</resources>

</configuration>

</execution>

</executions>

</plugin>

</plugins>

</build>

<groupId>org.jasypt</groupId>

<artifactId>jasypt-spring3</artifactId>

</dependency>

<groupId>com.mulesoft.muleesb</groupId>