runtime-v2: add option to mark strings as sensitive using "mask" function

Author: ibodrov

runtime/v2/runner-test/src/test/java/com/walmartlabs/concord/runtime/v2/runner/MainTest.java

@@ -1760,6 +1760,17 @@ public void prefixedFunctionsInExpressions() throws Exception {
         assertLog(runtime.allLogs(), ".*Hello, world!.*");
     }
 
+    @Test
+    public void maskFunction() throws Exception {
+        deploy("maskFunction");
+
+        save(ProcessConfiguration.builder().build());
+
+        run();
+
+        assertLog(runtime.allLogs(), ".*" + Pattern.quote("The '******' is masked now") + ".*");
+    }
+
     private void deploy(String name) throws URISyntaxException, IOException {
         runtime.deploy(name);
     }

runtime/v2/runner-test/src/test/java/com/walmartlabs/concord/runtime/v2/runner/functions/TestFunction.java

@@ -1,5 +1,25 @@
 package com.walmartlabs.concord.runtime.v2.runner.functions;
 
+/*-
+ * *****
+ * Concord
+ * -----
+ * Copyright (C) 2017 - 2025 Walmart Inc.
+ * -----
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ * =====
+ */
+
 import com.walmartlabs.concord.runtime.v2.sdk.ELFunction;
 
 import javax.inject.Named;

runtime/v2/runner-test/src/test/resources/com/walmartlabs/concord/runtime/v2/runner/maskFunction/concord.yml

@@ -0,0 +1,6 @@
+flows:
+  default:
+    - set:
+        regularValue: "regularValue"
+        secretValue: "${mask(regularValue)}"
+    - log: "The 'regularValue' is masked now"

runtime/v2/runner/src/main/java/com/walmartlabs/concord/runtime/v2/runner/el/functions/MaskFunction.java

@@ -0,0 +1,59 @@
+package com.walmartlabs.concord.runtime.v2.runner.el.functions;
+
+/*-
+ * *****
+ * Concord
+ * -----
+ * Copyright (C) 2017 - 2025 Walmart Inc.
+ * -----
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ * =====
+ */
+
+import com.walmartlabs.concord.runtime.v2.sdk.ELFunction;
+import com.walmartlabs.concord.runtime.v2.sdk.SensitiveDataHolder;
+
+import javax.inject.Inject;
+
+import static java.util.Objects.requireNonNull;
+
+public class MaskFunction {
+
+    private static SensitiveDataHolder sensitiveData;
+
+    @Inject
+    public MaskFunction(SensitiveDataHolder sensitiveData) {
+        MaskFunction.sensitiveData = requireNonNull(sensitiveData);
+    }
+
+    @ELFunction
+    public static String mask(Object v) {
+        if (MaskFunction.sensitiveData == null) {
+            throw new IllegalStateException("MaskFunction must be initialized first");
+        }
+
+        if (v == null) {
+            return null;
+        }
+
+        if (v instanceof String s) {
+            if (s.isBlank()) {
+                return s;
+            }
+            sensitiveData.add(s);
+            return s;
+        }
+
+        throw new IllegalArgumentException("Only string values can be masked. Got a " + v.getClass());
+    }
+}

runtime/v2/runner/src/main/java/com/walmartlabs/concord/runtime/v2/runner/guice/ExpressionSupportModule.java

@@ -27,9 +27,9 @@
 import com.google.inject.spi.TypeEncounter;
 import com.google.inject.spi.TypeListener;
 import com.walmartlabs.concord.runtime.v2.runner.el.DefaultExpressionEvaluator;
-import com.walmartlabs.concord.runtime.v2.sdk.ELFunction;
 import com.walmartlabs.concord.runtime.v2.runner.el.FunctionHolder;
 import com.walmartlabs.concord.runtime.v2.runner.el.functions.*;
+import com.walmartlabs.concord.runtime.v2.sdk.ELFunction;
 import com.walmartlabs.concord.runtime.v2.sdk.ExpressionEvaluator;
 
 import java.lang.reflect.Modifier;
@@ -84,6 +84,7 @@ public <I> void hear(TypeLiteral<I> type, TypeEncounter<I> encounter) {
         binder.bind(HasVariableFunction.class).asEagerSingleton();
         binder.bind(IsDebugFunction.class).asEagerSingleton();
         binder.bind(IsDryRunFunction.class).asEagerSingleton();
+        binder.bind(MaskFunction.class).asEagerSingleton();
         binder.bind(OrDefaultFunction.class).asEagerSingleton();
         binder.bind(ThrowFunction.class).asEagerSingleton();
         binder.bind(UuidFunction.class).asEagerSingleton();