iOS Password AutoFill

级别：★☆☆☆☆
标签：「iOS」「Password AutoFill」
作者： WYW
审校： QiShare团队

前言 Password AutoFill 是iOS11及之后苹果官方推出的新功能，可用于注册的时候自动生成密码，登录成功之后保存帐号、密码，相关帐号密码会保存在iCloud的KeyChain中，下次登录的时候，可以填充已存储的帐号密码，可以自动填充短信验证码。可以简化使用App 和网页登录和启动流程。原生端的UITextField和UITextView都可以做相关配置。我们在Safari浏览器中登录成功后保存的密码，在App中，也可以自动填充帐号密码。

一、Password AutoFill准备工作

项目配置

Xcode配置

TARGETS -> Signing & Capabilities -> Associated Domains：添加如：webcredentials:你的域名

服务端配置

在服务端这个路径下添加apple-app-site-association的文件，文件内容为如下json内容。

{ 
    "webcredentials": { 
        "apps": ["teamID.bundleID"]  
    } 
}

检验方式

简单校验方式：访问 https://你的域名/.well-known/apple-app-site-association 可以访问到相应文件。

二、注册提示、填充强密码

UITextField或UITextView 配置用户名、密码文本内容类型。

如果我们想要用户在注册的时候，给用户一个自动生成密码的选择。可以使用 passwordTextField.textContentType = UITextContentTypeNewPassword; 指定自动填充密码。

效果图

01register.PNG

代码

accountTextField.textContentType = UITextContentTypeUsername;
accountTextField.keyboardType = UIKeyboardTypeEmailAddress;

passwordTextField.textContentType = UITextContentTypeNewPassword;
passwordTextField.secureTextEntry = YES;

UITextContentTypeUsername 及 UITextContentTypeNewPassword 适用于系统版本大于等于 iOS11的设备。

UIKIT_EXTERN UITextContentType const UITextContentTypeUsername                  API_AVAILABLE(ios(11.0));
UIKIT_EXTERN UITextContentType const UITextContentTypePassword                  API_AVAILABLE(ios(11.0));

我们可以对密码填充规则有我们自己的规则，可以使用 UITextInputPasswordRules 配置密码填充规则。

// 配置密码规则
passwordTextField.passwordRules = [UITextInputPasswordRules passwordRulesWithDescriptor:@"required: lower; required: upper; required: digit; required: [-]; required: [&]; required: [+]; minlength: 20;"];

上述密码输入框的密码填充规则为，生成的密码需要满足含小写、大写字母，数字、 -、&、+的条件，且最小长度为20位。更多相关内容可查看密码验证工具。

UITextInputPasswordRules 适用于系统版本大于等于 iOS12的设备。

UIKIT_EXTERN API_AVAILABLE(ios(12.0)) @interface UITextInputPasswordRules : NSObject <NSSecureCoding, NSCopying>

遇到问题

问题1：iCloud Keychain is disabled

[AutoFill] Cannot show Automatic Strong Passwords for app bundleID: bundleID内容 due to error: iCloud Keychain is disabled

上述报错是因为iCloud 的 Keychain没有打开。

处理方式为：设置 iCloud 钥匙串设置 -> 点击名字 -> 点击iCloud -> 点击钥匙串 -> 打开。

三、登录提示、填充已存储帐号密码

当我们想要保存帐号、密码的时候需要配置。帐号、密码输入框相应的textContentType。

效果图

键盘上方的QuickTypeBar 显示小钥匙

02login.PNG

显示已经存储过的帐号密码

03loginPresent.PNG

登录成功后系统自动存储密码

05savePassword.PNG

修改已存登录帐号密码

06updatePassword.PNG

代码

accountTextField.textContentType = UITextContentTypeUsername;
accountTextField.keyboardType = UIKeyboardTypeEmailAddress;

passwordTextField.textContentType = UITextContentTypePassword;
passwordTextField.secureTextEntry = YES;

UITextContentTypeUsername、UITextContentTypePassword 适用于系统版本大于等于 iOS11的设备。

UIKIT_EXTERN UITextContentType const UITextContentTypeUsername                  API_AVAILABLE(ios(11.0));
UIKIT_EXTERN UITextContentType const UITextContentTypePassword                  API_AVAILABLE(ios(11.0));

配置了如上代码后，就会在点击密码输入框的时候，显示钥匙图标，点击要是图标后，就会显示出已存储的帐号密码。并且，只要移除自己的登录页面的时候，系统就会自动弹出存储或修改帐号密码的弹框。

遇到问题

问题1：不显示密码填充的小钥匙。

解决方法：开启自动填充密码：设置 -> 密码与帐户 -> 打开自动填充密码

问题2：登录成功后，没有显示存储密码，修改密码系统弹框。

解决办法：目前笔者在iOS13.0 的iPhone6s的设备上测试发现弹框显示与否和 accountTextField.keyboardType = UIKeyboardTypeEmailAddress; 有关，大家如果遇到登录成功后，没有显示存储密码弹框的问题，可以设置需要的keyboardText的类型试试看。

四、修改密码

修改密码的时候也可以使用，自动填充验证的短信（点击键盘上的Quick TypeBar，验证码自动填充如输入框），及要使用的自动生成的密码。

效果图

键盘上方的QuickTypeBar显示当前收到的短信

04modifyPassword.PNG

代码

accountTextField.textContentType = UITextContentTypeUsername;
passwordTextField.textContentType = UITextContentTypeNewPassword;
smsCodeTextField.textContentType = UITextContentTypeOneTimeCode;

UITextContentTypeNewPassword、UITextContentTypeOneTimeCode 适用于系统版本大于等于 iOS12的设备。

UIKIT_EXTERN UITextContentType const UITextContentTypeNewPassword               API_AVAILABLE(ios(12.0));
UIKIT_EXTERN UITextContentType const UITextContentTypeOneTimeCode               API_AVAILABLE(ios(12.0));

五、其他

添加帐号密码

设置 -> 密码与帐户 -> 网站与App密码：添加帐号密码

根据网站、用户名、密码添加新的帐号密码。

添加完毕后，在自动填充密码的登录页面，可供选择填充新增的用户名密码。

关于WebView相关的内容

关于WebView相关的内容，敬请查看 Enabling Password AutoFill on an HTML Input Element

和ASPasswordCredential的授权方法有关联

以前做苹果登录Sign In With Apple（一），登录成功的时候会调用如下授权成功的方法。

其中，我们的自动填充密码，填充成功后，会调用到如下方法的ASPasswordCredential类型分支部分。

- (void)authorizationController:(ASAuthorizationController *)controller didCompleteWithAuthorization:(ASAuthorization *)authorization  API_AVAILABLE(ios(13.0)) {
    
    if ([authorization.credential isKindOfClass:[ASPasswordCredential class]]) {
        
        // 存储过帐号密码的情况，授权登录的时候会调用这里
        
    }
}

六、Demo

示例代码见：QiPasswordAutoFill

参考学习资料

推荐文章：
iOS 给UILabel添加点击事件
 用SwiftUI给视图添加动画
 用SwiftUI写一个简单页面
 Swift 5.1 (7) - 闭包
 iOS App启动优化（三）—— 自己做一个工具监控App的启动耗时
 iOS App启动优化（二）—— 使用“Time Profiler”工具监控App的启动耗时
 iOS App启动优化（一）—— 了解App的启动流程