using System.Security.Cryptography; using DodoSSH.Client.Domain; using DodoSSH.Contracts; using DodoSSH.Crypto; namespace DodoSSH.Client.Sync; /// /// Turns a bucket into an item payload and back. /// /// /// /// Mirrors exactly, including the rule that a payload is sealed at the version /// the server will assign rather than the one it replaces — see . /// /// /// The resource type is the one thing not to copy. SyncEntityType.ObjectStore is 13 and /// CryptoSpec.AadResourceType.ObjectStore is 16, because the crypto enum carries None, User, Device /// and Vault ahead of the item types and then closed a hole at 12 and 13. Casting one to the other would /// seal a bucket's keys under the resource type for a host-to-credential association — which /// encrypts perfectly, decrypts perfectly on the machine that wrote it, and violates docs/crypto.md /// everywhere else. /// /// public static class ObjectStoreCipher { private const CryptoSpec.AadResourceType Resource = CryptoSpec.AadResourceType.ObjectStore; /// Encrypts a bucket. /// The bucket. Must be valid for storage. /// The vault key, which the data key is wrapped under. /// The item id, which the AAD binds. /// The vault's current key generation. /// The version this payload will hold once the server accepts it. public static EncryptedPayload Seal( ObjectStoreSecret store, ReadOnlySpan vaultKey, Guid entityId, uint keyGeneration, int itemVersion) { ArgumentNullException.ThrowIfNull(store); ArgumentOutOfRangeException.ThrowIfLessThan(itemVersion, 1); var plaintext = ObjectStoreSecretCodec.Encode(store); var dataKey = ItemKeys.CreateDataKey(); try { var dataKeyId = Guid.CreateVersion7(); var wrappedDataKey = ItemKeys.WrapDataKey( dataKey, vaultKey, Resource, entityId, keyGeneration, (uint)itemVersion); var envelope = ItemKeys.SealPayload( dataKey, plaintext, Resource, entityId, dataKeyId, keyGeneration, (uint)itemVersion); return new EncryptedPayload( envelope, wrappedDataKey, dataKeyId, keyGeneration, CryptoSpec.CurrentAadVersion); } finally { CryptographicOperations.ZeroMemory(dataKey); // The same reason a credential's buffer is wiped: this one holds a secret access key, which is a // password by another name and is live on the service it belongs to. CryptographicOperations.ZeroMemory(plaintext); } } /// Decrypts a bucket. /// public static ObjectStoreSecretDocument? TryOpen( EncryptedPayload payload, ReadOnlySpan vaultKey, Guid entityId, int itemVersion) { ArgumentNullException.ThrowIfNull(payload); if (itemVersion < 1 || payload.WrappedDataKey.Length == 0) { return null; } var dataKey = ItemKeys.TryUnwrapDataKey( vaultKey, payload.WrappedDataKey, Resource, entityId, payload.KeyGeneration, (uint)itemVersion); if (dataKey is null) { return null; } try { var plaintext = ItemKeys.TryOpenPayload( dataKey, payload.Envelope, Resource, entityId, payload.DataKeyId, payload.KeyGeneration, (uint)itemVersion); if (plaintext is null) { return null; } try { return ObjectStoreSecretCodec.TryDecode(plaintext, out var document) ? document : null; } finally { CryptographicOperations.ZeroMemory(plaintext); } } finally { CryptographicOperations.ZeroMemory(dataKey); } } }