Privacy-first password manager with built-in email aliasing. Fully encrypted and self-hostable.
//-----------------------------------------------------------------------
// <copyright file="VaultManifestBase.cs" company="aliasvault">
// Copyright (c) aliasvault. All rights reserved.
// Licensed under the AGPLv3 license. See LICENSE.md file in the project root for full license information.
// </copyright>
//-----------------------------------------------------------------------
namespace AliasServerDb;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;
/// <summary>
/// Shared revision payload columns for a vault manifest. <see cref="VaultManifest"/> holds the current revision of
/// each logical manifest (one row per manifest); <see cref="VaultManifestsHistory"/> holds superseded revisions.
/// <para>
/// The columns the manifest-v1 format no longer uses are nullable so null reads as "not applicable to this revision":
/// a revision with a null <see cref="VaultBlob"/>/<see cref="Version"/> is manifest-v1, and null SRP columns mean the
/// login credentials moved to the unlock-method model. Only legacy sqlite-blob revisions carry values there.
/// </para>
/// </summary>
public abstract class VaultManifestBase : IVaultRevision
{
/// <summary>
/// The legacy storage format, where the whole vault is one blob encrypted with the password-derived key.
/// </summary>
public const string LegacyStorageFormat = "sqlite-blob";
/// <summary>
/// The current storage format, where the vault is an encrypted manifest plus data buckets.
/// </summary>
public const string ManifestStorageFormat = "manifest-v1";
/// <summary>
/// Gets or sets the encrypted vault blob. Only the legacy sqlite-blob format populates this; on manifest-v1
/// revisions it is null. TODO: remove this column once the legacy model is fully deprecated.
/// </summary>
public string? VaultBlob { get; set; }
/// <summary>
/// Gets or sets the storage format identifier: "sqlite-blob" (legacy v1) or "manifest-v1" (v2).
/// </summary>
[StringLength(20)]
public required string StorageFormat { get; set; }
/// <summary>
/// Gets or sets the encrypted manifest blob (raw AES-GCM ciphertext bytes).
/// </summary>
public byte[]? ManifestBlob { get; set; }
/// <summary>
/// Gets or sets the SHA-256 (hex) of the encrypted manifest ciphertext. Stored for storage-layer integrity
/// verification (the client sends this on upload and we return it on download; client verifies before decrypt).
/// </summary>
[StringLength(64)]
public string? ManifestCiphertextHash { get; set; }
/// <summary>
/// Gets or sets the vault data model version. Only the legacy sqlite-blob format populates this; on manifest-v1
/// revisions it is null as the version is carried inside the manifest itself instead. Kept so not-yet-migrated
/// users' manifests retain their historic value. TODO: remove this column once the legacy model is fully deprecated.
/// </summary>
[StringLength(255)]
public string? Version { get; set; }
/// <summary>
/// Gets or sets the version of the manifest's VEK that <see cref="ManifestBlob"/> is encrypted with.
/// </summary>
public int KeyVersion { get; set; }
/// <summary>
/// Gets or sets the revision number of the vault manifest. This number is incremented with each change.
/// </summary>
[Required]
public required long RevisionNumber { get; set; }
/// <summary>
/// Gets or sets the vault filesize in kilobytes.
/// </summary>
public int FileSize { get; set; }
/// <summary>
/// Gets or sets the salt used for SRP authentication. On the legacy model the login
/// credentials are stored with the vault manifest because the manifest is encrypted with the key derived from
/// the user's password, keeping login and vault password in sync across backup restores. Once a user has a VaultManifestAccessKey
/// the SRP credentials live there instead and this column is null on current revisions (history revisions keep
/// their at-the-time values). TODO: remove this column once the legacy model is fully deprecated.
/// </summary>
[StringLength(100)]
public string? Salt { get; set; }
/// <summary>
/// Gets or sets the verifier used for SRP authentication. See the remarks on
/// <see cref="Salt"/> for how this relates to the VaultManifestAccessKey model. TODO: remove this column once the legacy model is fully deprecated.
/// </summary>
[StringLength(1000)]
public string? Verifier { get; set; }
/// <summary>
/// Gets or sets the number of credentials stored in the vault. This anonymous data is used in case a vault back-up
/// needs to be restored to get a better idea of the vault size.
/// </summary>
public int CredentialsCount { get; set; }
/// <summary>
/// Gets or sets the number of email claims stored in the vault. This anonymous data is used in case a vault back-up
/// needs to be restored to get a better idea of the vault size.
/// </summary>
public int EmailClaimsCount { get; set; }
/// <summary>
/// Gets or sets the encryption type. See remarks on <see cref="Salt"/> for how this relates to the VaultManifestAccessKey model.
/// TODO: remove this column once the legacy model is fully deprecated.
/// </summary>
public string? EncryptionType { get; set; }
/// <summary>
/// Gets or sets the encryption settings. See remarks on <see cref="Salt"/> for how this relates to the VaultManifestAccessKey model.
/// TODO: remove this column once the legacy model is fully deprecated.
/// </summary>
public string? EncryptionSettings { get; set; }
/// <summary>
/// Gets or sets the client that created the vault.
/// </summary>
[StringLength(255)]
public string? Client { get; set; }
/// <summary>
/// Gets or sets the user whose push wrote this revision. Null for legacy revisions.
/// </summary>
[StringLength(255)]
public string? UpdatedByUserId { get; set; }
/// <summary>
/// Gets or sets the navigation property to the user whose push wrote this revision.
/// </summary>
[ForeignKey("UpdatedByUserId")]
public virtual AliasVaultUser? UpdatedByUser { get; set; }
/// <summary>
/// Gets or sets the timestamp at which this revision was created.
/// </summary>
public DateTime CreatedAt { get; set; }
/// <summary>
/// Gets or sets the timestamp at which this revision was last updated.
/// </summary>
public DateTime UpdatedAt { get; set; }
/// <summary>
/// Gets a value indicating whether this revision holds vault content. A manifest that was reserved but never
/// written (at registration, or when a shared manifest is created) holds none: it is not a revision anyone
/// ever pulled and can never be restored, so it is not archived into history when it is written over.
/// </summary>
[NotMapped]
public bool HasContent => ManifestBlob is not null || !string.IsNullOrEmpty(VaultBlob);
/// <summary>
/// Copies all shared revision payload columns from another manifest revision onto this instance.
/// </summary>
/// <param name="source">The revision to copy the payload from.</param>
public void CopyPayloadFrom(VaultManifestBase source)
{
VaultBlob = source.VaultBlob;
StorageFormat = source.StorageFormat;
ManifestBlob = source.ManifestBlob;
ManifestCiphertextHash = source.ManifestCiphertextHash;
KeyVersion = source.KeyVersion;
Version = source.Version;
RevisionNumber = source.RevisionNumber;
FileSize = source.FileSize;
Salt = source.Salt;
Verifier = source.Verifier;
CredentialsCount = source.CredentialsCount;
EmailClaimsCount = source.EmailClaimsCount;
EncryptionType = source.EncryptionType;
EncryptionSettings = source.EncryptionSettings;
Client = source.Client;
UpdatedByUserId = source.UpdatedByUserId;
CreatedAt = source.CreatedAt;
UpdatedAt = source.UpdatedAt;
}
}