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);
}
}
}