鸿蒙开发（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位。

自定义规则样例说明

正确的规则样例如下：

错误的规则用例如下：

示例

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 })