ExpoReact
Home › Technical Guides › Security
Security

Cross-Platform Security: Secret Storage, TLS Hardening, and Deep Links

Harden unified apps against token extraction, traffic interception, and unsafe deep links using native OS security controls.

Never Store Secrets in Plaintext Local Storage or Bundles

Every asset compiled into a mobile IPA, Android APK/AAB, or web JS bundle is inspectable by anyone who downloads the application. Never embed private API keys, signing secrets, or administrative credentials inside client-side environment variables—treat all bundled code as public and perform privileged operations strictly on backend endpoints.

For user session credentials and refresh tokens, avoid unencrypted AsyncStorage, SharedPreferences, or browser localStorage. On iOS, persist tokens in Keychain Services; on Android, encrypt secrets via the hardware-backed Android Keystore; on the web, prefer HttpOnly, Secure, SameSite cookies managed by the server.

Transport Layer Security (TLS 1.3) and Certificate Pinning

Enforce HTTPS across every endpoint using Apple App Transport Security (ATS) and Android Network Security Config—disabling cleartext HTTP in all production builds. Where high-assurance threat models require defense against rogue certificate authorities, implement SPKI public-key pinning rather than pinning short-lived leaf certificates.

Always ship at least one pre-generated backup pin alongside your active intermediate or key pin, and plan rotation windows months ahead of expiration so certificate renewals never lock existing mobile users out of backend APIs.

Deep-Link Sanitization and WebView Isolation

Universal Links (iOS) and Android App Links route external URLs directly into internal app screens. Without strict schema validation, crafted links can trigger unintended state changes, inject unexpected query parameters, or redirect embedded WebViews toward untrusted phishing domains.

Maintain an explicit allow-list of valid routes, parameter formats, and trusted origins before forwarding any deep-link payload to navigation state or API calls. Disable mixed content and unnecessary file:// access inside embedded WebViews.

Session Lifecycle, Biometric Gates, and Logout Hygiene

Short-lived access tokens paired with rotating refresh tokens limit damage if a credential leaks. When guarding sensitive actions with Face ID or Android BiometricPrompt, bind biometric approval to cryptographic Keystore or Keychain access controls rather than relying on a plain boolean UI flag.

On explicit sign-out, revoke refresh tokens server-side and wipe cached user records across memory, Keychain/Keystore, and local SQLite or IndexedDB stores so shared devices retain zero residual personal data.

Cross-Platform Security Controls Reference

Security DomainiOS MechanismAndroid MechanismWeb Mechanism
Token StorageiOS Keychain ServicesAndroid Keystore + Encrypted prefsHttpOnly Secure SameSite Cookies
Transport SecurityApp Transport Security (ATS)Network Security ConfigHSTS + TLS 1.3 enforcement
Link VerificationApple App Site Assoc (AASA)Digital Asset Links JSONStrict origin & route allow-list
Biometric AuthLocalAuthentication + KeychainBiometricPrompt + CryptoObjectWebAuthn / Passkeys
Code IntegrityOS signing + obfuscationR8 shrinking + Play IntegritySubresource Integrity + CSP

Platform security primitives aligned with OWASP MASVS verification categories.

Worked Illustration: Designing Resilient Key Pinning & Rotation

Illustrative scenario: A mobile app enforces TLS public-key pinning while avoiding outages during scheduled 90-day certificate rotation.

  1. Step 1 (Illustrative hash): Extract SHA-256 Subject Public Key Info (SPKI) hashes for the active key (Pin A) and an offline backup CSR key (Pin B).
  2. Step 2 (Illustrative config): Ship both Pin A and Pin B inside Android Network Security Config and the iOS URLSession pinning delegate.
  3. Step 3 (Illustrative rotation): At day 80, rotate the server certificate using backup key B; existing clients validate cleanly via Pin B.
  4. Step 4 (Illustrative cycle): Ship an app update introducing Pin C for the next rotation while retiring Pin A once old clients phase out.

Engineering Takeaway: Pinning SPKI hashes with an active + backup pair blocks rogue-CA interception without self-inflicted TLS lockouts.

Cross-Platform Security Hardening Checklist

  • Audit client JS bundles to confirm zero private API secrets are embedded.
  • Store mobile session tokens exclusively in iOS Keychain or Android Keystore.
  • Disable cleartext HTTP in iOS ATS and Android Network Security Config.
  • Validate all Universal Link and App Link parameters against route allow-lists.
  • Configure Content Security Policy (CSP) headers and HttpOnly cookies on web.
  • Test full local cache and token purge upon sign-out or session revocation.

Frequently Asked Questions

Why is pinning leaf certificates risky compared to SPKI public-key pinning?

Automated TLS issuers rotate leaf certificates every 60–90 days. Pinning SPKI public keys with a backup key survives routine renewals.

Is AsyncStorage encrypted on mobile devices?

No. Standard AsyncStorage writes unencrypted data to disk. Never store session tokens, passwords, or sensitive data inside it.

How do WebAuthn passkeys fit into a cross-platform auth flow?

Passkeys provide phishing-resistant authentication across iOS, Android, and browsers using platform authenticators verified by your backend.

What is the biggest mistake teams make with deep links?

Passing unvalidated deep-link URLs straight into embedded WebViews or API calls, enabling open-redirect phishing or unauthorized actions.

Primary References & Standards

  • OWASP Mobile Application Security Verification Standard (MASVS) v2.x
  • IETF RFC 8446 — The Transport Layer Security (TLS) Protocol Version 1.3
  • Apple App Transport Security & Android Network Security Configuration Guides

Related Technical Guides