Skip to content

Privacy-first password manager with built-in email aliasing. Fully encrypted and self-hostable.

Add vault export feature to mobile app (#2528)

Leendert de Borsta65f6142d067
diff --git a/apps/mobile-app/android/app/src/main/java/net/aliasvault/app/nativevaultmanager/RustCoreDispatcher.kt b/apps/mobile-app/android/app/src/main/java/net/aliasvault/app/nativevaultmanager/RustCoreDispatcher.kt
index 31f9c6b58..152226a6a 100644
--- a/apps/mobile-app/android/app/src/main/java/net/aliasvault/app/nativevaultmanager/RustCoreDispatcher.kt
+++ b/apps/mobile-app/android/app/src/main/java/net/aliasvault/app/nativevaultmanager/RustCoreDispatcher.kt
@@ -37,6 +37,7 @@ import uniffi.aliasvault_core.srpGenerateSalt
import uniffi.aliasvault_core.srpVerifySession
import uniffi.aliasvault_core.symmetricDecrypt
import uniffi.aliasvault_core.symmetricDecryptBytes
+import uniffi.aliasvault_core.symmetricEncryptBytes
import uniffi.aliasvault_core.vaultCodecCanonicalizeFromSqlite
import uniffi.aliasvault_core.vaultCodecGenerateManifestSalt
import uniffi.aliasvault_core.vaultCodecLogoContentHash
@@ -87,6 +88,7 @@ object RustCoreDispatcher {
"rsaDecrypt" -> json(rsaDecrypt(args.string(0), args.string(1)))
"symmetricDecrypt" -> json(symmetricDecrypt(args.string(0), args.string(1)))
"symmetricDecryptBytes" -> json(symmetricDecryptBytes(args.bytes(0), args.string(1)))
+ "symmetricEncryptBytes" -> json(symmetricEncryptBytes(args.bytes(0), args.string(1)))
"argon2DeriveKey" -> json(argon2DeriveKey(args.string(0), args.string(1), args.string(2)))
"deriveSrpPasswordHash" -> json(deriveSrpPasswordHash(args.bytes(0), args.string(1)))
diff --git a/apps/mobile-app/app/(tabs)/settings/import-export.tsx b/apps/mobile-app/app/(tabs)/settings/import-export.tsx
index 0c551e14a..234c6d5e3 100644
--- a/apps/mobile-app/app/(tabs)/settings/import-export.tsx
+++ b/apps/mobile-app/app/(tabs)/settings/import-export.tsx
@@ -1,3 +1,6 @@
+import { AvexExportService } from '@aliasvault/client/transfer/export/AvexExportService';
+import { AvuxExportService } from '@aliasvault/client/transfer/export/AvuxExportService';
+import { VAULT_EXPORT_MIME_TYPES, vaultExportFileName, type VaultExportFormat } from '@aliasvault/client/transfer/export/VaultExportFile';
import { Ionicons } from '@expo/vector-icons';
import { File } from 'expo-file-system';
import * as Sharing from 'expo-sharing';
@@ -10,6 +13,7 @@ import { VaultUnlockHelper } from '@/utils/VaultUnlockHelper';
import { useColors } from '@/hooks/useColorScheme';
import { useTranslation } from '@/hooks/useTranslation';
+import { ExportPasswordModal } from '@/components/common/ExportPasswordModal';
import LoadingOverlay from '@/components/LoadingOverlay';
import { ThemedContainer } from '@/components/themed/ThemedContainer';
import { ThemedScrollView } from '@/components/themed/ThemedScrollView';
@@ -17,6 +21,21 @@ import { ThemedText } from '@/components/themed/ThemedText';
import { useDb } from '@/context/DbContext';
import { useDialog } from '@/context/DialogContext';
+/**
+ * The unlock methods that may confirm an export. Only the master password: an export hands over the whole vault in
+ * one go, so the device unlock (biometrics or PIN) alone is not enough.
+ */
+const EXPORT_AUTH_METHODS = ['password'];
+
+/**
+ * The export options, in the order they are shown.
+ */
+const EXPORT_FORMATS: { format: VaultExportFormat; titleKey: string; descriptionKey: string; buttonKey: string; icon: keyof typeof Ionicons.glyphMap; recommended: boolean }[] = [
+ { format: 'avex', titleKey: 'importExport.exportAvexTitle', descriptionKey: 'importExport.exportAvexDescription', buttonKey: 'importExport.exportAvexButton', icon: 'lock-closed', recommended: true },
+ { format: 'avux', titleKey: 'importExport.exportAvuxTitle', descriptionKey: 'importExport.exportAvuxDescription', buttonKey: 'importExport.exportAvuxButton', icon: 'archive', recommended: false },
+ { format: 'csv', titleKey: 'importExport.exportCsvTitle', descriptionKey: 'importExport.exportCsvDescription', buttonKey: 'importExport.exportCsvButton', icon: 'document-text', recommended: false },
+];
+
/**
* Import/Export settings screen.
* @returns The Import/Export settings screen component.
@@ -27,48 +46,51 @@ export default function ImportExportScreen(): React.ReactNode {
const dbContext = useDb();
const { showAlert, showConfirm } = useDialog();
const [isExporting, setIsExporting] = useState(false);
+ const [showExportPasswordModal, setShowExportPasswordModal] = useState(false);
/**
- * Show export confirmation dialog, then password verification.
+ * Confirm the export, verify the master password, then export (or ask for the export password first for .avex).
*/
- const showExportConfirmation = (): void => {
- showConfirm(
- t('settings.exportConfirmTitle'),
- t('settings.exportWarning'),
- t('common.confirm'),
- async () => {
- try {
- /*
- * Request password authentication using native unlock screen
- * Only allow password method (no biometric or PIN) for sensitive export operation
- */
- const authenticated = await VaultUnlockHelper.authenticateForAction(
- t('settings.exportConfirmTitle'),
- t('settings.passwordConfirm.exportDescription'),
- ['password'], // Only allow password authentication
- t('common.confirm')
- );
-
- if (!authenticated) {
- // User cancelled or authentication failed
- return;
- }
-
- // Password verified, proceed with export
- await handleExport();
- } catch (error) {
- console.error('Authentication error during CSV export:', error);
- showAlert(t('common.error'), t('common.errors.unknownError'));
+ const startExport = (format: VaultExportFormat): void => {
+ const warning = format === 'avex' ? t('importExport.exportEncryptedWarningMessage') : t('settings.exportWarning');
+ showConfirm(t('settings.exportConfirmTitle'), warning, t('common.confirm'), async () => {
+ try {
+ const authenticated = await VaultUnlockHelper.authenticateForAction(t('settings.exportConfirmTitle'), t('settings.passwordConfirm.exportDescription'), EXPORT_AUTH_METHODS, t('common.confirm'));
+ if (!authenticated) {
+ return;
+ }
+
+ if (format === 'avex') {
+ setShowExportPasswordModal(true);
+ } else {
+ await runExport(format, null);
}
- },
- { confirmStyle: 'destructive' }
- );
+ } catch (error) {
+ console.error('Authentication error during vault export:', error);
+ showAlert(t('common.error'), t('common.errors.unknownError'));
+ }
+ }, { confirmStyle: 'destructive' });
};
/**
- * Handle the CSV export.
+ * The export bytes of a format, read from the vault.
*/
- const handleExport = async (): Promise<void> => {
+ const buildExport = async (format: VaultExportFormat, exportPassword: string | null): Promise<Uint8Array> => {
+ const sqliteClient = dbContext.sqliteClient;
+ if (!sqliteClient) {
+ throw new Error('Vault is not available');
+ }
+ if (format === 'csv') {
+ return sqliteClient.importExport.exportToCsv();
+ }
+ const avuxBytes = AvuxExportService.exportToAvux(await sqliteClient.importExport.getExportData());
+ return format === 'avux' ? avuxBytes : AvexExportService.encryptToAvex(avuxBytes, exportPassword ?? '');
+ };
+
+ /**
+ * Build the export, write it to a temporary file and hand it to the system share sheet.
+ */
+ const runExport = async (format: VaultExportFormat, exportPassword: string | null): Promise<void> => {
if (isExporting) {
return;
}
@@ -77,14 +99,9 @@ export default function ImportExportScreen(): React.ReactNode {
let file: File | null = null;
try {
- const dateStr = new Date().toISOString().split('T')[0];
+ const bytes = await buildExport(format, exportPassword);
- if (!dbContext.sqliteClient) {
- throw new Error('Vault is not available');
- }
- const csvContent = await dbContext.sqliteClient.importExport.exportToCsv();
-
- const filename = `aliasvault-export-${dateStr}.csv`;
+ const filename = vaultExportFileName(format);
const exportDir = getExportDirectory();
if (!exportDir.exists) {
exportDir.create({ intermediates: true });
@@ -95,14 +112,10 @@ export default function ImportExportScreen(): React.ReactNode {
file.delete();
}
file.create();
- file.write(csvContent);
+ file.write(bytes);
- // Share the file using the system share dialog
if (await Sharing.isAvailableAsync()) {
- await Sharing.shareAsync(file.uri, {
- dialogTitle: filename,
- mimeType: 'text/csv',
- });
+ await Sharing.shareAsync(file.uri, { dialogTitle: filename, mimeType: VAULT_EXPORT_MIME_TYPES[format] });
}
} catch (error) {
console.error('Export error:', error);
@@ -120,6 +133,14 @@ export default function ImportExportScreen(): React.ReactNode {
}
};
+ /**
+ * The export password was entered: create the .avex export.
+ */
+ const handleExportPasswordSubmitted = (exportPassword: string): void => {
+ setShowExportPasswordModal(false);
+ void runExport('avex', exportPassword);
+ };
+
const styles = StyleSheet.create({
button: {
alignItems: 'center',
@@ -127,7 +148,6 @@ export default function ImportExportScreen(): React.ReactNode {
borderRadius: 8,
flexDirection: 'row',
justifyContent: 'center',
- marginVertical: 8,
paddingHorizontal: 16,
paddingVertical: 12,
},
@@ -140,6 +160,35 @@ export default function ImportExportScreen(): React.ReactNode {
fontWeight: '600',
marginLeft: 8,
},
+ exportOption: {
+ borderColor: colors.accentBorder,
+ borderRadius: 8,
+ borderWidth: 1,
+ marginTop: 12,
+ padding: 12,
+ },
+ exportOptionDescription: {
+ color: colors.textMuted,
+ fontSize: 14,
+ lineHeight: 20,
+ marginBottom: 12,
+ },
+ exportOptionHeader: {
+ alignItems: 'center',
+ flexDirection: 'row',
+ gap: 8,
+ marginBottom: 4,
+ },
+ exportOptionRecommended: {
+ backgroundColor: colors.tertiary + '20',
+ borderColor: colors.tertiary,
+ borderWidth: 2,
+ },
+ exportOptionTitle: {
+ color: colors.text,
+ fontSize: 16,
+ fontWeight: '600',
+ },
importNote: {
backgroundColor: colors.tertiary + '20', // Use tertiary color with opacity
borderRadius: 8,
@@ -151,6 +200,17 @@ export default function ImportExportScreen(): React.ReactNode {
fontSize: 14,
lineHeight: 20,
},
+ recommendedBadge: {
+ backgroundColor: colors.tertiary + '40',
+ borderRadius: 4,
+ paddingHorizontal: 6,
+ paddingVertical: 2,
+ },
+ recommendedBadgeText: {
+ color: colors.text,
+ fontSize: 12,
+ fontWeight: '600',
+ },
section: {
backgroundColor: colors.accentBackground,
borderRadius: 10,
@@ -161,7 +221,7 @@ export default function ImportExportScreen(): React.ReactNode {
color: colors.textMuted,
fontSize: 14,
lineHeight: 20,
- marginBottom: 16,
+ marginBottom: 4,
},
sectionTitle: {
color: colors.text,
@@ -174,7 +234,7 @@ export default function ImportExportScreen(): React.ReactNode {
return (
<>
{isExporting && (
- <LoadingOverlay status={t('settings.exporting')} />
+ <LoadingOverlay status={t('importExport.exportingVaultMessage')} />
)}
<ThemedContainer>
<ThemedScrollView>
@@ -199,25 +259,36 @@ export default function ImportExportScreen(): React.ReactNode {
{t('settings.exportSectionTitle')}
</ThemedText>
<ThemedText style={styles.sectionDescription}>
- {t('settings.exportSectionDescription')}
+ {t('importExport.exportSectionDescription')}
</ThemedText>
- <TouchableOpacity
- style={[styles.button, isExporting && styles.buttonDisabled]}
- onPress={() => showExportConfirmation()}
- disabled={isExporting}
- >
- <Ionicons name="document-text" size={20} color={colors.primarySurfaceText} />
- <ThemedText style={styles.buttonText}>
- {isExporting
- ? (t('settings.exporting'))
- : (t('settings.exportCsvButton'))
- }
- </ThemedText>
- </TouchableOpacity>
+ {EXPORT_FORMATS.map(option => (
+ <View key={option.format} style={[styles.exportOption, option.recommended && styles.exportOptionRecommended]}>
+ <View style={styles.exportOptionHeader}>
+ <ThemedText style={styles.exportOptionTitle}>{t(option.titleKey)}</ThemedText>
+ {option.recommended && (
+ <View style={styles.recommendedBadge}>
+ <ThemedText style={styles.recommendedBadgeText}>{t('importExport.recommendedLabel')}</ThemedText>
+ </View>
+ )}
+ </View>
+ <ThemedText style={styles.exportOptionDescription}>{t(option.descriptionKey)}</ThemedText>
+ <TouchableOpacity
+ style={[styles.button, isExporting && styles.buttonDisabled]}
+ onPress={() => startExport(option.format)}
+ disabled={isExporting}
+ testID={`export-${option.format}-button`}
+ >
+ <Ionicons name={option.icon} size={20} color={colors.primarySurfaceText} />
+ <ThemedText style={styles.buttonText}>{t(option.buttonKey)}</ThemedText>
+ </TouchableOpacity>
+ </View>
+ ))}
</View>
</ThemedScrollView>
</ThemedContainer>
+
+ <ExportPasswordModal isOpen={showExportPasswordModal} onClose={() => setShowExportPasswordModal(false)} onSubmit={handleExportPasswordSubmitted} />
</>
);
}
diff --git a/apps/mobile-app/components/common/ExportPasswordModal.tsx b/apps/mobile-app/components/common/ExportPasswordModal.tsx
new file mode 100644
index 000000000..edfdc9ac5
--- /dev/null
+++ b/apps/mobile-app/components/common/ExportPasswordModal.tsx
@@ -0,0 +1,131 @@
+import { MIN_ACCEPTED_PASSWORD_LENGTH } from '@aliasvault/client/utilities/PasswordStrength';
+import React, { useLayoutEffect, useState } from 'react';
+import { StyleSheet, TextInput, TouchableOpacity, View } from 'react-native';
+
+import { useColors } from '@/hooks/useColorScheme';
+import { useTranslation } from '@/hooks/useTranslation';
+
+import { ModalWrapper } from '@/components/common/ModalWrapper';
+import { PasswordStrengthIndicator } from '@/components/form/PasswordStrengthIndicator';
+import { ThemedText } from '@/components/themed/ThemedText';
+
+type ExportPasswordModalProps = {
+ isOpen: boolean;
+ onClose: () => void;
+ onSubmit: (exportPassword: string) => void;
+};
+
+/**
+ * Asks for the password an encrypted (.avex) export is protected with.
+ */
+export const ExportPasswordModal: React.FC<ExportPasswordModalProps> = ({ isOpen, onClose, onSubmit }) => {
+ const { t } = useTranslation();
+ const colors = useColors();
+ const [exportPassword, setExportPassword] = useState('');
+ const [confirmPassword, setConfirmPassword] = useState('');
+
+ useLayoutEffect(() => {
+ if (isOpen) {
+ setExportPassword('');
+ setConfirmPassword('');
+ }
+ }, [isOpen]);
+
+ const isTooShort = exportPassword.length > 0 && exportPassword.length < MIN_ACCEPTED_PASSWORD_LENGTH;
+ const isMismatch = confirmPassword.length > 0 && exportPassword !== confirmPassword;
+ const isValid = exportPassword.length >= MIN_ACCEPTED_PASSWORD_LENGTH && exportPassword === confirmPassword;
+
+ const styles = StyleSheet.create({
+ button: {
+ alignItems: 'center',
+ borderRadius: 8,
+ flex: 1,
+ paddingVertical: 12,
+ },
+ buttonDisabled: {
+ opacity: 0.5,
+ },
+ buttonPrimary: {
+ backgroundColor: colors.primary,
+ },
+ buttonSecondary: {
+ backgroundColor: colors.modalSurfaceRaised,
+ borderColor: colors.accentBorder,
+ borderWidth: 1,
+ },
+ buttonText: {
+ fontWeight: '600',
+ },
+ buttonTextPrimary: {
+ color: colors.primarySurfaceText,
+ },
+ buttonTextSecondary: {
+ color: colors.text,
+ },
+ buttons: {
+ flexDirection: 'row',
+ gap: 12,
+ marginTop: 16,
+ },
+ description: {
+ color: colors.textMuted,
+ fontSize: 14,
+ lineHeight: 20,
+ marginBottom: 16,
+ },
+ errorText: {
+ color: colors.red,
+ fontSize: 13,
+ marginTop: 8,
+ },
+ field: {
+ marginBottom: 12,
+ },
+ input: {
+ backgroundColor: colors.modalSurfaceRaised,
+ borderColor: colors.accentBorder,
+ borderRadius: 6,
+ borderWidth: 1,
+ color: colors.text,
+ fontSize: 16,
+ padding: 10,
+ },
+ inputLabel: {
+ color: colors.text,
+ fontSize: 14,
+ fontWeight: '600',
+ marginBottom: 8,
+ },
+ });
+
+ return (
+ <ModalWrapper isOpen={isOpen} onClose={onClose} title={t('importExport.exportEncryptedPasswordTitle')} keyboardAvoiding showHeaderBorder={false} showFooterBorder={false}>
+ <ThemedText style={styles.description}>{t('importExport.exportEncryptedPasswordDescription')}</ThemedText>
+
+ <View style={styles.field}>
+ <ThemedText style={styles.inputLabel}>{t('importExport.exportPasswordModal.exportPasswordLabel')}</ThemedText>
+ <TextInput style={styles.input} secureTextEntry autoFocus autoCapitalize="none" autoCorrect={false} value={exportPassword} onChangeText={setExportPassword} />
+ <PasswordStrengthIndicator password={exportPassword} />
+ </View>
+
+ <View style={styles.field}>
+ <ThemedText style={styles.inputLabel}>{t('importExport.exportPasswordModal.confirmExportPasswordLabel')}</ThemedText>
+ <TextInput style={styles.input} secureTextEntry autoCapitalize="none" autoCorrect={false} value={confirmPassword} onChangeText={setConfirmPassword} />
+ </View>
+
+ {isTooShort && <ThemedText style={styles.errorText}>{t('settings.securitySettings.changePassword.passwordTooShort', { minLength: MIN_ACCEPTED_PASSWORD_LENGTH })}</ThemedText>}
+ {!isTooShort && isMismatch && <ThemedText style={styles.errorText}>{t('common.errorPasswordMismatch')}</ThemedText>}
+
+ <View style={styles.buttons}>
+ <TouchableOpacity style={[styles.button, styles.buttonSecondary]} onPress={onClose} activeOpacity={0.7}>
+ <ThemedText style={[styles.buttonText, styles.buttonTextSecondary]}>{t('common.cancel')}</ThemedText>
+ </TouchableOpacity>
+ <TouchableOpacity style={[styles.button, styles.buttonPrimary, !isValid && styles.buttonDisabled]} onPress={() => onSubmit(exportPassword)} disabled={!isValid} activeOpacity={0.7}>
+ <ThemedText style={[styles.buttonText, styles.buttonTextPrimary]}>{t('common.create')}</ThemedText>
+ </TouchableOpacity>
+ </View>
+ </ModalWrapper>
+ );
+};
+
+export default ExportPasswordModal;
diff --git a/apps/mobile-app/ios/NativeVaultManager/NativeVaultManager.swift b/apps/mobile-app/ios/NativeVaultManager/NativeVaultManager.swift
index 223e60d64..50f2a2487 100644
--- a/apps/mobile-app/ios/NativeVaultManager/NativeVaultManager.swift
+++ b/apps/mobile-app/ios/NativeVaultManager/NativeVaultManager.swift
@@ -1567,6 +1567,7 @@ private enum RustCoreDispatcher {
case "rsaDecrypt": return try json(bytes: try RustCoreFramework.rsaDecrypt(base64Ciphertext: try args.string(0), privateKeyJwk: try args.string(1)))
case "symmetricDecrypt": return try json(try RustCoreFramework.symmetricDecrypt(base64Ciphertext: try args.string(0), keyBase64: try args.string(1)))
case "symmetricDecryptBytes": return try json(bytes: try RustCoreFramework.symmetricDecryptBytes(encrypted: try args.data(0), keyBase64: try args.string(1)))
+ case "symmetricEncryptBytes": return try json(bytes: try RustCoreFramework.symmetricEncryptBytes(plaintext: try args.data(0), keyBase64: try args.string(1)))
case "argon2DeriveKey":
return try json(bytes: try RustCoreFramework.argon2DeriveKey(password: try args.string(0), salt: try args.string(1), encryptionSettings: try args.string(2)))
diff --git a/apps/mobile-app/platform/NativeRustCore.ts b/apps/mobile-app/platform/NativeRustCore.ts
index 007929303..5efe33982 100644
--- a/apps/mobile-app/platform/NativeRustCore.ts
+++ b/apps/mobile-app/platform/NativeRustCore.ts
@@ -69,6 +69,7 @@ export const nativeRustCore: IRustCore = {
symmetricDecrypt: (base64Ciphertext, keyBase64) => call('symmetricDecrypt', base64Ciphertext, keyBase64),
symmetricDecryptBytes: (encrypted, keyBase64) => callForBytes('symmetricDecryptBytes', base64(encrypted), keyBase64),
+ symmetricEncryptBytes: (plaintext, keyBase64) => callForBytes('symmetricEncryptBytes', base64(plaintext), keyBase64),
rsaDecrypt: (base64Ciphertext, privateKeyJwk) => callForBytes('rsaDecrypt', base64Ciphertext, privateKeyJwk),
pinGenerateSalt: () => notImplementedOnMobile('pinGenerateSalt', PIN_IS_NATIVE),