Add taint-tracking for package net/mail

Author: gagliardetto

ql/src/semmle/go/frameworks/Stdlib.qll

@@ -32,6 +32,7 @@ import semmle.go.frameworks.stdlib.HtmlTemplate
 import semmle.go.frameworks.stdlib.Net
 import semmle.go.frameworks.stdlib.NetHttp
 import semmle.go.frameworks.stdlib.NetHttpHttputil
+import semmle.go.frameworks.stdlib.NetMail
 import semmle.go.frameworks.stdlib.Path
 import semmle.go.frameworks.stdlib.PathFilepath
 import semmle.go.frameworks.stdlib.Reflect

ql/src/semmle/go/frameworks/stdlib/NetMail.qll

@@ -0,0 +1,54 @@
+/**
+ * Provides classes modeling security-relevant aspects of the `net/mail` package.
+ */
+
+import go
+
+/** Provides models of commonly used functions in the `net/mail` package. */
+module NetMail {
+  private class FunctionModels extends TaintTracking::FunctionModel {
+    FunctionInput inp;
+    FunctionOutput outp;
+
+    FunctionModels() {
+      // signature: func ParseAddress(address string) (*Address, error)
+      hasQualifiedName("net/mail", "ParseAddress") and
+      (inp.isParameter(0) and outp.isResult(0))
+      or
+      // signature: func ParseAddressList(list string) ([]*Address, error)
+      hasQualifiedName("net/mail", "ParseAddressList") and
+      (inp.isParameter(0) and outp.isResult(0))
+      or
+      // signature: func ReadMessage(r io.Reader) (msg *Message, err error)
+      hasQualifiedName("net/mail", "ReadMessage") and
+      (inp.isParameter(0) and outp.isResult(0))
+    }
+
+    override predicate hasTaintFlow(FunctionInput input, FunctionOutput output) {
+      input = inp and output = outp
+    }
+  }
+
+  private class MethodModels extends TaintTracking::FunctionModel, Method {
+    FunctionInput inp;
+    FunctionOutput outp;
+
+    MethodModels() {
+      // signature: func (*AddressParser).Parse(address string) (*Address, error)
+      this.hasQualifiedName("net/mail", "AddressParser", "Parse") and
+      (inp.isParameter(0) and outp.isResult(0))
+      or
+      // signature: func (*AddressParser).ParseList(list string) ([]*Address, error)
+      this.hasQualifiedName("net/mail", "AddressParser", "ParseList") and
+      (inp.isParameter(0) and outp.isResult(0))
+      or
+      // signature: func (Header).Get(key string) string
+      this.hasQualifiedName("net/mail", "Header", "Get") and
+      (inp.isReceiver() and outp.isResult())
+    }
+
+    override predicate hasTaintFlow(FunctionInput input, FunctionOutput output) {
+      input = inp and output = outp
+    }
+  }
+}