如何在iOS应用中接入iCloud Keychain实现账号密码自动保存功能

基础接入流程 #

要实现用户无需重复输入账号密码、凭据跨设备同步的需求，按以下步骤操作即可：

1. Xcode项目能力配置
   打开项目的Signing & Capabilities标签页，添加Keychain Sharing能力，勾选iCloud Keychain选项，确保使用的开发团队ID和Bundle ID配置正确，无冲突。
2. 登录页输入框适配系统识别
   给登录页的两个输入框设置对应的内容类型，让系统自动识别为登录凭据输入项：

• 邮箱/账号输入框的textContentType属性设置为.username
• 密码输入框的textContentType属性设置为.password
  设置完成后，用户首次登录成功时系统会自动弹出提示，询问是否将凭据保存到iCloud Keychain。

3. 手动同步凭据到iCloud Keychain（可选）
   如果需要自行控制凭据存储逻辑，而非完全依赖系统提示，可以使用Keychain API手动存储，存储时需添加kSecAttrSynchronizable属性开启iCloud同步，示例代码如下：

import Security

let account = "user@example.com"
let password = "user_password".data(using: .utf8)!
let query: [CFString: Any] = [
    kSecClass: kSecClassGenericPassword,
    kSecAttrService: Bundle.main.bundleIdentifier!,
    kSecAttrAccount: account,
    kSecValueData: password,
    kSecAttrSynchronizable: kCFBooleanTrue!, // 开启iCloud同步核心属性
    kSecAttrAccessible: kSecAttrAccessibleWhenUnlocked
]

// 先删除旧的同账号凭据，避免存储冲突
SecItemDelete(query as CFDictionary)
// 存储新凭据
let status = SecItemAdd(query as CFDictionary, nil)
if status == errSecSuccess {
    print("凭据已同步到iCloud Keychain")
}

4. 系统级自动填充适配（推荐）
   如果要实现打开App登录页就自动弹出凭据填充提示，无需用户手动点击输入框，可引入AuthenticationServices框架，将已保存的凭据同步到系统凭据库：

import AuthenticationServices

let credential = ASPasswordCredential(user: "user@example.com", password: "user_password")
ASCredentialIdentityStore.shared.saveCredentialIdentities([credential]) { success, error in
    if success {
        print("凭据已加入系统自动填充库")
    }
}

关于你提到的Keychain教程适配说明 #

你提到的那篇讲解iOS Keychain存储用户数据的教程是适用的，核心的Keychain读写逻辑可以直接复用，只需要做以下调整即可适配iCloud Keychain需求：

• 原教程默认仅存储到本地Keychain，需要在存储的查询参数中新增kSecAttrSynchronizable: kCFBooleanTrue!属性，即可开启跨设备iCloud同步
• 原教程仅覆盖手动读写Keychain的逻辑，如果要实现系统自动填充能力，需要额外适配AuthenticationServices框架的相关API，不要完全依赖应用内读取Keychain填充的逻辑，系统级自动填充的用户体验更好
• 存储凭据时，账号字段固定使用kSecAttrAccount、密码字段固定使用kSecValueData、服务标识使用你的App Bundle ID或关联域名，确保系统可以正确识别对应到你的应用触发自动填充

额外注意事项 #

• 如需实现App和对应网站的凭据互通，可添加Associated Domains能力，配置webcredentials:你的官网域名即可
• 存储的凭据默认受系统加密保护，即使设备越狱也无法明文读取，符合隐私合规要求
• 不要在Keychain中存储除了登录凭据、敏感密钥之外的大量业务数据，Keychain的设计定位是小体积敏感数据存储

内容的提问来源于stack exchange，提问作者Coding God