Loading...
Back to projects
Expo Mutual TLS
Anders & A-Cube S.r.l. / 15 décembre 2024 • 3 min read
React NativeExpoSecuritymTLSiOSAndroidTypeScriptSwiftKotlin
Loading...
Anders & A-Cube S.r.l. / 15 décembre 2024 • 3 min read
expo-mutual-tls est un module Expo prêt pour la production qui fournit une authentification par certificat client mutual TLS (mTLS) sécurisée et matériellement sauvegardée pour les applications mobiles. Construit avec des implémentations natives pour iOS (Swift) et Android (Kotlin), il offre des fonctionnalités de sécurité de niveau entreprise avec une API conviviale pour les développeurs.
Le module suit le modèle d'architecture des modules natifs Expo avec trois couches distinctes:
┌─────────────────────────────────────────┐
│ Couche JavaScript/TypeScript │
│ (ExpoMutualTls Utility Wrapper) │
└──────────────┬──────────────────────────┘
│
┌──────────────▼──────────────────────────┐
│ Couche Bridge Module Expo │
│ (Intégration ExpoModulesCore) │
└──────┬───────────────────────┬──────────┘
│ │
┌──────▼────────┐ ┌────────▼─────────┐
│ iOS Native │ │ Android Native │
│ (Swift) │ │ (Kotlin) │
└───────────────┘ └──────────────────┘
src/)ios/)android/)import ExpoMutualTls from '@a-cube-io/expo-mutual-tls'
// Configurer le module (requis avant utilisation)
await ExpoMutualTls.configureP12(
'my-app-identifier',
true // Activer logging debug
)// Stocker le certificat P12 dans Keychain sécurisé
const certificateData = await FileSystem.readAsStringAsync(
'path/to/certificate.p12',
{ encoding: FileSystem.EncodingType.Base64 }
)
await ExpoMutualTls.storeP12(certificateData, 'certificate-password')
// Vérifier si le certificat est stocké
const hasP12 = await ExpoMutualTls.hasP12()
console.log('Certificate stored:', hasP12)
// Supprimer le certificat
await ExpoMutualTls.removeP12()// Requête GET avec mTLS
const response = await ExpoMutualTls.sendRequest(
'https://api.example.com/data',
{
method: 'GET',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer token123'
}
}
)
console.log('Status:', response.statusCode)
console.log('Data:', response.data)
// Requête POST avec body
const postResponse = await ExpoMutualTls.sendRequest(
'https://api.example.com/submit',
// Écouter les événements du module
const subscription = ExpoMutualTls.addListener('onMtlsEvent', (event) => {
console.log('Event:', event.type, event.data)
})
// Retirer le listener lorsqu'il n'est plus nécessaire
subscription.remove()Implémentation iOS:
kSecAttrAccessibleWhenUnlockedThisDeviceOnlyImplémentation Android:
// Le module valide automatiquement:
// - Chaîne de certificats
// - Dates d'expiration
// - Extended Key Usage (EKU)
// - Vérification hostname (iOS)
// - Révocation de certificat (si configuré)// Activer la protection biométrique pour l'accès au certificat
await ExpoMutualTls.configureP12(
'my-app-identifier',
true,
{
requireBiometrics: true,
biometricPrompt: {
title: 'Authentifier',
subtitle: 'Accéder au certificat',
description: 'Utilisez la biométrie pour continuer'
}
}
)| Opération | iOS | Android |
|---|---|---|
| Configuration Module | ~50ms | ~80ms |
| Stockage Certificat P12 | ~150ms | ~200ms |
| Chargement Certificat depuis Keychain | ~30ms | ~50ms |
| Requête HTTPS (mTLS) | ~500-800ms | ~600-900ms |
| Authentification Biométrique | ~200-500ms | ~300-600ms |
import React, { useEffect, useState } from 'react'
import { View, Button, Text } from 'react-native'
import * as FileSystem from 'expo-file-system'
import ExpoMutualTls from '@a-cube-io/expo-mutual-tls'
export default function SecureApiScreen() {
const [configured, setConfigured] = useState(false)
const [data, setData] = useState(null)
useEffect(() => {
setupMTLS()
}, [])
const
iOS:
Android:
expo-mutual-tls fournit une authentification mTLS prête pour la production pour les apps Expo/React Native avec un focus sur:
Dépôt: github.com/a-cube-io/expo-mutual-tls Package: @a-cube-io/expo-mutual-tls Licence: MIT