鸿蒙开发（NEXT/API 12）【为应用添加自动生成高强度密码的建议】系统安全

在本文档中介绍的强密码特指，在密码保险箱强密码填充场景中，推荐用户使用的较强密码。强密码中一定包含大写字母、小写字母、数字三种字符。且强密码的复杂度高，破解难度大。

当开发者没有指定密码规则，或是开发者指定的规则书写错误、不符合规范时，密码保险箱会根据[默认的规则]生成符合开发者指定条件的强密码。开发者可以在允许的范围内指定强密码的规格。

默认强密码规则

当开发者没有指定规则，或是指定的密码规则不符合规范时，将按照以下默认规则生成强密码。

• 以字母开头。
• 包含大小写字母和数字。
• 长度为16位。

开发者可自定义的强密码规则

开发者可以设置新密码输入框的passwordRules属性来指定强密码规则。

强密码中一定包含大写字母、小写字母、数字三种字符。开发者可以按照以下指导对强密码规格做一些限定。

强密码规则包含3个属性：

3个属性可以任意选择，书写时顺序不做限制，属性之间以英文“，”进行分隔，每个属性只能出现一次。

说明

各属性段请严格参照介绍进行书写，否则将导致指定规则不生效。

• "begin "

  表示生成的强密码首位的字符类型，可选的值如下表所示。可以缺省，但不能填入其他值，填入其他值按照缺省规则处理。

  取值	说明
  upper	以大写字母开头。
  lower	以小写字母开头。
  digit	以数字开头。
  不填	不填时，将以任意字母或数字0-9开头。

  格式举例：

  begin:[upper]
  

• "special "

  表示生成的强密码是否可以包含特殊字符。需要包含特殊字符时，请将该字段设置为"yes"；如不需要，不填写"special"字段。

  当设置为"yes"时，生成的强密码中将包含至少一个特殊字符，特殊字符不会出现在强密码的首位。

  强密码中可能出现的特殊字符包括：!@#$%^&*

  格式举例：

  special:[yes]
  

• “len”

  表示生成的强密码长度。密码保险箱允许设定的强密码长度最小12位，最大32位。

  强密码长度属性提供三个关键字用于描述长度。

  关键字	说明
  fixedlen	固定长度
  minlen	最小长度
  maxlen	最大长度

  开发者可以根据以下方式指定强密码长度。如果开发者指定的密码长度数值不在有效范围[12, 32]内，将视为非法指定，系统将使用默认长度16位替代。

  1. 仅设置固定长度fixedlen，此时强密码长度为fixedlen设置值。

     len:[fixedlen:16]
     

  2. 仅设置最小长度minlen，此时强密码长度随机，最小长度为minlen设置值，最大为默认值32位。

     len:[minlen:15]
     

  3. 仅设置最大长度maxlen，此时强密码长度随机，最小长度为默认值12位，最大为maxlen设置值。

     len:[maxlen:28]
     

  4. 同时设置最大长度maxlen和最小长度minlen。设置时，minlen的值必须小于maxlen的值。此时强密码长度随机，最小长度为minlen设置值，最大为maxlen设置值。

     len:[minlen:13,maxlen:18]
     

  5. 若不指定len属性，强密码长度默认为16位。

自定义规则样例说明

正确的规则样例如下：

强密码规则样例	规则释义
begin:[upper],special:[yes],len:[maxlen:32,minlen:12]	以大写字母开头，包含大小写字母、数字、特殊字符，长度为12-32之间（包含12和32）的随机数值。
begin:[lower],special:[yes],len:[maxlen:14]	以小写字母开头，包含大小写字母、数字、特殊字符，长度为14-32之间（包含14和32）的随机数值。
begin:[digit],special:[yes],len:[fixedlen:15]	以数字开头，包含大小写字母、数字、特殊字符，长度为15。
begin:[upper]	以大写字母开头，包含大小写字母、数字，长度为16。
special:[yes]	以任意字母或数字开头，包含大小写字母、数字、特殊字符，长度为16。
len:[fixedlen:15]	以任意字母或数字开头，包含大小写字母、数字，长度为15。
begin:[upper],special:[yes]	以大写字母开头，包含大小写字母、数字、特殊字符,长度为16。
begin:[lower],len:[maxlen:25,minlen:12]	以小写字母开头，包含大小写字母、数字，长度为12-25之间（包含12和25）的随机数值。
special:[yes],len:[fixedlen:15]	以任意字母或数字开头，包含大小写字母、数字、特殊字符，长度为15。

错误的规则用例如下：

强密码规则错误用例	错误原因
begin:[uppper]	begin属性的取值upper拼写错误。
began:[upper]	begin属性拼写错误。
len:[15]	len属性语法错误，未使用三种长度关键词。
len:[fixedlen:15,maxlen:18]	len属性语法错误，fixedlen与maxlen不可混用。
len:[maxlen:15,minlen:18]	len属性参数值错误，maxlen的取值不能小于minlen。

示例

TextInput({ placeholder: '新密码' }).enableAutoFill(true).type(InputType.NEW_PASSWORD).passwordRules('begin:[lower],special:[yes],len:[maxlen:32,minlen:12]').placeholderColor(0x182431).width('100%').opacity(0.6).showPasswordIcon(true).placeholderFont({ size: 16, weight: FontWeight.Regular }).margin({ bottom: 36 })