Saltar al contenido
Descargar CV

Escritos

Cómo guardar tokens de autenticación de forma segura en React Native

Dónde guardar tokens, sesiones y claves en React Native: expo-secure-store, react-native-keychain y MMKV cifrado, con logout y reinstalación resueltos.

Publicado el Actualizado el 8 min de lectura

  • React Native
  • Expo
  • Security
  • MMKV
  • TypeScript
  • iOS
  • Android

Respuesta corta: guarda el refresh token (y cualquier id de sesión de larga duración) en expo-secure-store o react-native-keychain, que lo entregan al Keychain de iOS y al Android Keystore. Mantén el access token de corta duración en memoria. Para datos sensibles más grandes, usa MMKV con cifrado y guarda solo su clave de cifrado en el almacenamiento seguro. Nunca pongas tokens en AsyncStorage ni en MMKV sin cifrar.

Todas las apps con inicio de sesión que construyo, tienen que responder a la misma pregunta el primer día: ¿dónde vive la sesión entre un arranque y otro? Este artículo es la configuración que uso, con las dos particularidades de cada plataforma que pillan a la gente por sorpresa (las reinstalaciones en iOS y las copias de seguridad en Android). Forma parte de una pequeña serie sobre almacenamiento local; la visión general está en MMKV vs AsyncStorage vs SQLite vs SecureStore.

Qué cuenta como dato sensible

Una prueba sencilla: si alguien copiara este valor del móvil, ¿podría hacerse pasar por el usuario o leer sus datos privados? Si la respuesta es sí, es sensible.

Dato ¿Sensible? Dónde guardarlo
Refresh token, id de sesión Sí SecureStore o Keychain
Access token (JWT de corta duración) Sí En memoria, renovado con el refresh token
PIN o contraseña del usuario Sí, mejor no guardarlo nunca Keychain con protección biométrica, si no queda otra
Clave de cifrado de una base de datos local Sí SecureStore o Keychain
Mensajes privados en caché, datos de salud o financieros Sí, y a menudo grandes MMKV cifrado o SQLCipher, con la clave en almacenamiento seguro
Tema, idioma, flag de onboarding No MMKV sin cifrar o AsyncStorage

Por qué AsyncStorage y MMKV sin cifrar no bastan

Los dos escriben en archivos dentro del sandbox de tu app. En un móvil normal, el sandbox impide que otras apps los lean, pero los valores se guardan como texto plano. En un dispositivo rooteado o con jailbreak, desde una copia de seguridad del dispositivo sin cifrar o con una herramienta de depuración en el móvil de un desarrollador, cualquiera puede abrir esos archivos y leer el token.

La guía de seguridad de React Native dice lo mismo: AsyncStorage no está cifrado y no debe contener tokens ni secretos. El almacenamiento seguro es distinto porque el secreto se entrega al sistema operativo:

  • iOS: los valores van al Keychain, que el sistema cifra y vincula al código de desbloqueo del dispositivo.
  • Android: los valores se cifran con una clave que vive en el Android Keystore. En la mayoría de los móviles modernos esa clave está en hardware seguro dedicado, así que nunca entra en la memoria de tu app y no se puede copiar fuera del dispositivo.

Opción 1: expo-secure-store

expo-secure-store es la opción más fácil, y funciona en Expo Go. Las versiones aquí son de Expo SDK 58 (expo-secure-store 58.0.2):

npx expo install expo-secure-store
import * as SecureStore from 'expo-secure-store';

const REFRESH_TOKEN = 'refreshToken';

export async function saveRefreshToken(token: string) {
  await SecureStore.setItemAsync(REFRESH_TOKEN, token, {
    // Se puede leer tras el primer desbloqueo desde el arranque, así el refresco en segundo plano sigue funcionando.
    // THIS_DEVICE_ONLY lo deja fuera de las copias de seguridad restauradas en otro móvil.
    keychainAccessible: SecureStore.AFTER_FIRST_UNLOCK_THIS_DEVICE_ONLY,
  });
}

export function getRefreshToken() {
  return SecureStore.getItemAsync(REFRESH_TOKEN);
}

export function deleteRefreshToken() {
  return SecureStore.deleteItemAsync(REFRESH_TOKEN);
}

Las claves solo pueden contener letras, números, ., - y _. Mantén los valores pequeños: la documentación de Expo indica que algunas versiones de iOS rechazaban valores de más de unos 2048 bytes. Un token cabe sin problema; un perfil de usuario entero, no.

Opción 2: react-native-keychain

react-native-keychain (versión 10.0.0 en el momento de escribir esto) te da más control: reglas de acceso biométrico, comprobaciones del nivel de seguridad y “services” separados para distintos secretos. Es una elección habitual en apps de React Native sin Expo.

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

const SERVICE = 'com.example.app.session';

export async function saveSession(userId: string, refreshToken: string) {
  await Keychain.setGenericPassword(userId, refreshToken, {
    service: SERVICE,
    accessible: Keychain.ACCESSIBLE.AFTER_FIRST_UNLOCK_THIS_DEVICE_ONLY,
  });
}

export async function loadSession() {
  const credentials = await Keychain.getGenericPassword({ service: SERVICE });
  return credentials ? { userId: credentials.username, refreshToken: credentials.password } : null;
}

export function clearSession() {
  return Keychain.resetGenericPassword({ service: SERVICE });
}

El par de usuario y contraseña parece raro para un token, pero encaja bien con una sesión: el id del usuario va en username y el token en password.

¿Cuál deberías elegir? En una app de Expo, expo-secure-store cubre casi todo con menos configuración. Recurre a react-native-keychain cuando necesites reglas biométricas más finas o estés en una app sin Expo que ya la usa.

Opción 3: MMKV cifrado para datos sensibles más grandes

El almacenamiento seguro está pensado para secretos pequeños, no para una caché de mensajes privados o de registros financieros. Para eso uso MMKV con el cifrado activado y guardo solo la clave en el almacenamiento seguro:

import * as Crypto from 'expo-crypto';
import * as SecureStore from 'expo-secure-store';
import { createMMKV } from 'react-native-mmkv';

const KEY_NAME = 'mmkvEncryptionKey';

function getOrCreateEncryptionKey() {
  let key = SecureStore.getItem(KEY_NAME);
  if (!key) {
    // 16 bytes aleatorios en hexadecimal = 32 caracteres, el máximo para AES-256 en MMKV
    key = Array.from(Crypto.getRandomBytes(16), (b) => b.toString(16).padStart(2, '0')).join('');
    SecureStore.setItem(KEY_NAME, key, {
      keychainAccessible: SecureStore.AFTER_FIRST_UNLOCK_THIS_DEVICE_ONLY,
    });
  }
  return key;
}

export const secureCache = createMMKV({
  id: 'secure-cache',
  encryptionKey: getOrCreateEncryptionKey(),
  encryptionType: 'AES-256',
});

Aquí uso los getItem y setItem síncronos de expo-secure-store para poder crear la instancia cifrada al arrancar, antes de la primera pantalla. La longitud de la clave importa: react-native-mmkv rechaza claves de más de 16 bytes con AES-128 y de más de 32 bytes con AES-256, algo que comprobé en su código fuente. Conservas la velocidad de MMKV (más sobre eso en cómo hacer rápido el almacenamiento local en React Native) y los datos en disco no sirven de nada sin la clave del Keychain o del Keystore.

Si los datos sensibles son relacionales, la misma idea funciona con SQLite: expo-sqlite y op-sqlite admiten SQLCipher, y guardas su clave en el almacenamiento seguro.

El flujo completo de tokens

Juntándolo todo, este es el flujo que monto en las apps con inicio de sesión:

  1. Inicio de sesión: el servidor devuelve un access token y un refresh token. Guarda el refresh token en el almacenamiento seguro. Mantén el access token en una variable o en tu store de estado, no en disco.
  2. Arranque de la app: lee el refresh token. Si existe, pide al servidor un access token nuevo. Si falla con un 401, manda al usuario a la pantalla de inicio de sesión.
  3. Llamadas a la API: adjunta el access token desde memoria. Ante un 401, renuévalo una vez y reintenta.
  4. Cierre de sesión: borra el refresh token, vacía las instancias de MMKV por usuario, vacía la caché de consultas y pide al servidor que revoque la sesión.

Un contenedor de tokens mínimo:

import * as SecureStore from 'expo-secure-store';

let accessToken: string | null = null;

export const tokens = {
  getAccess: () => accessToken,
  setAccess: (token: string | null) => {
    accessToken = token;
  },
  async clearAll() {
    accessToken = null;
    await SecureStore.deleteItemAsync('refreshToken');
  },
};

Mantener el access token solo en memoria significa que una copia de seguridad robada o un volcado de archivos no contiene nada útil aparte del refresh token, que está en el Keychain o en el Keystore y que tu servidor puede revocar.

Dos particularidades de cada plataforma que debes resolver

iOS conserva los datos del Keychain tras desinstalar la app

En iOS, los elementos del Keychain pueden sobrevivir a una desinstalación. Un usuario borra tu app, la reinstala semanas después y aparece “ya con la sesión iniciada” con una sesión antigua o, peor aún, con una sesión que pertenece a otra persona en un dispositivo compartido. La documentación de Expo avisa de esto y recomienda no depender de ello en ningún sentido.

La solución aprovecha que los archivos de MMKV sí se borran al desinstalar:

import * as SecureStore from 'expo-secure-store';
import { appStorage } from './storage';

export async function clearKeychainOnFreshInstall() {
  if (appStorage.getBoolean('hasLaunchedBefore')) return;
  await SecureStore.deleteItemAsync('refreshToken');
  appStorage.set('hasLaunchedBefore', true);
}

Llámala una vez al arrancar, antes de leer la sesión. Si falta el flag, es una instalación nueva, así que se elimina cualquier elemento que haya quedado en el Keychain.

Las copias de seguridad de Android no pueden restaurar valores cifrados

Auto Backup de Android puede copiar las shared preferences de tu app a la nube, pero la clave del Keystore usada para cifrarlas nunca se incluye en la copia. Tras restaurar en un móvil nuevo, los valores no se pueden descifrar. expo-secure-store excluye sus propios datos de Auto Backup por defecto. Si tu app tiene una configuración de copia de seguridad personalizada, excluye tú mismo las shared preferences de SecureStore, como explica la sección Android Auto Backup de la documentación, y asegúrate de que tu app gestiona la falta de token pidiendo al usuario que vuelva a iniciar sesión.

Protección biométrica

Las dos librerías pueden exigir Face ID, Touch ID o la huella dactilar antes de leer un valor. Con expo-secure-store, pasa requireAuthentication: true; con react-native-keychain, usa accessControl: Keychain.ACCESS_CONTROL.BIOMETRY_ANY.

Úsala para acciones de mucho valor, como desbloquear una app bancaria o confirmar un pago, no para el refresh token que tu app lee en silencio en cada arranque. Ten en cuenta también que los valores protegidos así dejan de poder leerse cuando el usuario cambia su biometría (por ejemplo, al añadir una huella nueva), así que ten siempre como alternativa un inicio de sesión normal.

Lo que el almacenamiento seguro no protege

El almacenamiento seguro protege los datos en reposo en el dispositivo. No sirve de nada si:

  • Registras tokens con console.log o los envías a un servicio de informes de errores.
  • Pones tokens en URLs, donde acaban en los logs del servidor y de los proxies.
  • El dispositivo está comprometido y un atacante se engancha a tu app en ejecución y lee el token de la memoria después de que lo cargues.

Para lo último no hay una respuesta perfecta en un dispositivo que no controlas. Los access tokens de corta duración, la rotación de refresh tokens y la revocación en el servidor limitan el daño. El proyecto OWASP Mobile Application Security es la referencia que uso cuando una app necesita una revisión de seguridad en serio.

Preguntas frecuentes

¿Dónde debo guardar un JWT en React Native?

Guarda el refresh token en expo-secure-store o react-native-keychain, y mantén el access token de corta duración en memoria. Si tu backend solo emite un JWT de larga duración, trátalo como un refresh token y guárdalo en el almacenamiento seguro.

¿Es seguro AsyncStorage para guardar tokens?

No. AsyncStorage guarda los valores sin cifrar en el sandbox de la app. La documentación de React Native desaconseja guardar en él tokens o secretos. Usa el Keychain de iOS y el Android Keystore a través de una librería de almacenamiento seguro.

¿Es seguro expo-secure-store?

Sí, para secretos pequeños. Guarda los valores en el Keychain de iOS y, en Android, los cifra con una clave guardada en el Android Keystore. No está pensado para datos grandes, y algunas versiones de iOS rechazaban valores de más de unos 2048 bytes.

¿Es MMKV cifrado tan seguro como el Keychain?

Solo si la clave de cifrado está protegida. Escribir la clave directamente en tu bundle de JavaScript deja el cifrado sin sentido, porque cualquiera puede extraerla. Genera una clave aleatoria en el dispositivo y guárdala en SecureStore o Keychain, como se muestra arriba.

¿Por qué mi usuario sigue con la sesión iniciada después de reinstalar en iOS?

El Keychain de iOS puede conservar elementos tras una desinstalación. Guarda un flag de “ya se abrió antes” en MMKV o AsyncStorage, que sí se borran al desinstalar, y elimina los elementos del Keychain cuando falte ese flag.

¿Funciona el almacenamiento seguro en Expo Go?

expo-secure-store funciona en Expo Go. react-native-keychain y react-native-mmkv necesitan código nativo, así que requieren un development build.


Esta es la última parte de mi serie sobre almacenamiento local. Si te la saltaste, empieza por MMKV vs AsyncStorage vs SQLite vs SecureStore. Si quieres en tu app un desarrollador de React Native que piense en la seguridad, escríbeme.

Más artículos

¿Tienes una app en mente?

Cuéntame qué estás construyendo. Respondo a cada consulta seria en un plazo de dos días laborables.