Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

DangerousThrowableMessageSafeArg disallows Throwables #997

Merged
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@
import com.google.errorprone.bugpatterns.BugChecker;
import com.google.errorprone.matchers.Description;
import com.google.errorprone.matchers.Matcher;
import com.google.errorprone.matchers.Matchers;
import com.google.errorprone.matchers.method.MethodMatchers;
import com.sun.source.tree.ExpressionTree;
import com.sun.source.tree.MethodInvocationTree;
Expand All @@ -43,30 +44,36 @@ public final class DangerousThrowableMessageSafeArg extends BugChecker

private static final Matcher<ExpressionTree> SAFEARG_FACTORY_METHOD = MethodMatchers.staticMethod()
.onClass("com.palantir.logsafe.SafeArg")
.named("of");
.named("of")
.withParameters(String.class.getName(), Object.class.getName());

private static final Matcher<ExpressionTree> THROWABLE_MESSAGE_METHOD = MethodMatchers.instanceMethod()
.onDescendantOf(Throwable.class.getName())
.named("getMessage");

private static final Matcher<ExpressionTree> THROWABLE_MATCHER = Matchers.isSubtypeOf(Throwable.class);

@Override
public Description matchMethodInvocation(MethodInvocationTree tree, VisitorState state) {
if (!SAFEARG_FACTORY_METHOD.matches(tree, state)) {
return Description.NO_MATCH;
}

List<? extends ExpressionTree> args = tree.getArguments();
if (args.size() != 2) {
return Description.NO_MATCH;
}

ExpressionTree safeValueArgument = args.get(1);
if (THROWABLE_MESSAGE_METHOD.matches(safeValueArgument, state)) {
return buildDescription(tree)
.setMessage("Do not use throwable messages as SafeArg values. "
+ "SafeLoggable.getLogMessage is guaranteed to be safe.")
.build();
}
if (THROWABLE_MATCHER.matches(safeValueArgument, state)) {
return buildDescription(tree)
.setMessage("Do not use throwables as SafeArg values. "
+ "Throwables must be logged without an Arg wrapper as the last parameter, otherwise "
+ "unsafe data may be leaked from the unsafe message or the unsafe message of a cause.")
.build();
}
return Description.NO_MATCH;
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -63,4 +63,17 @@ public void safe_safearg_value() {
"}").doTest();
}

@Test
public void unsafe_safearg_throwable() {
compilationHelper.addSourceLines(
"Bean.java",
"import " + SafeIllegalArgumentException.class.getName() + ';',
"import " + SafeArg.class.getName() + ';',
"class Bean {",
" public SafeArg<?> foo() {",
" // BUG: Diagnostic contains: Do not use throwables as SafeArg values",
" return SafeArg.of(\"foo\", new SafeIllegalArgumentException(\"Foo\"));",
" }",
"}").doTest();
}
}
7 changes: 7 additions & 0 deletions changelog/@unreleased/pr-997.v2.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
type: improvement
improvement:
description: |-
DangerousThrowableMessageSafeArg disallows Throwables in SafeArg values.
Throwables must be logged without an Arg wrapper as the last parameter, otherwise unsafe data may be leaked from the unsafe message or the unsafe message of a cause.
links:
- https://github.com/palantir/gradle-baseline/pull/997