Busca en todas las páginas de la documentación
Una referencia compuesta para un cliente móvil de banca minorista / wealth-lite - saldos, transferencias, extractos, controles de tarjetas. Las restricciones de seguridad y cumplimiento dominan la arquitectura. Stack: Expo SDK 57 (expo ~57.0.4), React Native 0.86.0, React 19.2.3.
Impulsores regulatorios y de seguridad:
Modelo de lanzamiento: Binarios de tienda mensuales; sin OTA de producción para este cliente (el cumplimiento eligió entrega de JS solo mediante artefactos de tienda). OTA de canal de vista previa usada solo para QA interno.
┌────────────────────────────────────────────────────────────────────────────┐
│ Cliente fintech - arquitectura de seguridad │
├────────────────────────────────────────────────────────────────────────────┤
│ Expo Router │
│ (auth)/login, (auth)/device-trust │
│ (app)/(tabs)/accounts|transfer|more │
│ (app)/transfer/confirm ← puerta biométrica + evento de auditoría │
├────────────────────────────────────────────────────────────────────────────┤
│ Capa de autenticación │
│ expo-auth-session (PKCE) → intercambio de código → actualización de │
│ SecureStore │
│ AuthProvider: bootstrapping → authenticated | session_expired │
│ Actualización de AppState en primer plano - Ciclo de vida de Session │
├────────────────────────────────────────────────────────────────────────────┤
│ Transporte │
│ api/client.ts → assertHttps → validador de pin TLS nativo (solo │
│ lanzamiento) │
│ Plugin de configuración de Certificate Pinning - hashes SPKI primarios │
│ + respaldo │
├────────────────────────────────────────────────────────────────────────────┤
│ Paso a paso │
│ expo-local-authentication antes de mutaciones de alto riesgo │
│ Servidor registra timestamp de paso a paso - cliente emite evento de │
│ auditoría │
├────────────────────────────────────────────────────────────────────────────┤
│ Canalización de auditoría │
│ audit.log(event) → cola de batch → POST /audit (carga útil firmada) │
│ Sentry depurado - sin tokens, sin números de cuenta en breadcrumbs │
├────────────────────────────────────────────────────────────────────────────┤
│ Lanzamiento │
│ EAS Build solo producción; eas update deshabilitado en canal de │
│ producción │
│ SDK de pagos nativo + conjunto de pin versionado con semver de tienda │
└────────────────────────────────────────────────────────────────────────────┘Flujo de autenticación:
Inicio en frío → lectura de SecureStore refresh → actualización silenciosa
├─ éxito → (app) tabs
├─ fallo → (auth)/login → OAuth PKCE → almacenar refresh → auditoría: LOGIN_SUCCESS
└─ riesgo de dispositivo elevado → (auth)/device-trust → auditoría: DEVICE_CHALLENGEFlujo de transferencia (alto riesgo):
Usuario confirma cantidad → LocalAuthentication.authenticateAsync()
├─ fallo → auditoría: STEP_UP_FAILED, permanecer en pantalla
└─ éxito → POST /transfers + Idempotency-Key → auditoría: TRANSFER_INITIATEDRelacionado: Reglas de Seguridad para Móvil - nivel mínimo antes del envío de tienda
Referencia rápida de stack de seguridad en SDK 57 - completa la lista de verificación ADR antes de hacer pinning.
npx create-expo-app@latest AcmeBank --template default@sdk-57
npx expo install expo-auth-session expo-secure-store expo-local-authentication
# Pinning: config plugin + dev-client rebuild - no Expo Go
eas build --profile preview --platform all// src/audit/auditLog.ts (extracto) - estructurado, sin PII en cuerpo del mensaje
type AuditEvent =
| { type: "LOGIN_SUCCESS"; deviceId: string }
| { type: "STEP_UP_FAILED"; reason: string }
| { type: "TRANSFER_INITIATED"; transferId: string; amountBucket: string };
export function auditLog(event: AuditEvent) {
const entry = {
...event,
at: new Date().toISOString(),
appVersion: Application.nativeApplicationVersion,
sdk: "57",
};
queueForUpload(entry); // flush on foreground + before transfer POST
}El ADR de Pinning debe incluir:
1. Modelo de amenaza (CA canalla, portal cautivo - no "prevenir ingeniería inversa")
2. Pins SPKI primarios + respaldo
3. Alertas de renovación de certificado de 30 días
4. Política de omisión de MITM corporativo (generalmente: sin omisión - documentar script de helpdesk)
5. Ruta de reconstrucción nativa cuando se rotan los pins| # | Decisión | Opción | Justificación |
|---|---|---|---|
| 1 | OAuth | PKCE vía expo-auth-session | Cliente público móvil - sin secreto de cliente incrustado - Ciclo de vida de Auth Session |
| 2 | Almacenamiento de tokens | SecureStore refresh; acceso en memoria | Reglas de seguridad de nivel 2; política de grep cero en AsyncStorage |
| 3 | Pinning | Pinning SPKI nativo con pin de respaldo | Modelo de amenaza incluyó CA canalla; runbook de rotación propiedad de ops de seguridad - Certificate Pinning |
| 4 | Biometría | Paso a paso para transferencias; desbloqueo de app opcional | Puerta de IU biométrica, no almacenamiento - Biometría con LocalAuthentication |
| 5 | OTA | Deshabilitado en canal de producción | Cumplimiento requería procedencia binaria; OTA de vista previa solo para QA - Reglas de Lanzamiento y OTA |
| 6 | Registro de auditoría | Cola de evento de cliente + inmutabilidad del servidor | Dispositivo emite eventos estructurados; servidor es registro legal |
| 7 | Jailbreak/root | Señal de riesgo → características limitadas | Sin crash forzado; auditoría DEVICE_RISK_ELEVATED - reglas de seguridad nivel 4 |
| 8 | Registro | Sentry con scrubber de autorización | Revisión de carga útil de crash de prueba en staging obligatoria |
| 9 | Enlaces profundos | Sin tokens en URLs | Push abre /accounts/[id] - intercambiar nonce corta duración del servidor - API de Expo Linking |
Alternativas rechazadas:
Lanzamiento interno en SDK 57 después de migrar desde SDK 55 (ruta incremental a través de 56 - ver caso de estudio de actualización de SDK).
| Control | Resultado |
|---|---|
| Hallazgos de prueba de penetración (móvil) | 0 críticos después de pinning + migración de SecureStore |
| Completitud de auditoría | 99.2% eventos de cliente coincidieron con ingestión del servidor (brechas de cola offline - flushed on reconnect) |
| Prueba de rotación de pin | Pin de respaldo ahorró ventana de corte de 48 horas durante renovación de certificado primario |
| Opt-in de paso a paso biométrico | 87% habilitado; ruta PIN de retroceso auditada |
| Bloqueos falsos (detección raíz) | <0.3% - modo degradado en lugar de crash |
Un incidente: ingeniero envió debug rejectUnauthorized: false - regla de grep de CI agregada per Reglas de Seguridad para Móvil #17.
Archivo ADR de pinning antes de escribir código nativo. Rotación sin pins de respaldo rompe producción hasta la aprobación de tienda - practica trimestralmente.
Eventos de auditoría no son analítica. Canalización separada, retención más estricta, sin muestreo de SDK de terceros.
Timestamp de paso a paso debe llegar al servidor. El éxito biométrico solo del cliente no es evidencia para disputas.
La política de OTA es una decisión de cumplimiento, no una decisión de velocidad. Este cliente eligió solo tienda de producción; caso de estudio SaaS B2C hermano eligió OTA - ambos válidos con documentación.
La migración de SecureStore es un lanzamiento, no una refactorización. Una ruta única de AsyncStorage → SecureStore se ejecutó antes de habilitar actualización al reanudar.
Anota SDK 57 en cargas útiles de auditoría. Ops de fraude correlaciona comportamiento con versiones de expo y Hermes durante revisión de incidentes.
Versiones de stack: Esta página fue escrita para React 19.2.3, React Native 0.86.0 y Expo SDK 57 (
expo~57.0.4).
Revisado por Chris St. John·Última actualización: 19 jul 2026