React Native Keychain 使用指南：安全存储敏感数据的最佳实践-优快云博客

React Native Keychain 使用指南：安全存储敏感数据的最佳实践

react-native-keychain :key: Keychain Access for React Native 项目地址: https://gitcode.com/gh_mirrors/re/react-native-keychain

什么是 React Native Keychain

React Native Keychain 是一个专门为 React Native 应用设计的原生模块，它允许开发者在 iOS 和 Android 平台上安全地存储和检索敏感信息。这个库的核心价值在于它利用了各平台提供的原生加密机制（iOS 的 Keychain 服务和 Android 的 Keystore 系统），为移动应用提供了企业级的安全存储解决方案。

核心功能特性

安全凭证存储：可安全保存用户名/密码组合、访问令牌等敏感数据
生物识别集成：支持 Face ID、Touch ID 和指纹认证
多平台支持：兼容 iOS、Android、macOS Catalyst 和 visionOS
灵活的访问控制：可配置不同的安全级别和访问策略
自动加密：所有数据在存储时自动加密，保护用户隐私

平台兼容性要求

iOS：需要 iOS 9.0 或更高版本
Android：需要 API 级别 23（Android 6.0）或更高
macOS Catalyst：完全支持
visionOS：完全支持

安装指南

在你的 React Native 项目中安装 React Native Keychain 非常简单，可以使用以下任一包管理工具：

# 使用 npm
npm install react-native-keychain

# 使用 Yarn
yarn add react-native-keychain

# 使用 pnpm
pnpm add react-native-keychain

安装完成后，iOS 平台需要运行 pod install 来链接原生依赖，Android 平台则自动配置。

典型使用场景

1. 存储用户凭证

当用户登录成功后，你可以安全地将他们的凭证存储在设备上：

import * as Keychain from 'react-native-keychain';

async function storeCredentials(username, password) {
  try {
    await Keychain.setGenericPassword(username, password);
    console.log('凭证已安全存储');
  } catch (error) {
    console.error('存储凭证失败', error);
  }
}

2. 检索存储的凭证

当应用启动时，可以检查并自动登录用户：

async function getStoredCredentials() {
  try {
    const credentials = await Keychain.getGenericPassword();
    if (credentials) {
      console.log('找到存储的凭证', credentials.username);
      return credentials;
    }
    console.log('没有找到存储的凭证');
    return null;
  } catch (error) {
    console.error('获取凭证失败', error);
    return null;
  }
}

3. 使用生物识别认证

增加生物识别层来保护敏感数据：

async function storeWithBiometrics() {
  try {
    await Keychain.setGenericPassword('username', 'password', {
      accessControl: Keychain.ACCESS_CONTROL.BIOMETRY_ANY,
      accessible: Keychain.ACCESSIBLE.WHEN_UNLOCKED,
    });
    console.log('使用生物识别保护的凭证已存储');
  } catch (error) {
    console.error('生物识别存储失败', error);
  }
}