From 87e223bc5942bc6837f6a765853380a99ee3993f Mon Sep 17 00:00:00 2001 From: Andrew Haisting <142518658+ahaisting-livefront@users.noreply.github.com> Date: Tue, 24 Sep 2024 09:16:59 -0500 Subject: [PATCH] BITAU-104 Implement BridgeService (#3954) --- app/libs/bridge-0.1.0-SNAPSHOT-release.aar | Bin 56107 -> 56817 bytes .../manager/di/PlatformManagerModule.kt | 5 + .../processor/BridgeServiceProcessorImpl.kt | 80 +++- .../platform/repository/BridgeRepository.kt | 25 + .../repository/BridgeRepositoryImpl.kt | 119 +++++ .../repository/di/PlatformRepositoryModule.kt | 23 + .../processor/BridgeServiceProcessorTest.kt | 187 +++++++- .../repository/BridgeRepositoryTest.kt | 438 ++++++++++++++++++ .../com/bitwarden/bridge/IBridgeService.aidl | 2 +- .../bitwarden/bridge/util/EncryptionUtils.kt | 14 +- 10 files changed, 861 insertions(+), 32 deletions(-) create mode 100644 app/src/main/java/com/x8bit/bitwarden/data/platform/repository/BridgeRepository.kt create mode 100644 app/src/main/java/com/x8bit/bitwarden/data/platform/repository/BridgeRepositoryImpl.kt create mode 100644 app/src/test/java/com/x8bit/bitwarden/data/platform/repository/BridgeRepositoryTest.kt diff --git a/app/libs/bridge-0.1.0-SNAPSHOT-release.aar b/app/libs/bridge-0.1.0-SNAPSHOT-release.aar index d55770b5c7ceb29f7ff971d6fd8ff8792605bc92..45cde408a6339ed9cd05f8942fad3bddf1019bd2 100644 GIT binary patch delta 38063 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 T7L#Ar6q6O(5C)3b00000C?2dO delta 37355 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

D%F-H2Uc@6^S^I>j^TNtpt&4&n46c)B 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 n*%p(2*a?$~+z^v<-5LT5)|0W;B9jl diff --git a/app/src/main/java/com/x8bit/bitwarden/data/platform/manager/di/PlatformManagerModule.kt b/app/src/main/java/com/x8bit/bitwarden/data/platform/manager/di/PlatformManagerModule.kt index 1f56c22b15..59f055e73b 100644 --- a/app/src/main/java/com/x8bit/bitwarden/data/platform/manager/di/PlatformManagerModule.kt +++ b/app/src/main/java/com/x8bit/bitwarden/data/platform/manager/di/PlatformManagerModule.kt @@ -51,6 +51,7 @@ import com.x8bit.bitwarden.data.platform.manager.garbage.GarbageCollectionManage import com.x8bit.bitwarden.data.platform.manager.garbage.GarbageCollectionManagerImpl import com.x8bit.bitwarden.data.platform.manager.restriction.RestrictionManager import com.x8bit.bitwarden.data.platform.manager.restriction.RestrictionManagerImpl +import com.x8bit.bitwarden.data.platform.repository.BridgeRepository import com.x8bit.bitwarden.data.platform.repository.DebugMenuRepository import com.x8bit.bitwarden.data.platform.repository.EnvironmentRepository import com.x8bit.bitwarden.data.platform.repository.ServerConfigRepository @@ -80,8 +81,12 @@ object PlatformManagerModule { @Provides @Singleton fun provideBridgeServiceProcessor( + bridgeRepository: BridgeRepository, + dispatcherManager: DispatcherManager, featureFlagManager: FeatureFlagManager, ): BridgeServiceProcessor = BridgeServiceProcessorImpl( + bridgeRepository = bridgeRepository, + dispatcherManager = dispatcherManager, featureFlagManager = featureFlagManager, ) diff --git a/app/src/main/java/com/x8bit/bitwarden/data/platform/processor/BridgeServiceProcessorImpl.kt b/app/src/main/java/com/x8bit/bitwarden/data/platform/processor/BridgeServiceProcessorImpl.kt index 415cd4ad68..e5dff3945c 100644 --- a/app/src/main/java/com/x8bit/bitwarden/data/platform/processor/BridgeServiceProcessorImpl.kt +++ b/app/src/main/java/com/x8bit/bitwarden/data/platform/processor/BridgeServiceProcessorImpl.kt @@ -2,22 +2,37 @@ package com.x8bit.bitwarden.data.platform.processor import android.content.Intent import android.os.Build +import android.os.IInterface +import android.os.RemoteCallbackList import com.bitwarden.bridge.IBridgeService import com.bitwarden.bridge.IBridgeServiceCallback import com.bitwarden.bridge.model.EncryptedAddTotpLoginItemData import com.bitwarden.bridge.model.SymmetricEncryptionKeyData import com.bitwarden.bridge.model.SymmetricEncryptionKeyFingerprintData +import com.bitwarden.bridge.util.NATIVE_BRIDGE_SDK_VERSION +import com.bitwarden.bridge.util.encrypt +import com.bitwarden.bridge.util.toFingerprint +import com.bitwarden.bridge.util.toSymmetricEncryptionKeyData import com.x8bit.bitwarden.data.platform.manager.FeatureFlagManager +import com.x8bit.bitwarden.data.platform.manager.dispatcher.DispatcherManager import com.x8bit.bitwarden.data.platform.manager.model.FlagKey +import com.x8bit.bitwarden.data.platform.repository.BridgeRepository import com.x8bit.bitwarden.data.platform.util.isBuildVersionBelow +import kotlinx.coroutines.CoroutineScope +import kotlinx.coroutines.launch /** * Default implementation of [BridgeServiceProcessor]. */ class BridgeServiceProcessorImpl( + private val bridgeRepository: BridgeRepository, private val featureFlagManager: FeatureFlagManager, + dispatcherManager: DispatcherManager, ) : BridgeServiceProcessor { + private val callbacks by lazy { RemoteCallbackList() } + private val scope by lazy { CoroutineScope(dispatcherManager.default) } + override val binder: IBridgeService.Stub? get() { return if ( @@ -37,42 +52,75 @@ class BridgeServiceProcessorImpl( * Default implementation of the bridge service binder. */ private val defaultBinder = object : IBridgeService.Stub() { - override fun getVersionNumber(): String { - // TODO: BITAU-104 - return "" - } + + override fun getVersionNumber(): String = NATIVE_BRIDGE_SDK_VERSION override fun checkSymmetricEncryptionKeyFingerprint( - data: SymmetricEncryptionKeyFingerprintData?, + symmetricKeyFingerprint: SymmetricEncryptionKeyFingerprintData?, ): Boolean { - // TODO: BITAU-104 - return false + if (symmetricKeyFingerprint == null) return false + val localSymmetricKeyFingerprint = + bridgeRepository.authenticatorSyncSymmetricKey + ?.toSymmetricEncryptionKeyData() + ?.toFingerprint() + ?.getOrNull() + return symmetricKeyFingerprint == localSymmetricKeyFingerprint } - override fun getSymmetricEncryptionKeyData(): SymmetricEncryptionKeyData? { - // TODO: BITAU-104 - return null - } + override fun getSymmetricEncryptionKeyData(): SymmetricEncryptionKeyData? = + bridgeRepository.authenticatorSyncSymmetricKey?.toSymmetricEncryptionKeyData() override fun registerBridgeServiceCallback(callback: IBridgeServiceCallback?) { - // TODO: BITAU-104 + if (callback == null) return + callbacks.register(callback) } override fun unregisterBridgeServiceCallback(callback: IBridgeServiceCallback?) { - // TODO: BITAU-104 + if (callback == null) return + callbacks.unregister(callback) } override fun syncAccounts() { - // TODO: BITAU-104 + val symmetricEncryptionKey = symmetricEncryptionKeyData ?: return + scope.launch { + // Encrypt the shared account data with the symmetric key: + val encryptedSharedAccountData = bridgeRepository + .getSharedAccounts() + .encrypt(symmetricEncryptionKey) + .getOrNull() + ?: return@launch + + // Report results to callback: + callbacks.forEach { callback -> + callback.onAccountsSync(encryptedSharedAccountData) + } + } } override fun createAddTotpLoginItemIntent(): Intent { - // TODO: BITAU-104 + // TODO: BITAU-112 return Intent() } override fun setPendingAddTotpLoginItemData(data: EncryptedAddTotpLoginItemData?) { - // TODO: BITAU-104 + // TODO: BITAU-112 } } } + +/** + * This function mirrors the hidden "RemoteCallbackList.broadcast" function. + */ +@Suppress("TooGenericExceptionCaught") +private fun RemoteCallbackList.forEach(action: (T) -> Unit) { + val count = this.beginBroadcast() + try { + for (index in 0..count) { + action(this.getBroadcastItem(index)) + } + } catch (e: Exception) { + // Broadcast failed + } finally { + this.finishBroadcast() + } +} diff --git a/app/src/main/java/com/x8bit/bitwarden/data/platform/repository/BridgeRepository.kt b/app/src/main/java/com/x8bit/bitwarden/data/platform/repository/BridgeRepository.kt new file mode 100644 index 0000000000..0e118933b9 --- /dev/null +++ b/app/src/main/java/com/x8bit/bitwarden/data/platform/repository/BridgeRepository.kt @@ -0,0 +1,25 @@ +package com.x8bit.bitwarden.data.platform.repository + +import com.bitwarden.bridge.model.SharedAccountData + +/** + * Provides an API for querying disk sources required by Bridge service implementation. + */ +interface BridgeRepository { + + /** + * The currently persisted authenticator sync symmetric key. This key is used for + * encrypting IPC traffic. + */ + val authenticatorSyncSymmetricKey: ByteArray? + + /** + * Get a list of shared account data. This function will go through all accounts and for each + * one, check to see if the user has Authenticator account syncing enabled and if they + * do, it will query and decrypt the user's shared account data. + * + * Users who do not have authenticator sync enabled or otherwise cannot have their ciphers + * accessed will be omitted from the list. + */ + suspend fun getSharedAccounts(): SharedAccountData +} diff --git a/app/src/main/java/com/x8bit/bitwarden/data/platform/repository/BridgeRepositoryImpl.kt b/app/src/main/java/com/x8bit/bitwarden/data/platform/repository/BridgeRepositoryImpl.kt new file mode 100644 index 0000000000..2892cda742 --- /dev/null +++ b/app/src/main/java/com/x8bit/bitwarden/data/platform/repository/BridgeRepositoryImpl.kt @@ -0,0 +1,119 @@ +package com.x8bit.bitwarden.data.platform.repository + +import com.bitwarden.bridge.model.SharedAccountData +import com.x8bit.bitwarden.data.auth.datasource.disk.AuthDiskSource +import com.x8bit.bitwarden.data.auth.repository.AuthRepository +import com.x8bit.bitwarden.data.platform.datasource.disk.SettingsDiskSource +import com.x8bit.bitwarden.data.vault.datasource.disk.VaultDiskSource +import com.x8bit.bitwarden.data.vault.datasource.sdk.VaultSdkSource +import com.x8bit.bitwarden.data.vault.repository.VaultRepository +import com.x8bit.bitwarden.data.vault.repository.model.VaultUnlockData +import com.x8bit.bitwarden.data.vault.repository.model.VaultUnlockResult +import com.x8bit.bitwarden.data.vault.repository.util.statusFor +import com.x8bit.bitwarden.data.vault.repository.util.toEncryptedSdkCipher +import kotlinx.coroutines.flow.first + +/** + * Default implementation of [BridgeRepository]. + */ +class BridgeRepositoryImpl( + private val authRepository: AuthRepository, + private val authDiskSource: AuthDiskSource, + private val vaultRepository: VaultRepository, + private val vaultDiskSource: VaultDiskSource, + private val vaultSdkSource: VaultSdkSource, + private val settingsDiskSource: SettingsDiskSource, +) : BridgeRepository { + + override val authenticatorSyncSymmetricKey: ByteArray? + get() = authDiskSource.authenticatorSyncSymmetricKey + + @Suppress("LongMethod") + override suspend fun getSharedAccounts(): SharedAccountData { + val allAccounts = authRepository.userStateFlow.value?.accounts ?: emptyList() + + return allAccounts + .mapNotNull { account -> + val userId = account.userId + + // Grab the user's authenticator sync unlock key. If it is null, + // the user has not enabled authenticator sync. + val decryptedUserKey = authDiskSource.getAuthenticatorSyncUnlockKey(userId) + ?: return@mapNotNull null + + // Wait for any unlocking actions to finish: + vaultRepository.vaultUnlockDataStateFlow.first { + it.statusFor(userId) != VaultUnlockData.Status.UNLOCKING + } + + // Unlock vault if necessary: + val isVaultAlreadyUnlocked = vaultRepository.isVaultUnlocked(userId = userId) + if (!isVaultAlreadyUnlocked) { + val unlockResult = vaultRepository + .unlockVaultWithDecryptedUserKey( + userId = userId, + decryptedUserKey = decryptedUserKey, + ) + + when (unlockResult) { + is VaultUnlockResult.AuthenticationError, + VaultUnlockResult.GenericError, + VaultUnlockResult.InvalidStateError, + -> { + // Not being able to unlock the user's vault with the + // decrypted unlock key is an unexpected case, but if it does + // happen we omit the account from list of shared accounts + // and remove that user's authenticator sync unlock key. + // This gives the user a way to potentially re-enable syncing + // (going to Account Security and re-enabling the toggle) + authDiskSource.storeAuthenticatorSyncUnlockKey( + userId = userId, + authenticatorSyncUnlockKey = null, + ) + return@mapNotNull null + } + // Proceed + VaultUnlockResult.Success -> Unit + } + } + + // Vault is unlocked, query vault disk source for totp logins: + val totpUris = vaultDiskSource + .getCiphers(userId) + .first() + // Filter out any ciphers without a totp item: + .filter { it.login?.totp != null } + .mapNotNull { + // Decrypt each cipher and take just totp codes: + vaultSdkSource + .decryptCipher( + userId = userId, + cipher = it.toEncryptedSdkCipher(), + ) + .getOrNull() + ?.login + ?.totp + } + + val lastSyncTime = + settingsDiskSource.getLastSyncTime(userId) ?: return@mapNotNull null + + // Lock the user's vault if we unlocked it for this operation: + if (!isVaultAlreadyUnlocked) { + vaultRepository.lockVault(userId) + } + + SharedAccountData.Account( + userId = account.userId, + name = account.name, + email = account.email, + environmentLabel = account.environment.label, + lastSyncTime = lastSyncTime, + totpUris = totpUris, + ) + } + .let { + SharedAccountData(it) + } + } +} diff --git a/app/src/main/java/com/x8bit/bitwarden/data/platform/repository/di/PlatformRepositoryModule.kt b/app/src/main/java/com/x8bit/bitwarden/data/platform/repository/di/PlatformRepositoryModule.kt index 23a566d131..2273aff0ac 100644 --- a/app/src/main/java/com/x8bit/bitwarden/data/platform/repository/di/PlatformRepositoryModule.kt +++ b/app/src/main/java/com/x8bit/bitwarden/data/platform/repository/di/PlatformRepositoryModule.kt @@ -2,6 +2,7 @@ package com.x8bit.bitwarden.data.platform.repository.di import android.view.autofill.AutofillManager import com.x8bit.bitwarden.data.auth.datasource.disk.AuthDiskSource +import com.x8bit.bitwarden.data.auth.repository.AuthRepository import com.x8bit.bitwarden.data.autofill.accessibility.manager.AccessibilityEnabledManager import com.x8bit.bitwarden.data.autofill.manager.AutofillEnabledManager import com.x8bit.bitwarden.data.platform.datasource.disk.ConfigDiskSource @@ -12,6 +13,8 @@ import com.x8bit.bitwarden.data.platform.datasource.network.service.ConfigServic import com.x8bit.bitwarden.data.platform.manager.BiometricsEncryptionManager import com.x8bit.bitwarden.data.platform.manager.PolicyManager import com.x8bit.bitwarden.data.platform.manager.dispatcher.DispatcherManager +import com.x8bit.bitwarden.data.platform.repository.BridgeRepository +import com.x8bit.bitwarden.data.platform.repository.BridgeRepositoryImpl import com.x8bit.bitwarden.data.platform.repository.DebugMenuRepository import com.x8bit.bitwarden.data.platform.repository.DebugMenuRepositoryImpl import com.x8bit.bitwarden.data.platform.repository.EnvironmentRepository @@ -20,7 +23,9 @@ import com.x8bit.bitwarden.data.platform.repository.ServerConfigRepository import com.x8bit.bitwarden.data.platform.repository.ServerConfigRepositoryImpl import com.x8bit.bitwarden.data.platform.repository.SettingsRepository import com.x8bit.bitwarden.data.platform.repository.SettingsRepositoryImpl +import com.x8bit.bitwarden.data.vault.datasource.disk.VaultDiskSource import com.x8bit.bitwarden.data.vault.datasource.sdk.VaultSdkSource +import com.x8bit.bitwarden.data.vault.repository.VaultRepository import dagger.Module import dagger.Provides import dagger.hilt.InstallIn @@ -35,6 +40,24 @@ import javax.inject.Singleton @InstallIn(SingletonComponent::class) object PlatformRepositoryModule { + @Provides + @Singleton + fun providesBridgeRepository( + authRepository: AuthRepository, + authDiskSource: AuthDiskSource, + vaultRepository: VaultRepository, + vaultDiskSource: VaultDiskSource, + vaultSdkSource: VaultSdkSource, + settingsDiskSource: SettingsDiskSource, + ): BridgeRepository = BridgeRepositoryImpl( + authRepository = authRepository, + authDiskSource = authDiskSource, + vaultRepository = vaultRepository, + vaultDiskSource = vaultDiskSource, + vaultSdkSource = vaultSdkSource, + settingsDiskSource = settingsDiskSource, + ) + @Provides @Singleton fun provideServerConfigRepository( diff --git a/app/src/test/java/com/x8bit/bitwarden/data/platform/processor/BridgeServiceProcessorTest.kt b/app/src/test/java/com/x8bit/bitwarden/data/platform/processor/BridgeServiceProcessorTest.kt index 3c1d1e6e66..441887c576 100644 --- a/app/src/test/java/com/x8bit/bitwarden/data/platform/processor/BridgeServiceProcessorTest.kt +++ b/app/src/test/java/com/x8bit/bitwarden/data/platform/processor/BridgeServiceProcessorTest.kt @@ -1,52 +1,221 @@ package com.x8bit.bitwarden.data.platform.processor import android.os.Build +import android.os.RemoteCallbackList +import com.bitwarden.bridge.IBridgeService +import com.bitwarden.bridge.IBridgeServiceCallback +import com.bitwarden.bridge.model.EncryptedSharedAccountData +import com.bitwarden.bridge.model.SharedAccountData +import com.bitwarden.bridge.util.NATIVE_BRIDGE_SDK_VERSION +import com.bitwarden.bridge.util.encrypt +import com.bitwarden.bridge.util.generateSecretKey +import com.bitwarden.bridge.util.toFingerprint +import com.bitwarden.bridge.util.toSymmetricEncryptionKeyData +import com.x8bit.bitwarden.data.platform.base.FakeDispatcherManager import com.x8bit.bitwarden.data.platform.manager.FeatureFlagManager import com.x8bit.bitwarden.data.platform.manager.model.FlagKey +import com.x8bit.bitwarden.data.platform.repository.BridgeRepository +import com.x8bit.bitwarden.data.platform.util.asSuccess import com.x8bit.bitwarden.data.platform.util.isBuildVersionBelow +import io.mockk.coEvery +import io.mockk.coVerify import io.mockk.every import io.mockk.mockk +import io.mockk.mockkConstructor import io.mockk.mockkStatic +import io.mockk.unmockkStatic +import org.junit.jupiter.api.AfterEach +import org.junit.jupiter.api.Assertions.assertEquals +import org.junit.jupiter.api.Assertions.assertFalse import org.junit.jupiter.api.Assertions.assertNotNull import org.junit.jupiter.api.Assertions.assertNull +import org.junit.jupiter.api.Assertions.assertTrue import org.junit.jupiter.api.BeforeEach +import org.junit.jupiter.api.Nested import org.junit.jupiter.api.Test class BridgeServiceProcessorTest { - private val featureFlagManager: FeatureFlagManager = mockk() + private val featureFlagManager = mockk() + private val bridgeRepository = mockk() - private val bridgeServiceManager = BridgeServiceProcessorImpl( - featureFlagManager = featureFlagManager, - ) + private lateinit var bridgeServiceProcessor: BridgeServiceProcessorImpl @BeforeEach fun setup() { - mockkStatic(::isBuildVersionBelow) + bridgeServiceProcessor = BridgeServiceProcessorImpl( + bridgeRepository = bridgeRepository, + featureFlagManager = featureFlagManager, + dispatcherManager = FakeDispatcherManager(), + ) + } + + @AfterEach + fun teardown() { + unmockkStatic(::isBuildVersionBelow) + unmockkStatic(SharedAccountData::encrypt) } @Test fun `when AuthenticatorSync feature flag is off, should return null binder`() { + mockkStatic(::isBuildVersionBelow) every { isBuildVersionBelow(Build.VERSION_CODES.S) } returns false every { featureFlagManager.getFeatureFlag(FlagKey.AuthenticatorSync) } returns false - assertNull(bridgeServiceManager.binder) + assertNull(bridgeServiceProcessor.binder) } @Test @Suppress("MaxLineLength") fun `when AuthenticatorSync feature flag is on and running Android level greater than S, should return non-null binder`() { + mockkStatic(::isBuildVersionBelow) every { isBuildVersionBelow(Build.VERSION_CODES.S) } returns false every { featureFlagManager.getFeatureFlag(FlagKey.AuthenticatorSync) } returns true - assertNotNull(bridgeServiceManager.binder) + assertNotNull(bridgeServiceProcessor.binder) } @Test fun `when below Android level S, should never return a binder regardless of feature flag`() { + mockkStatic(::isBuildVersionBelow) every { isBuildVersionBelow(Build.VERSION_CODES.S) } returns true every { featureFlagManager.getFeatureFlag(FlagKey.AuthenticatorSync) } returns false - assertNull(bridgeServiceManager.binder) + assertNull(bridgeServiceProcessor.binder) every { featureFlagManager.getFeatureFlag(FlagKey.AuthenticatorSync) } returns true - assertNull(bridgeServiceManager.binder) + assertNull(bridgeServiceProcessor.binder) + } + + @Test + fun `versionNumber should match version of compiled bridge sdk`() { + val binder = getDefaultBinder() + assertEquals( + NATIVE_BRIDGE_SDK_VERSION, + binder.versionNumber, + ) + } + + @Test + @Suppress("MaxLineLength") + fun `checkSymmetricEncryptionKeyFingerprint should return false when given fingerprint is null`() { + val binder = getDefaultBinder() + // Set disk symmetric key to null so that it is technically equal to given null fingerprint: + every { bridgeRepository.authenticatorSyncSymmetricKey } returns null + // Binder should still return false in this case: + assertFalse(binder.checkSymmetricEncryptionKeyFingerprint(null)) + } + + @Test + @Suppress("MaxLineLength") + fun `checkSymmetricEncryptionKeyFingerprint should return false if fingerprint doesn't match`() { + val binder = getDefaultBinder() + every { bridgeRepository.authenticatorSyncSymmetricKey } returns ByteArray(1) + assertFalse(binder.checkSymmetricEncryptionKeyFingerprint(SYMMETRIC_KEY_FINGERPRINT)) + } + + @Test + @Suppress("MaxLineLength") + fun `checkSymmetricEncryptionKeyFingerprint should return true if fingerprint does match`() { + val binder = getDefaultBinder() + every { + bridgeRepository.authenticatorSyncSymmetricKey + } returns SYMMETRIC_KEY.symmetricEncryptionKey.byteArray + assertTrue(binder.checkSymmetricEncryptionKeyFingerprint(SYMMETRIC_KEY_FINGERPRINT)) + } + + @Test + @Suppress("MaxLineLength") + fun `getSymmetricEncryptionKeyData should return null when there is no symmetric key stored on disk`() { + val binder = getDefaultBinder() + every { bridgeRepository.authenticatorSyncSymmetricKey } returns null + assertNull(binder.symmetricEncryptionKeyData) + } + + @Test + @Suppress("MaxLineLength") + fun `getSymmetricEncryptionKeyData should return the symmetric key stored on disk`() { + val binder = getDefaultBinder() + every { + bridgeRepository.authenticatorSyncSymmetricKey + } returns SYMMETRIC_KEY.symmetricEncryptionKey.byteArray + assertEquals(SYMMETRIC_KEY, binder.symmetricEncryptionKeyData) + } + + @Nested + inner class SyncAccountsTest { + + private var lastAccountsSync: EncryptedSharedAccountData? = null + + private val serviceCallback = object : IBridgeServiceCallback.Stub() { + override fun onAccountsSync(data: EncryptedSharedAccountData?) { + lastAccountsSync = data + } + } + + @BeforeEach + fun setup() { + // Setup RemoteCallbackList to call back to serviceCallback: + mockkConstructor(RemoteCallbackList::class) + every { + anyConstructed>() + .register(serviceCallback) + } returns true + every { + anyConstructed>() + .beginBroadcast() + } returns 1 + every { + anyConstructed>() + .getBroadcastItem(0) + } returns serviceCallback + lastAccountsSync = null + } + + @Test + fun `syncAccounts when symmetricEncryptionKeyData is null should do nothing`() { + every { bridgeRepository.authenticatorSyncSymmetricKey } returns null + getDefaultBinder().syncAccounts() + assertNull(lastAccountsSync) + } + + @Test + fun `syncAccounts should encrypt result from BridgeRepository`() { + val sharedAccountData = mockk() + val expected = mockk() + every { + bridgeRepository.authenticatorSyncSymmetricKey + } returns SYMMETRIC_KEY.symmetricEncryptionKey.byteArray + coEvery { bridgeRepository.getSharedAccounts() } returns sharedAccountData + mockkStatic(SharedAccountData::encrypt) + every { sharedAccountData.encrypt(SYMMETRIC_KEY) } returns expected.asSuccess() + + getDefaultBinder().syncAccounts() + + assertEquals(expected, lastAccountsSync) + coVerify { bridgeRepository.getSharedAccounts() } + } + } + + /** + * Helper function for accessing the default implementation of [IBridgeService.Stub]. This + * is particularly useful because the binder is nullable on [BridgeServiceProcessor] behind + * a feature flag. + */ + private fun getDefaultBinder(): IBridgeService.Stub { + mockkStatic(::isBuildVersionBelow) + every { isBuildVersionBelow(Build.VERSION_CODES.S) } returns false + every { featureFlagManager.getFeatureFlag(FlagKey.AuthenticatorSync) } returns true + return bridgeServiceProcessor.binder!! } } + +/** + * Symmetric encryption key that can be used for test. + */ +private val SYMMETRIC_KEY = generateSecretKey() + .getOrThrow() + .encoded + .toSymmetricEncryptionKeyData() + +/** + * Fingerprint of [SYMMETRIC_KEY]. + */ +private val SYMMETRIC_KEY_FINGERPRINT = SYMMETRIC_KEY.toFingerprint().getOrThrow() diff --git a/app/src/test/java/com/x8bit/bitwarden/data/platform/repository/BridgeRepositoryTest.kt b/app/src/test/java/com/x8bit/bitwarden/data/platform/repository/BridgeRepositoryTest.kt new file mode 100644 index 0000000000..64964b50e6 --- /dev/null +++ b/app/src/test/java/com/x8bit/bitwarden/data/platform/repository/BridgeRepositoryTest.kt @@ -0,0 +1,438 @@ +package com.x8bit.bitwarden.data.platform.repository + +import com.bitwarden.bridge.model.SharedAccountData +import com.bitwarden.bridge.util.generateSecretKey +import com.bitwarden.bridge.util.toSymmetricEncryptionKeyData +import com.bitwarden.vault.Cipher +import com.bitwarden.vault.CipherView +import com.x8bit.bitwarden.data.auth.datasource.disk.util.FakeAuthDiskSource +import com.x8bit.bitwarden.data.auth.repository.AuthRepository +import com.x8bit.bitwarden.data.auth.repository.model.UserState +import com.x8bit.bitwarden.data.platform.datasource.disk.util.FakeSettingsDiskSource +import com.x8bit.bitwarden.data.platform.util.asSuccess +import com.x8bit.bitwarden.data.vault.datasource.disk.VaultDiskSource +import com.x8bit.bitwarden.data.vault.datasource.network.model.SyncResponseJson +import com.x8bit.bitwarden.data.vault.datasource.sdk.VaultSdkSource +import com.x8bit.bitwarden.data.vault.repository.VaultRepository +import com.x8bit.bitwarden.data.vault.repository.model.VaultUnlockData +import com.x8bit.bitwarden.data.vault.repository.model.VaultUnlockResult +import com.x8bit.bitwarden.data.vault.repository.util.toEncryptedSdkCipher +import io.mockk.coEvery +import io.mockk.coVerify +import io.mockk.confirmVerified +import io.mockk.every +import io.mockk.mockk +import io.mockk.mockkStatic +import io.mockk.verify +import kotlinx.coroutines.async +import kotlinx.coroutines.flow.MutableStateFlow +import kotlinx.coroutines.flow.flowOf +import kotlinx.coroutines.test.runTest +import org.junit.jupiter.api.AfterEach +import org.junit.jupiter.api.Assertions.assertEquals +import org.junit.jupiter.api.Assertions.assertNull +import org.junit.jupiter.api.Assertions.assertTrue +import org.junit.jupiter.api.BeforeEach +import org.junit.jupiter.api.Test +import java.time.Instant + +class BridgeRepositoryTest { + + private val authRepository = mockk() + private val vaultSdkSource = mockk() + private val vaultDiskSource = mockk() + private val vaultRepository = mockk() + private val fakeAuthDiskSource = FakeAuthDiskSource() + private val fakeSettingsDiskSource = FakeSettingsDiskSource() + + private val bridgeRepository = BridgeRepositoryImpl( + authRepository = authRepository, + authDiskSource = fakeAuthDiskSource, + vaultRepository = vaultRepository, + vaultDiskSource = vaultDiskSource, + vaultSdkSource = vaultSdkSource, + settingsDiskSource = fakeSettingsDiskSource, + ) + + @BeforeEach + fun setup() { + // Because there is so much setup for the happy path, we set that all up here and + // then adjust accordingly in each test. The "base" setup here is that + // there are two users, USER_1, which we will often manipulate in tests, + // and USER_2, which will remain usually not manipulated to demonstrate that a single + // account failing shouldn't impact other accounts. + + // Store symmetric encryption key on disk: + fakeAuthDiskSource.authenticatorSyncSymmetricKey = + SYMMETRIC_KEY.symmetricEncryptionKey.byteArray + + // Setup authRepository to return default USER_STATE: + every { authRepository.userStateFlow } returns MutableStateFlow(USER_STATE) + + // Setup authDiskSource to have each user's authenticator sync unlock key: + fakeAuthDiskSource.storeAuthenticatorSyncUnlockKey( + userId = USER_1_ID, + authenticatorSyncUnlockKey = USER_1_UNLOCK_KEY, + ) + fakeAuthDiskSource.storeAuthenticatorSyncUnlockKey( + userId = USER_2_ID, + authenticatorSyncUnlockKey = USER_2_UNLOCK_KEY, + ) + // Setup vaultRepository to not be stuck unlocking: + every { vaultRepository.vaultUnlockDataStateFlow } returns MutableStateFlow( + listOf( + VaultUnlockData(USER_1_ID, VaultUnlockData.Status.UNLOCKED), + VaultUnlockData(USER_2_ID, VaultUnlockData.Status.UNLOCKED), + ), + ) + // Setup vaultRepository to be unlocked for user 1: + every { vaultRepository.isVaultUnlocked(USER_1_ID) } returns true + // But locked for user 2: + every { vaultRepository.isVaultUnlocked(USER_2_ID) } returns false + every { vaultRepository.lockVault(USER_2_ID) } returns Unit + coEvery { + vaultRepository.unlockVaultWithDecryptedUserKey( + userId = USER_2_ID, + decryptedUserKey = USER_2_UNLOCK_KEY, + ) + } returns VaultUnlockResult.Success + + // Setup settingDiskSource to have lastSyncTime set: + fakeSettingsDiskSource.storeLastSyncTime(USER_1_ID, LAST_SYNC_TIME) + fakeSettingsDiskSource.storeLastSyncTime(USER_2_ID, LAST_SYNC_TIME) + + // Add some ciphers to vaultDiskSource for each user, + // and setup mock decryption for them: + every { vaultDiskSource.getCiphers(USER_1_ID) } returns flowOf(USER_1_CIPHERS) + every { vaultDiskSource.getCiphers(USER_2_ID) } returns flowOf(USER_2_CIPHERS) + mockkStatic(SyncResponseJson.Cipher::toEncryptedSdkCipher) + every { + USER_1_TOTP_CIPHER.toEncryptedSdkCipher() + } returns USER_1_ENCRYPTED_SDK_TOTP_CIPHER + every { + USER_2_TOTP_CIPHER.toEncryptedSdkCipher() + } returns USER_2_ENCRYPTED_SDK_TOTP_CIPHER + coEvery { + vaultSdkSource.decryptCipher(USER_1_ID, USER_1_ENCRYPTED_SDK_TOTP_CIPHER) + } returns USER_1_DECRYPTED_TOTP_CIPHER.asSuccess() + coEvery { + vaultSdkSource.decryptCipher(USER_2_ID, USER_2_ENCRYPTED_SDK_TOTP_CIPHER) + } returns USER_2_DECRYPTED_TOTP_CIPHER.asSuccess() + } + + @AfterEach + fun teardown() { + confirmVerified(authRepository, vaultSdkSource, vaultRepository, vaultDiskSource) + } + + @Test + @Suppress("MaxLineLength") + fun `syncAccounts with user 1 vault unlocked and all data present should send expected shared accounts data`() = + runTest { + val sharedAccounts = bridgeRepository.getSharedAccounts() + assertEquals( + BOTH_ACCOUNT_SUCCESS, + sharedAccounts, + ) + verify { authRepository.userStateFlow } + verify { vaultRepository.vaultUnlockDataStateFlow } + verify { vaultDiskSource.getCiphers(USER_1_ID) } + verify { vaultDiskSource.getCiphers(USER_2_ID) } + verify { vaultRepository.isVaultUnlocked(USER_1_ID) } + verify { vaultRepository.isVaultUnlocked(USER_2_ID) } + coVerify { + vaultRepository.unlockVaultWithDecryptedUserKey( + userId = USER_2_ID, + decryptedUserKey = USER_2_UNLOCK_KEY, + ) + } + verify { vaultRepository.lockVault(USER_2_ID) } + coVerify { vaultSdkSource.decryptCipher(USER_1_ID, USER_1_ENCRYPTED_SDK_TOTP_CIPHER) } + coVerify { vaultSdkSource.decryptCipher(USER_2_ID, USER_2_ENCRYPTED_SDK_TOTP_CIPHER) } + } + + @Test + fun `syncAccounts when userStateFlow is null should return an empty list`() = runTest { + every { authRepository.userStateFlow } returns MutableStateFlow(null) + + val sharedData = bridgeRepository.getSharedAccounts() + + assertTrue(sharedData.accounts.isEmpty()) + verify { authRepository.userStateFlow } + } + + @Test + @Suppress("MaxLineLength") + fun `syncAccounts when there is no authenticator sync unlock key for user 1 should omit user 1 from list`() = + runTest { + fakeAuthDiskSource.storeAuthenticatorSyncUnlockKey( + userId = USER_1_ID, + authenticatorSyncUnlockKey = null, + ) + + assertEquals( + SharedAccountData(listOf(USER_2_SHARED_ACCOUNT)), + bridgeRepository.getSharedAccounts(), + ) + + verify { authRepository.userStateFlow } + verify { vaultRepository.isVaultUnlocked(USER_2_ID) } + coVerify { + vaultRepository.unlockVaultWithDecryptedUserKey( + userId = USER_2_ID, + decryptedUserKey = USER_2_UNLOCK_KEY, + ) + } + verify { vaultRepository.vaultUnlockDataStateFlow } + verify { vaultRepository.lockVault(USER_2_ID) } + verify { vaultDiskSource.getCiphers(USER_2_ID) } + coVerify { vaultSdkSource.decryptCipher(USER_2_ID, USER_2_ENCRYPTED_SDK_TOTP_CIPHER) } + } + + @Test + @Suppress("MaxLineLength") + fun `syncAccounts when vault is locked for both users should unlock and re-lock vault for both users`() = + runTest { + every { vaultRepository.isVaultUnlocked(USER_1_ID) } returns false + coEvery { + vaultRepository.unlockVaultWithDecryptedUserKey(USER_1_ID, USER_1_UNLOCK_KEY) + } returns VaultUnlockResult.Success + every { vaultRepository.lockVault(USER_1_ID) } returns Unit + + val sharedAccounts = bridgeRepository.getSharedAccounts() + assertEquals( + BOTH_ACCOUNT_SUCCESS, + sharedAccounts, + ) + verify { vaultRepository.vaultUnlockDataStateFlow } + verify { vaultDiskSource.getCiphers(USER_1_ID) } + verify { vaultRepository.isVaultUnlocked(USER_1_ID) } + coVerify { vaultSdkSource.decryptCipher(USER_1_ID, USER_1_ENCRYPTED_SDK_TOTP_CIPHER) } + verify { authRepository.userStateFlow } + coVerify { + vaultRepository.unlockVaultWithDecryptedUserKey( + userId = USER_1_ID, + decryptedUserKey = USER_1_UNLOCK_KEY, + ) + } + verify { vaultRepository.lockVault(USER_1_ID) } + verify { vaultRepository.isVaultUnlocked(USER_2_ID) } + coVerify { + vaultRepository.unlockVaultWithDecryptedUserKey( + userId = USER_2_ID, + decryptedUserKey = USER_2_UNLOCK_KEY, + ) + } + verify { vaultRepository.vaultUnlockDataStateFlow } + verify { vaultRepository.lockVault(USER_2_ID) } + verify { vaultDiskSource.getCiphers(USER_2_ID) } + coVerify { vaultSdkSource.decryptCipher(USER_2_ID, USER_2_ENCRYPTED_SDK_TOTP_CIPHER) } + } + + @Test + fun `syncAccounts when getLastSyncTime is null should omit account from list`() = runTest { + fakeSettingsDiskSource.storeLastSyncTime(USER_1_ID, null) + val sharedAccounts = bridgeRepository.getSharedAccounts() + assertEquals(SharedAccountData(listOf(USER_2_SHARED_ACCOUNT)), sharedAccounts) + verify { vaultRepository.vaultUnlockDataStateFlow } + verify { vaultDiskSource.getCiphers(USER_1_ID) } + verify { vaultRepository.isVaultUnlocked(USER_1_ID) } + coVerify { vaultSdkSource.decryptCipher(USER_1_ID, USER_1_ENCRYPTED_SDK_TOTP_CIPHER) } + verify { authRepository.userStateFlow } + verify { vaultRepository.isVaultUnlocked(USER_2_ID) } + coVerify { + vaultRepository.unlockVaultWithDecryptedUserKey( + userId = USER_2_ID, + decryptedUserKey = USER_2_UNLOCK_KEY, + ) + } + verify { vaultRepository.vaultUnlockDataStateFlow } + verify { vaultRepository.lockVault(USER_2_ID) } + verify { vaultDiskSource.getCiphers(USER_2_ID) } + coVerify { vaultSdkSource.decryptCipher(USER_2_ID, USER_2_ENCRYPTED_SDK_TOTP_CIPHER) } + } + + @Test + @Suppress("MaxLineLength") + fun `syncAccounts when for user 1 vault is locked and unlock fails should reset authenticator sync unlock key and omit user from the list`() = + runTest { + every { vaultRepository.isVaultUnlocked(USER_1_ID) } returns false + coEvery { + vaultRepository.unlockVaultWithDecryptedUserKey(USER_1_ID, USER_1_UNLOCK_KEY) + } returns VaultUnlockResult.InvalidStateError + + val sharedAccounts = bridgeRepository.getSharedAccounts() + assertEquals(SharedAccountData(listOf(USER_2_SHARED_ACCOUNT)), sharedAccounts) + assertNull(fakeAuthDiskSource.getAuthenticatorSyncUnlockKey(USER_1_ID)) + verify { vaultRepository.vaultUnlockDataStateFlow } + verify { vaultRepository.isVaultUnlocked(USER_1_ID) } + verify { authRepository.userStateFlow } + coVerify { + vaultRepository.unlockVaultWithDecryptedUserKey( + userId = USER_1_ID, + decryptedUserKey = USER_1_UNLOCK_KEY, + ) + } + verify { vaultRepository.isVaultUnlocked(USER_2_ID) } + coVerify { + vaultRepository.unlockVaultWithDecryptedUserKey( + userId = USER_2_ID, + decryptedUserKey = USER_2_UNLOCK_KEY, + ) + } + verify { vaultRepository.vaultUnlockDataStateFlow } + verify { vaultRepository.lockVault(USER_2_ID) } + verify { vaultDiskSource.getCiphers(USER_2_ID) } + coVerify { vaultSdkSource.decryptCipher(USER_2_ID, USER_2_ENCRYPTED_SDK_TOTP_CIPHER) } + } + + @Test + @Suppress("MaxLineLength") + fun `syncAccounts when when the vault repository never leaves unlocking state should never callback`() = + runTest { + val vaultUnlockStateFlow = MutableStateFlow( + listOf( + VaultUnlockData(USER_1_ID, VaultUnlockData.Status.UNLOCKING), + VaultUnlockData(USER_2_ID, VaultUnlockData.Status.UNLOCKED), + ), + ) + every { vaultRepository.vaultUnlockDataStateFlow } returns vaultUnlockStateFlow + val deferred = async { + val sharedAccounts = bridgeRepository.getSharedAccounts() + assertEquals(BOTH_ACCOUNT_SUCCESS, sharedAccounts) + } + + // None of these calls should happen until after user 1's vault state is not UNLOCKING: + verify(exactly = 0) { + vaultRepository.isVaultUnlocked(userId = USER_1_ID) + vaultDiskSource.getCiphers(USER_1_ID) + } + + // Then move out of UNLOCKING state, and things should proceed as normal: + vaultUnlockStateFlow.value = listOf( + VaultUnlockData(USER_1_ID, VaultUnlockData.Status.UNLOCKED), + VaultUnlockData(USER_2_ID, VaultUnlockData.Status.UNLOCKED), + ) + + deferred.await() + + verify { authRepository.userStateFlow } + verify { vaultDiskSource.getCiphers(USER_1_ID) } + verify { vaultDiskSource.getCiphers(USER_2_ID) } + verify { vaultRepository.isVaultUnlocked(USER_1_ID) } + verify { vaultRepository.isVaultUnlocked(USER_2_ID) } + verify { vaultRepository.vaultUnlockDataStateFlow } + coVerify { + vaultRepository.unlockVaultWithDecryptedUserKey( + userId = USER_2_ID, + decryptedUserKey = USER_2_UNLOCK_KEY, + ) + } + verify { vaultRepository.lockVault(USER_2_ID) } + coVerify { vaultSdkSource.decryptCipher(USER_1_ID, USER_1_ENCRYPTED_SDK_TOTP_CIPHER) } + coVerify { vaultSdkSource.decryptCipher(USER_2_ID, USER_2_ENCRYPTED_SDK_TOTP_CIPHER) } + } + + @Test + fun `authenticatorSyncSymmetricKey should read from authDiskSource`() { + fakeAuthDiskSource.authenticatorSyncSymmetricKey = null + assertNull(bridgeRepository.authenticatorSyncSymmetricKey) + + val syncKey = generateSecretKey().getOrThrow().encoded + fakeAuthDiskSource.authenticatorSyncSymmetricKey = syncKey + + assertEquals(syncKey, bridgeRepository.authenticatorSyncSymmetricKey) + } +} + +/** + * Symmetric encryption key that can be used for test. + */ +private val SYMMETRIC_KEY = generateSecretKey() + .getOrThrow() + .encoded + .toSymmetricEncryptionKeyData() + +private const val USER_1_ID = "user1Id" +private const val USER_2_ID = "user2Id" + +private const val USER_1_UNLOCK_KEY = "user1UnlockKey" +private const val USER_2_UNLOCK_KEY = "user2UnlockKey" + +private val ACCOUNT_1 = mockk { + every { userId } returns USER_1_ID + every { name } returns "John Doe" + every { email } returns "john@doe.com" + every { environment.label } returns "bitwarden.com" +} + +private val ACCOUNT_2 = mockk { + every { userId } returns USER_2_ID + every { name } returns "Jane Doe" + every { email } returns "Jane@doe.com" + every { environment.label } returns "bitwarden.com" +} + +private val USER_STATE = UserState( + activeUserId = USER_1_ID, + accounts = listOf( + ACCOUNT_1, + ACCOUNT_2, + ), +) + +private val USER_1_TOTP_CIPHER = mockk { + every { login?.totp } returns "encryptedTotp1" +} + +private val USER_2_TOTP_CIPHER = mockk { + every { login?.totp } returns "encryptedTotp2" +} + +private val USER_1_ENCRYPTED_SDK_TOTP_CIPHER = mockk() +private val USER_2_ENCRYPTED_SDK_TOTP_CIPHER = mockk() + +private val USER_1_DECRYPTED_TOTP_CIPHER = mockk { + every { login?.totp } returns "totp1" +} +private val USER_2_DECRYPTED_TOTP_CIPHER = mockk { + every { login?.totp } returns "totp2" +} + +private val USER_1_EXPECTED_TOTP_LIST = listOf("totp1") +private val USER_2_EXPECTED_TOTP_LIST = listOf("totp2") + +private val LAST_SYNC_TIME = Instant.now() + +private val USER_1_SHARED_ACCOUNT = SharedAccountData.Account( + userId = ACCOUNT_1.userId, + name = ACCOUNT_1.name, + email = ACCOUNT_1.email, + environmentLabel = ACCOUNT_1.environment.label, + totpUris = USER_1_EXPECTED_TOTP_LIST, + lastSyncTime = LAST_SYNC_TIME, +) + +private val USER_2_SHARED_ACCOUNT = SharedAccountData.Account( + userId = ACCOUNT_2.userId, + name = ACCOUNT_2.name, + email = ACCOUNT_2.email, + environmentLabel = ACCOUNT_2.environment.label, + totpUris = USER_2_EXPECTED_TOTP_LIST, + lastSyncTime = LAST_SYNC_TIME, +) + +private val USER_1_CIPHERS = listOf( + USER_1_TOTP_CIPHER, +) + +private val USER_2_CIPHERS = listOf( + USER_2_TOTP_CIPHER, +) + +private val BOTH_ACCOUNT_SUCCESS = SharedAccountData( + listOf( + USER_1_SHARED_ACCOUNT, + USER_2_SHARED_ACCOUNT, + ), +) diff --git a/bridge/src/main/aidl/com/bitwarden/bridge/IBridgeService.aidl b/bridge/src/main/aidl/com/bitwarden/bridge/IBridgeService.aidl index 02256f3a5a..a954da7471 100644 --- a/bridge/src/main/aidl/com/bitwarden/bridge/IBridgeService.aidl +++ b/bridge/src/main/aidl/com/bitwarden/bridge/IBridgeService.aidl @@ -18,7 +18,7 @@ interface IBridgeService { String getVersionNumber(); // Returns true when the given symmetric fingerprint data matches that contained by the SDK. - boolean checkSymmetricEncryptionKeyFingerprint(in SymmetricEncryptionKeyFingerprintData data); + boolean checkSymmetricEncryptionKeyFingerprint(in SymmetricEncryptionKeyFingerprintData symmetricKeyFingerprint); // Returns a symmetric key that will be used for encypting all IPC traffic. // diff --git a/bridge/src/main/java/com/bitwarden/bridge/util/EncryptionUtils.kt b/bridge/src/main/java/com/bitwarden/bridge/util/EncryptionUtils.kt index 707b58fd54..4110b0c8a0 100644 --- a/bridge/src/main/java/com/bitwarden/bridge/util/EncryptionUtils.kt +++ b/bridge/src/main/java/com/bitwarden/bridge/util/EncryptionUtils.kt @@ -9,6 +9,7 @@ import com.bitwarden.bridge.model.EncryptedSharedAccountData import com.bitwarden.bridge.model.SharedAccountData import com.bitwarden.bridge.model.SharedAccountDataJson import com.bitwarden.bridge.model.SymmetricEncryptionKeyData +import com.bitwarden.bridge.model.SymmetricEncryptionKeyFingerprintData import com.bitwarden.bridge.model.toByteArrayContainer import kotlinx.serialization.encodeToString import java.security.MessageDigest @@ -36,12 +37,13 @@ fun generateSecretKey(): Result = runCatching { * [IBridgeService.checkSymmetricEncryptionKeyFingerprint], which allows callers of the service * to verify that they have the correct symmetric key without actually having to send the key. */ -fun SymmetricEncryptionKeyData.toFingerprint(): Result = runCatching { - val messageDigest = MessageDigest.getInstance(KeyProperties.DIGEST_SHA256) - messageDigest.reset() - messageDigest.update(this.symmetricEncryptionKey.byteArray) - messageDigest.digest() -} +fun SymmetricEncryptionKeyData.toFingerprint(): Result = + runCatching { + val messageDigest = MessageDigest.getInstance(KeyProperties.DIGEST_SHA256) + messageDigest.reset() + messageDigest.update(this.symmetricEncryptionKey.byteArray) + SymmetricEncryptionKeyFingerprintData(messageDigest.digest().toByteArrayContainer()) + } /** * Encrypt [SharedAccountData].