将Friend类添加到混乱的排除列表中

Question

我正在将Dotfuscator CE与Visual Studio 2015 Update 3一起使用，以模糊我的。Net组件。我们知道公共类型和成员在默认情况下不会被混淆。我很想知道我们如何在排除列表中添加朋友类，这样这些就不会被混淆了？

这是我用来混淆DLL的配置文件。

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE dotfuscator SYSTEM "http://www.preemptive.com/dotfuscator/dtd/dotfuscator_v2.3.dtd">
<dotfuscator version="2.3">
<propertylist>
<property name="SourceDirectory" value="This Path Will Be Replaced By Visual Studio" />
<property name="SourceFile" value="This Filename Will Be Replaced By Visual Studio" />
</propertylist>
<global>
<option>quiet</option>
</global>
<input>
<asmlist>
<inputassembly refid="e4ca1ab5-26cb-4ab7-9621-87063f75a38f">
<option>honoroas</option>
<option>stripoa</option>
<option>library</option>
<option>transformxaml</option>
<file dir="${SourceDirectory}" name="${SourceFile}" />
</inputassembly>
</asmlist>
</input>
<output>
<file dir="${SourceDirectory}" />
</output>
<renaming>
<option>xmlserialization</option>
<mapping>
<mapoutput overwrite="true">
<file dir="${SourceDirectory}Dotfuscated" name="Map.xml" />
</mapoutput>
</mapping>
<referencerulelist>
<referencerule rulekey="{6655B10A-FD58-462d-8D4F-5B1316DFF0FF}" />
<referencerule rulekey="{7D9C8B02-2383-420f-8740-A9760394C2C1}" />
<referencerule rulekey="{229FD6F8-5BCC-427b-8F72-A7A413ECDF1A}" />
<referencerule rulekey="{2B7E7C8C-A39A-4db8-9DFC-6AFD38509061}" />
<referencerule rulekey="{494EA3BA-B947-44B5-BEE8-A11CC85AAF9B}" />
<referencerule rulekey="{89769974-93E9-4e71-8D92-BE70E855ACFC}" />
<referencerule rulekey="{4D81E604-A545-4631-8B6D-C3735F793F80}" />
</referencerulelist>
</renaming>
<sos mergeruntime="true">
<option>version:v4</option>
<option>sendanalytics</option>
<option>dontsendtamper</option>
</sos>
<smartobfuscation>
<smartobfuscationreport verbosity="all" overwrite="false" />
</smartobfuscation>
</dotfuscator>

实际上，我有一个带有Friend访问说明符的Model类。我通过PostAsJsonAsync方法发布其对象，例如

Dim result As HttpResponseMessage = client.PostAsJsonAsync(APIEndPoints.LOGIN, _LoginModel).Result

这是朋友类：

Friend Class LoginModel
Public AccessKey As String
Public Password As String
End Class

接收请求和模型的API方法：

[HttpPost]
[Route("authenticate")]
public async Task<JsonResult> Authenticate([FromBody] LoginViewModel lvm)
// Here lvm.Accesskey is null

当API也接收到请求和LoginModel时，其字段为空。如果我公开我的LoginModel，那么它就可以工作了。注意：只有当我混淆DLL时才会发生这种情况，否则实现也可以使用Friend类。

另请注意：Friend类在VB.Net中很常见。当在程序集中访问时，它们的工作方式类似于公共类，但在程序集之外它们是私有的。

Answer 1

根据您的说明，听起来您不仅想排除Friend类型的名称，还想排除这些类型中Public字段的名称。我把你最初的问题解释为想排除任何标有"朋友"的内容，无论上下文如何。

这里的一个重要点是，根据Dotfuscator的规则，排除类型不会自动排除其成员。

这里有一个排除规则集，它排除了顶级Friend类型以及这些类型的Public和Friend字段：

<excludelist>
<type name=".*" regex="true" speclist="+notpublic">
<comment>Exclude top-level types that are only accessible to the assembly ("Friend" in VB, "internal" in C#, or "private" in IL).</comment>
<field name=".*" speclist="+public" regex="true">
<comment>Exclude public fields of types the parent rule matches</comment>
</field>
</type>
</excludelist>

您也可以只排除您知道重命名时会引起麻烦的类型和成员，而不是使用基于可访问性的规则排除大量名称。以下是一个示例，假设LoginModel是在程序集YourAssembly和命名空间YourNamespace.Here:中定义的

<excludelist>
<type name="YourAssembly.YourNamespace.Here.LoginModel">
<field name="AccessKey" signature="string" />
<field name="Password" signature="string" />
</type>
</excludelist>

(我注意到您对多个输入程序集使用了相同的配置，但该规则仍然是安全的，因为如果输入程序集不包含指定的类型，则该规则将被忽略。)

作为参考，关于排除规则的专业版文档(以及该页面的子主题)可能很有用——社区版和专业版共享相同的配置文件格式，用于两个版本都支持的功能。

披露：我在PreEmptive Solutions的Dotfuscator团队工作。

Answer 2

如果因为程序集有Friend assembly而试图排除输入程序集的Friend类型和成员，请注意Dotfuscator将自动从重命名中排除此类代码元素(Dotfusgator CE提供的唯一一种模糊处理)，并将发出以下警告：

警告：NameOfYourInputAssassembly具有非输入友元程序集，并且处于库模式；内部成员将不会被重命名或修剪。考虑添加Friend程序集作为输入以增加模糊处理。

(这里的术语"internal"相当于VB的"Friend"关键字的C#)。

正如警告所示，您可以将Friend Assembly作为Dotfuscator的另一个输入。如果这样做，Dotfuscator可以重命名Friend类型和成员，并更新Friend Assembly以使用新名称引用这些类型和成员。

---

如果您仍然想排除Friend类型和成员，可以使用以下重命名排除规则集来执行，该规则集作为配置文件中<renaming>标记的子项添加：

<excludelist>
<type name=".*" regex="true" speclist="+notpublic">
<comment>Exclude types that are only accessible to the assembly ("Friend" in VB, "internal" in C#, or "private" in IL).</comment>
</type>
<type name=".*" regex="true" speclist="+nestedassembly">
<comment>Exclude nested types that are only accessible to the assembly ("Friend" in VB, "internal" in C#, or "private" in IL).</comment>
</type>
<type name=".*" regex="true" excludetype="false">
<comment>Select, but do not exclude, all types.</comment>
<method name=".*" speclist="+assembly" regex="true">
<comment>Exclude methods that are only accessible to the assembly ("Friend" in VB, "internal" in C#, or "assembly" in IL).</comment>
</method>
<field name=".*" speclist="+assembly" regex="true">
<comment>Exclude fields that are only accessible to the assembly ("Friend" in VB, "internal" in C#, or "assembly" in IL).</comment>
</field>
<propertymember name=".*" speclist="+assembly" regex="true">
<comment>Exclude properties that are only accessible to the assembly ("Friend" in VB, "internal" in C#, or "assembly" in IL).</comment>
</propertymember>
<eventmember name=".*" speclist="+assembly" regex="true">
<comment>Exclude events that are only accessible to the assembly ("Friend" in VB, "internal" in C#, or "assembly" in IL).</comment>
</eventmember>
</type>
</excludelist>

编辑：我在这个答案的上一次修订中错过了嵌套类型

披露：我在PreEmptive Solutions的Dotfuscator团队工作。