扩展账户信息合规度校验规则

SuperMap iServer 提供了扩展账户信息合规度校验规则的能力，您可以灵活定制满足自身项目需求的用户名、密码合规度校验规则，用于校验您创建的账户信息是否合规。您需要通过修改配置文件的方式来扩展定制用户名、密码校验规则，填写内容包括用于合规度校验的正则表达式、字典或字符串，以及校验失败时提示的报错信息等。

配置文件介绍

在产品包根目录 %SuperMap iServer_HOME%/webapps/iserver/WEB-INF/config下，accountInfoComplianceRules.xml 文件中内置了 SuperMap iServer 当前已经支持的账户信息合规度校验规则。其中，密码规则详见：用户管理

配置文件根节点为<rules>元素，包括以下两个子节点：

1. <passwordRules>节点

为用于配置密码合规度校验规则的集合，可以包含多个<rule>标签。每个<rule>标签对应一种密码合规度校验规则，包含合规度规则的校验方式（<type>）、规则名（<name>）、规则表达式（<expression>）、中文报错信息（<zhErrMsg>）以及英文报错信息（<enErrMsg>）等配置项。

<passwordRules>节点示例如下所示：

<passwordRules>

        <rule>

            <type>regularExpression</type>

            <name>PwdLength</name>

            <expression><![CDATA[\S{8,}]]></expression>

            <zhErrMsg>密码长度至少为8字符</zhErrMsg>

            <enErrMsg>Password must contain at least 8 characters</enErrMsg>

        </rule>

        <rule>

            <type>dictionary</type>

            <name>NotContainsContinuationCharacter</name>

            <expression>

                <condition>notcontainscontinuouschars,3</condition>

                <dictionary>abcdefghijklmnopqrstuvwxyz</dictionary>

                <dictionary>ABCDEFGHIJKLMNOPQRSTUVWXYZ</dictionary>

                <dictionary>0123456789</dictionary>

            </expression>

            <zhErrMsg>密码不能包含三个或三个以上连续字符</zhErrMsg>

            <enErrMsg>Password can’t contain three or more continuous characters and numbers</enErrMsg>

        </rule>

        <rule>

            <type>StringMatch</type>

            <name>notContainsUsernameAndReverse</name>

            <expression>

                <condition>notcontainsextraparamsandreverse</condition>

                <paramContent>${username}</paramContent>

            </expression>

            <zhErrMsg>密码不能包含用户名及其倒写</zhErrMsg>

            <enErrMsg>Pasword can't contain the user name and its reverse</enErrMsg>

        </rule>

</passwordRules>

其中，

• <type>：用于设置校验合规度规则的方式，包括正则表达式（regularExpression）、字典（dictionary）和字符串匹配（StringMatch）等三种类型。
• <name>：用于设置合规度规则的规则名。
• <expression>：用于设置合规度规则的表达式。当<type>为正则表达式（regularExpression）时设置描述合规度规则的正则表达式，并且没有子节点；为字典（dictionary）和字符串匹配（StringMatch）时，包括如下子节点：

• <condition>：用于设置合规度规则的匹配条件。当<type>为字典（dictionary）时，需根据规则设置与字典的关联条件及与字典关联的字符个数，用“,”连接（例如：notcontainscontinuouschars,3）；当<type>为字符串匹配（StringMatch）时，需根据规则设置与字符串的关联条件，如：notcontainsextraparamsandreverse。

请注意，当前仅支持在<type>为字典（dictionary）时设置不包含连续字符（notcontainscontinuouschars）和在<type>为字符串匹配（StringMatch）时设置不包含字符及其倒写（notcontainsextraparamsandreverse）两种关联条件。

• <dictionary>：用于设置合规度规则的关联字典。当<type>为字典（dictionary）时，该参数可选。在同一个<expression>节点中，可设置多个<dictionary>。
• <paramContent>：用于设置合规度规则的关联字符串。当<type>为字符串匹配（StringMatch）时，该参数可选。在同一个<expression>节点中，仅可设置一个<paramContent>，且<paramContent>中只能包含一个字符串，例如填写为 test。

请注意，在配置文件内置的规则中，${username} 指用户设置的用户名字符，该配置仅能作为整体使用或替换。

• <zhErrMsg>：用于设置校验合规度规则时失败时的中文提示信息。
• <enErrMsg>：用于设置校验合规度规则时失败时的英文提示信息。

2. <usernameRules>节点

为用于配置用户名合规度校验规则的集合，可以包含多个<rule>标签。每个<rule>标签对应一种用户名合规度校验规则，包含合规度规则的校验方式（<type>）、规则名（<name>）、规则表达式（<expression>）、中文报错信息（<zhErrMsg>）以及英文报错信息（<enErrMsg>）等配置项。

<usernameRules>节点配置方法同<passwordRules>节点，示例如下所示：

<usernameRules>

        <rule>

            <type>regularExpression</type>

            <name>UsernameLength</name>

            <expression><![CDATA[^[a-zA-Z][a-zA-Z0-9_-]{3,17}$]]></expression>

            <zhErrMsg>用户名必须是数字、字母、下划线或中划线组成，且以字母开头</zhErrMsg>

            <enErrMsg>User name must be composed of numbers, letters, underscores or dash, and begin with a letter.</enErrMsg>

        </rule>

</usernameRules>

扩展和配置流程

根据实际项目中的需求，您可以对 SuperMap iServer 中已经提供的账户信息合规度校验规则进行修改或者删除，也可以添加新的账户信息合规度校验规则进行扩展。支持扩展的规则包括用户名和密码的位数和字符组成限制，可以使用的校验规则方式及关联条件请参考：<passwordRules>节点

我们通过在配置文件中添加节点的方式实现一个简单的扩展来说明扩展和配置流程，以扩展密码合规度校验规则“密码不能包含两个或两个以上竖排连续的字符”为例。

1、配置文件设置

在产品包根目录 %SuperMap iServer_HOME%webapps/iserver/WEB-INF/config 下，accountInfoComplianceRules.xml 文件的子节点<passwordRules>中添加如下内容：

<passwordRules>

        …

    <rule>

        <type>dictionary</type>

        <name>NotContainsKeyboardVerticalContinuationCharacter</name>

        <expression>

            <condition>notcontainscontinuouschars,2</condition>

            <dictionary>1qaz</dictionary>

            <dictionary>2wsxl</dictionary>

             …

            <dictionary>9ol.</dictionary>

        </expression>

        <zhErrMsg>根据键盘阵列，密码不能包含两个或两个以上竖排连续的字符</zhErrMsg>

        <enErrMsg>Password can’t contain two or more continuous vertical characters on the keyboard</enErrMsg>

    </rule>

</passwordRules>

由于该规则涉及多个字符，且无法使用正则表达式进行表达，因此使用字典的方式进行校验。参考<passwordRules>节点中对配置项的介绍进行设置，其中<dictionary>参数仅列出三组，您可以根据实际情况进行补充设置。

2、查看扩展结果

当完成以上配置后，表示已经成功添加了密码合规度校验规则“密码不能包含两个或两个以上竖排连续的字符”。保存配置文件并重启 SuperMap iServer，在初始化向导-创建管理员账户、用户管理-添加用户、账户设置-修改密码和强制修改密码等功能中设置密码，即可对输入的密码进行该项合规度规则校验。

注：若对管理员账户密码进行重置，需在重启 SuperMap iServer 前，停止 SuperMap iServer 服务，并执行【SuperMap iServer_HOME】\bin目录下的 passwordreset.bat/passwordreset.sh 文件。